跳转至

模板组合设计规范

用户意图

页面模板或可复用块应呈现为有意的产品表面,而不仅仅是合法的组件集合。它应建立清晰的阅读顺序、连贯的区域和主题安全的强调,同时将产品内容和应用外壳留给采用它的产品。

设计原则

  • 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