一、先定义状态,再定义皮肤
默认、悬停、聚焦、禁用、加载、错误、空数据与只读状态,应在基础组件中成套出现。只画正常态会让业务页面在异常时重新发明规则。
颜色、圆角和阴影是令牌层;按钮或输入框是组件层;页面布局是组合层。三层分开,品牌调整才不会逐页修改。
- 状态成套出现,悬停、按下、禁用与加载在同一次改动里一起定义
- 视觉令牌与组件实现分开,主题调整不需要改动组件代码
- 页面不硬编码颜色,所有取色都来自统一的一组变量
- 间距来自同一套刻度,页面上不会出现说不清来源的零散数值
二、为不可组合的情况写规则
什么情况下不能把两个组件嵌套、什么字段必须由上层提供、什么文案不可省略,这些限制比新增变体更重要。
组件文档应同时给出可使用与不可使用的例子,并附最小代码,让团队知道何时停止扩展。
- 组合限制直接写进文档,使用者不必靠试错才发现不能这么用
- 不可用的示例同样给出说明,让人知道为什么以及换哪个组件
- 需要新增能力时先在现有模式里找,而不是立刻引入新的写法
- 每次例外都有记录,便于日后判断哪些例外其实应该被收进系统
三、记录什么时候不要用它
设计系统的价值在于统一,但统一不是目的。有些场景确实需要例外:高度定制的活动页、必须遵循外部规范的嵌入区域。把这些例外写成明确规则,比让每个人自行判断更可控。
边界说明通常比组件文档更重要,因为它决定了系统在什么时候应该被绕开。
- 明确列出不适合使用设计系统的场景,避免生搬硬套
- 绕开设计系统时需要写明理由,让例外保持可追溯
- 组件的行为在各种场景下保持一致,使用者可以放心预期结果
- 升级成本可以提前估算,团队才知道何时值得迁移