principle / State completeness
State completeness
每个可交互组件必须明确记录 Default、Hover、Active、Focus、Disabled、Invalid 等适用状态。
Key fields
What
- Definition
- 每个可交互组件必须明确记录 Default、Hover、Active、Focus、Disabled、Invalid 等适用状态。
Why
- Core Question
- 用户如何知道组件当前能否操作、发生了什么以及下一步是什么?
- Mechanism
- L4 Token 和 Component Slot 共同形成状态矩阵;状态缺失可以通过视图直接发现。
How
- Primary Use
- 让状态成为显式设计对象,避免只靠颜色或临时 CSS 表达状态。
- Design Guidance
- 状态记录使用受控选项,L4 Token 必须绑定组件、变体和状态。
Evidence
- Limitations
- 状态矩阵会增加记录数量,需要用组件视图和覆盖率视图管理。
- Last Verified At
- 2026-08-21
- Common Mistakes
- 把 Hover、Focus 和 Active 当成同一个状态。
Lifecycle
- Status
- 在用
Related content
Relationships come from the local knowledge graph and include reverse links.