设计技能
@lark-ui/core

安装

npx skills add cloudflare/lark@lark-design

规则

正文文字使用 14px

所有正文文字——正文、按钮、数据以及其他可交互元素——字号都必须为 14px。16px 及以上仅限用于标题和副标题。
推荐示例

API 令牌

生产令牌将在 30 天后过期。

需要避免的示例

API 令牌

生产令牌将在 30 天后过期。

标题始终使用句首大写(sentence case)

标题不要首字母大写,也不要全大写。产品名称则应使用标题式大写(title case)。
推荐示例
Recent requests
需要避免的示例
Recent Requests
需要避免的示例
Recent Requests

不要改变字体的字间距

不要使用 tracking-* 类来改变字符之间的间距。
推荐示例
Worker 指标
需要避免的示例
Worker 指标

不要使用 font-bold

标题使用 font-semibold,加粗的行内文字使用 font-medium。
推荐示例

账户设置

此操作是 必需。

需要避免的示例

账户设置

此操作是 必需。

让文字周围的间距在视觉上对齐

文字周围的间距应考虑其行高。通常这意味着垂直间距应略小于水平间距。
推荐示例

生产环境

需要避免的示例

生产环境

悬停状态不要使用颜色过渡

悬停时的颜色变化必须是即时的。快速交互中的过渡动画会让界面显得迟缓。
推荐示例
需要避免的示例

不要同时使用边框和投影

使用 ring ring-lark-line 打造透明边框,同时保持边缘锐利。
推荐示例

Workers API

4 分钟前完成部署

需要避免的示例

Workers API

4 分钟前完成部署

使用同心圆角

当边框或描边(ring)相距不超过 8px 时,它们的圆角必须在数学上同心:外圆角 = 内圆角 + 内边距。
推荐示例
需要避免的示例

让图标与文字首行对齐

行内图标必须在视觉上与文字等大,并与文字垂直居中。多行对齐请使用 h-lh flex items-center。
推荐示例

API 令牌的权限在创建后无法更改。

需要避免的示例

API 令牌的权限在创建后无法更改。

需要避免的示例

API 令牌的权限在创建后无法更改。

缩小行内等宽文字的字号

等宽文字与常规文字混排时,字号应略小一些(约 0.9em)。
推荐示例

编辑 cloudflare.config.ts 后继续。

需要避免的示例

编辑 cloudflare.config.ts 后继续。

使用 border 将粘性元素与内容分隔开

推荐示例

API 令牌

生产令牌

预览令牌

预发布令牌

开发令牌

测试令牌

生产令牌

预览令牌

预发布令牌

开发令牌

测试令牌

需要避免的示例

API 令牌

生产令牌

预览令牌

预发布令牌

开发令牌

测试令牌

生产令牌

预览令牌

预发布令牌

开发令牌

测试令牌

折叠动画期间保持内容尺寸

折叠面板(Collapsible)在收起过程中必须保持内容尺寸,避免内容在动画期间发生位移。
推荐示例

Web Analytics

无需改动代码即可衡量流量。

需要避免的示例

Web Analytics

无需改动代码即可衡量流量。

不要让分层卡片(LayerCard)相互堆叠嵌套

推荐示例

最近的请求

时间

状态

查询

00:50 UTC

错误

lark

需要避免的示例

最近的请求

时间

状态

查询

00:50 UTC

错误

lark

不要按条件渲染对话框

按条件渲染对话框(Dialog)会让它的开关动画失效。请使用 open 属性来决定对话框是否可见。
推荐示例
<Dialog.Root open={open} onOpenChange={setOpen}>
  <Dialog>
    <Dialog.Title>编辑 Worker</Dialog.Title>
    <Dialog.Description>更新此 Worker 的设置。</Dialog.Description>
  </Dialog>
</Dialog.Root>
需要避免的示例
{open && (
  <Dialog.Root open>
    <Dialog>
      <Dialog.Title>编辑 Worker</Dialog.Title>
    </Dialog>
  </Dialog.Root>
)}