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
在用