用途:这是一份设计系统模式参考,面向需要搭建或扩展设计系统的团队,覆盖 Token 架构、组件设计、命名、主题化与规模化。
主要能力:
- 三层 Token 体系:全局 Token 存原始值(如 --color-blue-500: #3B82F6),不直接使用;语义 Token 表达含义(如 --color-text-primary、--color-interactive-primary-hover);组件 Token 限定到具体组件(如 --button-bg、--button-radius)。
- 间距与字号比例:间距以 4px 为基准,提供 0 到 128 的刻度;字号使用一致比例,紧凑界面用 1.25,宽松布局用 1.333。
- 组件设计原则:API 应直观,用枚举而非布尔(variant="primary" 而非 isPrimary={true}),优先组合而非配置,默认覆盖最常见用例。
- 状态覆盖:交互组件需处理默认、悬停、激活、键盘聚焦、禁用,以及加载、错误、空状态。
- 命名约定:[Component][Variant][Size][State],如 ButtonPrimaryLgDisabled、InputError、CardInteractive。
- 组合模式:插槽模式(header/body/footer)、复合模式(Tabs + TabPanel)、渲染属性。
- 主题化:深色模式不是简单反色,需调整背景、文字、层级、阴影、饱和度与边框;多品牌时所有品牌决策放在 Token 层,组件只引用语义 Token,切换品牌即替换 Token 文件,禁止在组件代码中硬编码品牌值。
使用方式:资料未提供具体安装命令或调用步骤,仅给出 Token 定义与设计原则示例,可据此在项目中建立 Token 文件与组件规范。
适用场景:需要统一视觉语言、支持多品牌或深色模式、并希望设计系统被实际采用的前端与设计团队。
限制:资料未说明收费、平台、效果或完整使用流程,相关事实暂未提供。