SuperAPI AI 工具集

design-tokens

设计与创作

查看项目

更新于 10-15 23:49

技能介绍

用途:该技能面向设计系统实现,帮助搭建设计令牌(design tokens)体系、组织 CSS 自定义属性,并实现主题系统。资料说明,当需要建立令牌系统、实现明暗主题切换、组织 CSS 变量、将令牌集成到 Tailwind 等框架时使用;若只是编写单个组件样式、做无障碍审计、处理 CSS 布局或响应式设计、使用框架特定组件模式,则应改用其他技能。

主要能力:涵盖令牌架构(可扩展地组织设计令牌)、CSS 自定义属性(变量模式与继承)、主题系统(明暗模式与用户偏好)、组件集成(一致地应用令牌)。

令牌结构:采用三层架构——原始令牌(raw values,如颜色、间距、字号)、语义令牌(按用途,如 --color-primary、--color-background)、组件令牌(具体使用,如按钮的 padding、背景、文字色)。令牌类别包括颜色、排版、间距、边框、阴影、过渡、z-index。

主题实现:默认浅色主题定义在 :root,深色主题通过 [data-theme="dark"] 覆盖,并用 @media (prefers-color-scheme: dark) 配合 :root:not([data-theme="light"]) 响应系统偏好。

文件组织:建议 styles/ 下分 tokens/(primitives.css、semantic.css、index.css)、themes/(light.css、dark.css)、base/(reset.css、typography.css)、components/(button.css、card.css)。

组件集成:组件可定义局部令牌(如 --card-padding、--card-radius),并通过覆盖令牌实现变体(如 .card--elevated 改阴影)。

辅助命令:可用 grep 查找 CSS 变量、检查令牌使用、查找硬编码颜色,用 find 列出令牌文件,用 npx stylelint 'styles/**/*.css' 校验语法。

限制:资料未提供安装命令、收费方式、平台支持或效果数据;具体实现细节可参考 REFERENCE.md 及 MDN、Design Tokens Format、Style Dictionary、Tailwind 文档。