设计规范¶
设计规范记录由人负责的视觉和交互意图:层级、 结构、状态表示、允许的变化以及代表性示例。 它们可以描述一个组件或跨组件的模式。
状态分类¶
状态记录按变更的驱动者进行划分。以下是仅有的三个状态分类记录:
| 记录 | 拥有 |
|---|---|
| 用户状态 | 由人驱动的静止、悬停、按压、聚焦、选择及操作状态 |
| 系统状态 | 由系统驱动的禁用、加载、处理、状态及瞬时反馈状态 |
| 智能体状态 | 由智能体驱动的思考、流式传输、工具执行、等待、同步、检查和渲染状态 |
其他记录¶
| 记录 | 拥有 |
|---|---|
| 空间层级 | 通过邻近性、间距层级和对齐实现感知分组 |
| 控件节奏 | 混合控件之间的对齐和密度关系 |
| 形状关系 | 嵌套表面的基于角色和同心几何 |
| 高程层级 | 感知深度与实际图层顺序之间的一致性 |
| 字体排版层级 | 跨主题和布局的可读、可区分的文本角色 |
| 图标设计 | 图标的含义、大小、图形、颜色、构图和无障碍性 |
| 颜色强调 | 语义颜色角色、对比意图和局部强调 |
| 动效 | 有意义的运动、时间层级和缓动意图 |
| 减少动效 | 在减少动效下,触摸时交叉淡入淡出,否则立即变化 |
| 有序集合重排 | 有序集合的拖拽预览、候选插入、提交和落位意图 |
| 模板组合 | 页面和块级布局、层级、间距、组件保真度和主题 |
当一个主题具有不同的所有者、审批生命周期、需求集、证据集或独立变更的理由时,请单独创建一条记录。将实现机制、公共 API 语法、审计结果和消费者用法保留在这些记录之外,并改为链接到其权威所有者。
设计规范不拥有实现机制、公共 prop 语法、当前审计结果或消费者使用指南。组件和家族契约链接到稳定的设计需求 ID,而不是复制其理由。
可公开的安全规范截图、图表和视觉状态引用位于 docs/design/assets/<design-id>/ 下。每个被引用的资源都记录其替代文本、状态、主题/模式、相关的视口以及它所展示的决策。生成的审计截图仍然是审计证据,而非设计权威。私有设计来源保持私有,绝不在此处命名或链接。
新设计规范以 draft 状态开始。首次提升为 current、后续更改以及规范资源更新,都需要获得 .github/ENGOWNERS 或 .github/DESIGNOWNERS 中任何现任成员对其内容的批准(architecture:knowledge-contracts DEC-14)。混合 PR 仍然需要一位 ENGOWNER 负责非设计的 current 记录。设计记录会在此仓库门禁之外单独注明其内容所有者。
DESIGNOWNER 通过审核或 /approve-spec <sha> 来批准,如同其他所有所有者一样;在混合 PR 中,所有其他适用的代码或规范所有者组仍然是必需的。该门禁仅决定批准;它从不启用自动合并。
使用 docs/templates/knowledge/design-spec.md。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx