设计原则 / Component contract stability
Component contract stability
L3 Component Token 表达组件稳定的槽位契约，而不是某个页面的临时样式。
关键字段
What · 是什么
- 定义
- L3 Component Token 表达组件稳定的槽位契约，而不是某个页面的临时样式。
Why · 为什么
- 核心问题
- 组件如何暴露足够稳定的视觉接口，同时允许内部主题变化？
- 作用机制
- Component Slot 明确组件部位；L3 Token 为每个部位提供稳定角色；L4 只处理变体与状态差异。
How · 怎么做
- 主要用途
- 把组件 Anatomy、属性和 Token 绑定关系固定下来，减少页面级覆盖。
- 设计指导
- 为 Container、Label、Icon、Border、Content、Action 等槽位建立契约。
Evidence · 证据
- 局限与边界
- 复杂组件可能有多个 slot 数据库记录；必须避免把页面结构塞进基础组件。
- 最后验证时间
- 2026-08-21
- 常见错误
- 把一次性布局间距误建成公共组件 Token。
Lifecycle · 生命周期
- 状态
- 在用
相关要素与机制
关系来自本地关系表，并包含反向关联。