设计令牌(Design Tokens)
设计令牌是颜色、字号、间距、圆角、阴影等视觉属性的单一事实来源,一处修改、全局生效,并可直接同步给开发。
什么是设计令牌
设计令牌是构成界面元素的最小视觉单元,以设计与开发都能使用的格式表达,例如 color.primary.500、space.4、radius.md。希爱设计原生支持设计令牌,无需任何插件。令牌集中定义后,可以应用到填充、描边、文字、间距、圆角、阴影等属性上。
支持的令牌类型
- 颜色令牌:填充、描边、阴影颜色
- 字号令牌与行高令牌:统一排版阶梯
- 间距令牌:外边距、内边距与布局 Gap
- 圆角令牌:统一组件的圆角尺度
- 尺寸令牌:宽高、描边粗细等
- 透明度与布尔值令牌:控制状态开关
推荐的两层结构
- 先建基础层(Primitive):如 purple.500、gray.200 这样的原始色板
- 再建语义层(Semantic):如 color.primary、color.text.muted 引用基础令牌
- 组件只使用语义令牌,不直接引用具体色值
- 做深色模式时只替换语义层的映射,组件无需逐个修改
- 通过共享库把令牌集发布给所有文件与团队
与开发协同
检查面板会把使用了令牌的属性输出为令牌名称而非硬编码数值,令牌还可按标准格式导出为 JSON,供前端的样式体系、主题配置或构建流水线直接消费。这让「设计改一个颜色,全站同步更新」成为现实。
实用提示
- 令牌命名与研发约定好一套规则(如 category.role.state),交接成本最低。
- 深色模式不要新建一套文件,用同一组件 + 不同主题的语义令牌即可。