视觉基础与 Token
Qokit 品牌颜色、字体、间距、圆角和语义 Token 的公开使用契约。
视觉基础与 Token
Qokit 的平台界面使用清透、专业、克制的蓝色体系。开发者应通过语义 Token 适配主题,不在业务组件中复制色值、阴影、圆角或字体。
核心角色
| 角色 | 推荐 Token | 用途 |
|---|---|---|
| 页面背景 | --bg、--page-background | 页面底色和整体空间 |
| 内容表面 | --panel、--card-surface | 面板、内容卡片 |
| 控件表面 | --control-surface、--control-surface-hover、--control-surface-active、--input-surface | 按钮、搜索、输入框及交互状态 |
| 浮层表面 | --dropdown-surface、--dialog-surface | 菜单、Popover、Dialog |
| 边界 | --panel-border、--control-border、--input-border | 分隔和状态边界 |
| 文字 | --text、--muted | 主要与次要信息 |
| 品牌交互 | --accent、--link-color、--link-hover-color | 链接、选中和轻量强调 |
| 键盘焦点 | --focus-ring | focus-visible 状态 |
| 圆角 | --card-radius、--button-radius、--button-pill-radius | Card 与控件形状 |
| 按钮字号 | --button-font-size-sm、--button-font-size-md、--button-font-size-lg | 共享按钮的尺寸级排版 |
| 字体 | --font-heading、--font-body | 标题与正文/控件 |
排版
- Space Grotesk 用于品牌标题、页面标题和关键数字;
- Manrope 用于正文、按钮、表单、表格和工作区;
- 工作区保持紧凑,不使用营销页尺度的大标题;
- 中文不增加英文式宽字距,长翻译不得挤压相邻操作。
间距与尺寸
- 使用 4px 节奏:8、12、16、20、24、32、48、64、96;
- 紧凑控件的点击高度不低于 40px;
- 默认操作高度为 44px,移动端主要操作不低于 44px;
- 共享按钮按
sm、md、lg分别使用 14px、15px、16px 文字,不继承所在容器的字号; - 平台内容宽度通常不超过 1160px,生成站点内容通常不超过 1120px。
主题规则
- 浅色和深色主题必须复用相同的语义 Token;
- 普通 Dialog 使用
--dialog-surface提供轻微纵向渐变,圆角与 Card 共用--card-radius; --accent用于链接、焦点、选中和进度,不用于大面积铺底;- 普通未选中控件 hover 使用中性
--control-surface-hover;按下、选中、当前和展开使用品牌浅底--control-surface-active。focus-visible保留中性表面并叠加--focus-ring;输入框 focus/active 继续使用输入状态 Token; - 状态颜色只表达成功、警告和危险;
- 生成站点可以覆盖主题变量,但必须保持正文对比度和明确的 CTA 层级。