Skip to Content
设计

视觉基础与 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-ringfocus-visible 状态
圆角--card-radius、--button-radius、--button-pill-radiusCard 与控件形状
按钮字号--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 层级。

本页目录