Design skill
@cloudflare/kumo

安装

npx skills add cloudflare/kumo@kumo-design

规则

正文文本使用 14px

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

API 令牌

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

应避免的示例

API 令牌

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

标题始终使用句子式大小写

切勿对标题全部使用大写字母。产品名称必须使用标题式大写。
推荐示例
最近请求
应避免的示例
最近请求
应避免的示例
最近请求

切勿更改字体的字距

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

切勿使用 font-bold

标题使用 font-semibold,粗体行内文本使用 font-medium
推荐示例

账户设置

此操作是 必需的

应避免的示例

账户设置

此操作是 必需的

围绕文本进行光学对齐排布

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

生产

应避免的示例

生产

切勿为悬停状态过渡颜色

悬停时的颜色变化必须立即完成。对快速交互使用过渡会让界面显得迟钝。
推荐示例
应避免的示例

切勿将边框与投影一起使用

使用 ring ring-kumo-line 创建保持清晰边缘的透明边框。
推荐示例

Workers API

4 分钟前部署

应避免的示例

Workers API

4 分钟前部署

使用同心圆角

当边框或圆环彼此相隔 8px 或更近时,其圆角半径必须在数学上同心:外半径 = 内半径 + 内边距。
推荐示例
应避免的示例

将图标与文本首行对齐

行内图标在视觉上必须与文本尺寸相同并居中对齐。多行对齐请使用 h-lh flex items-center
推荐示例

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

应避免的示例

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

应避免的示例

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

缩小行内等宽文本的字号

等宽文本与普通文本混合时,应使用略小的字号(约 0.9em)。
推荐示例

编辑 wrangler.toml 以继续。

应避免的示例

编辑 wrangler.toml 以继续。

使用 border 将吸顶元素与内容分隔开

推荐示例

API 令牌

生产令牌

预览令牌

预发布令牌

开发令牌

测试令牌

生产令牌

预览令牌

预发布令牌

开发令牌

测试令牌

应避免的示例

API 令牌

生产令牌

预览令牌

预发布令牌

开发令牌

测试令牌

生产令牌

预览令牌

预发布令牌

开发令牌

测试令牌

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

可折叠内容在关闭时必须保持其内容尺寸,以避免内容在动画期间发生位移。
推荐示例

Web Analytics

Measure traffic without changing your code.

应避免的示例

Web Analytics

Measure traffic without changing your code.

切勿将 LayerCard 相互层叠

推荐示例

最近请求

时间

状态

查询

00:50 UTC

错误

kumo

应避免的示例

最近请求

时间

状态

查询

00:50 UTC

错误

kumo

切勿按条件渲染 Dialog

按条件渲染对话框会禁用其打开/关闭动画。请使用 open 属性来判断对话框是否可见。
推荐示例
<Dialog.Root open={open} onOpenChange={setOpen}>
  <Dialog>
    <Dialog.Title>Edit Worker</Dialog.Title>
    <Dialog.Description>Update this Worker's settings.</Dialog.Description>
  </Dialog>
</Dialog.Root>
应避免的示例
{open && (
  <Dialog.Root open>
    <Dialog>
      <Dialog.Title>Edit Worker</Dialog.Title>
    </Dialog>
  </Dialog.Root>
)}