设计原则 / Semantic indirection
Semantic indirection
组件不直接消费基础值，而是消费表达设计意图的 Semantic Token。
关键字段
What · 是什么
- 定义
- 组件不直接消费基础值，而是消费表达设计意图的 Semantic Token。
Why · 为什么
- 核心问题
- 当视觉主题或品牌变化时，如何只改变映射而不重写组件？
- 作用机制
- L2 作为别名层承接主题变化；同一个组件角色可以在不同主题下映射到不同的 L1 值。
How · 怎么做
- 主要用途
- 把“值”和“意义”分离，使组件契约对视觉风格保持稳定。
- 设计指导
- 组件和页面优先引用 L2；L2 使用稳定的意图命名，例如 text.primary、surface.raised、action.primary。
Evidence · 证据
- 局限与边界
- 语义角色过多会造成命名漂移；需要定期合并同义角色。
- 最后验证时间
- 2026-08-21
- 常见错误
- 用 muted、gray、blue 等视觉描述代替 primary、disabled、focus 等语义。
Lifecycle · 生命周期
- 状态
- 在用
相关要素与机制
关系来自本地关系表，并包含反向关联。