模板组合设计规范¶
用户意图¶
页面模板或可复用块应呈现为有意的产品表面,而不仅仅是合法的组件集合。它应建立清晰的阅读顺序、连贯的区域和主题安全的强调,同时将产品内容和应用外壳留给采用它的产品。
设计原则¶
- DR1 — 布局传达意图。 结构区域、网格和堆叠 MUST 使页面的主要任务在阅读单个内容之前就清晰可见。
- DR2 — 视觉层次引导视线。 大小、粗细和位置 MUST 建立一条从页面上下文到主要内容与操作的明确路径。
- DR3 — 间距与对齐表达关系。 重复的边缘、间距和分组层级 MUST 在整个组合中保持一致。
- DR4 — 组件保留其可供性。 模板 MUST 选择视觉语言与预期操作、导航、数据或状态角色相匹配的组件和变体。
- DR5 — 颜色与主题保留层次。 表面与强调色选择 MUST 在每种受支持的主题和颜色模式下保持其含义和重点。
结构与层次¶
| 角色 | 目的 | 必需的关系 |
|---|---|---|
| 页面上下文 | 确立用户所处位置以及该表面的用途 | 主导视觉层次而不与主要任务竞争 |
| 结构区域 | 对导航、控件、内容或支持性信息进行分组 | 使用与其角色匹配的布局边界和间距 |
| 主要内容 | 承载页面的主要任务或信息 | 获得最强的持续层次 |
| 主要操作 | 提供最重要的本地下一步 | 在其操作组中保持单一且易于识别 |
| 支持性内容 | 补充说明、元数据或次要操作 | 保持可用而不压平层次 |
| 重复项 | 构成列表、网格、表格或卡片集合 | 在现实内容变化中保持对齐和节奏 |
状态表示¶
| 状态 | 必需的表示 | 允许的变化 |
|---|---|---|
| 已填充 | 区域和层次在现实内容下保持清晰 | 内容长度和集合大小可在模板目的范围内变化 |
| 稀疏 | 空白空间保留有意的分组而非结构塌陷 | 可选的支持性区域可以消失 |
| 受限 | 区域重排而不丢失阅读顺序或主要操作 | 导航和次要内容可根据组件族契约移动或折叠 |
| 浅色或深色模式 | 表面层次、对比度和强调含义保持完整 | 主题控制调色板和视觉个性 |
| 交互 | 组件状态在更大的组合中保持可识别 | 组件保留其所属组件族的处理方式 |
响应式与输入行为¶
- DR6 — 重排保留阅读顺序。 响应式变化 MUST 保留页面上下文、主要内容、支持性区域和操作之间的关系。
- DR7 — 集合自适应而不随意裁剪。 重复内容 MUST 使用一种在受支持的宽度和现实条目长度下保持一致的布局策略。
- DR8 — 输入模式保持相同的任务层次。 键盘、指针和触控路径 MUST 到达相同的主要任务和操作,且不依赖仅悬停的发现方式。
无障碍意图¶
视觉层次应与语义阅读和焦点顺序一致。重排不得将标签、说明、错误或操作与其所服务的内容分离。主题变化必须保持可读性和状态含义,现实内容不得暴露不可访问的溢出或截断。
语义标记、组件 API、焦点管理和响应式实现属于组件、布局族和消费方指南。
代表性示例¶
- 密集的数据页面在扫视时仍应呈现一个清晰的标题、控件区域、主要数据区域和操作层次。
- 卡片集合在现实标题、元数据和缺失的可选内容下保持对齐和分组。
- 窄布局移动支持性区域而不改变阅读顺序或隐藏主要操作。
视觉参考¶
本初始草案不包含规范性资产。代表性整页和块示例应在正式发布之前添加到 docs/design/assets/template-composition/ 下的浅色、深色、宽屏和受限状态中。
组件契约链接¶
未断言任何组件契约链接。所列出的布局族关系是待审查的候选;消费方模板仍负责使用这些布局族公开的公共契约。
决策日志¶
仓库设计决策尚未批准此记录。本草案仅迁移了公开的 Design Conventions wiki 中的人工视觉质量维度;它有意排除了编写机制和审计评分。
开放问题¶
- OQ1 — 代表性模板。 哪些页面模板和块应作为每项组合要求的规范性示例?
- OQ2 — 产品外壳边界。 哪些结构区域属于可复用页面模板,哪些属于宿主应用?
- OQ3 — 证据。 截图审查应如何展示层次和组合,而不将主观判断变成误导性的评分?
内容边界¶
此文件定义模板组合的人类视觉意图。它不定义必需的 React 组件、原始 HTML 策略、图标管线、样式机制、模拟数据源、文档元数据、行数目标、审计等级或使用者说明。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx