图标设计规范¶
用户意图¶
图标是表示常见操作、概念和状态的简单图形界面元素。它们应帮助人们理解界面、完成任务并找到方向,同时不增加视觉噪声,也不强迫用户去解读不一致的符号。
设计原则¶
- DR1 — 清晰。 图标 MUST 使用简单、可识别的形式,以传达其预期含义并帮助理解。
- DR2 — 有目的。 每个图标 MUST 在其局部上下文中发挥明确作用。设计者应在添加另一个图标之前评估整个容器和页面,以免装饰增加认知负荷。
- DR3 — 一致。 重复出现的概念、操作、几何形状、尺寸角色和图形风格应在整个产品中保持一致。组件应复用系统语义图标,而不是为已有含义引入定制符号。
- DR4 — 尺寸跟随语义角色。 字形 MUST 根据其功能确定尺寸,而不仅仅是根据最近可用空间或图形本身的固有比例。
- DR5 — 线框图形为默认。 当一套图标同时提供同一符号的线框和填充版本时,组件应默认使用线框版本,除非有允许的填充使用场景。
- DR6 — 颜色辅助含义。 图标颜色 MUST 遵循已批准的前景、语义或受限的非语义角色。仅靠颜色 MUST NOT 传达概念或状态。
- DR7 — 图形与点击目标分离。 图标图形 MUST NOT 用作交互容器、可操作点击目标、焦点样式或无障碍名称的替代品。
结构与层级¶
语义角色¶
| 角色 | 用途 | 必需关系 |
|---|---|---|
| 信息性图标 | 在相邻标签之外补充信息或含义 | 只有在具备无障碍名称以及足够解释以理解其含义时,才可以单独使用 |
| 装饰性图标 | 在不增加独立含义的前提下强化附近文本 | MUST 伴随已经传达该含义的内容;通常使用线框图形 |
| 交互性图标 | 表示交互控件内的一个操作 | 包含该图标的 Button、IconButton、链接或其他控件拥有交互、状态、焦点、名称和目标 |
| 语义性图标 | 强化信息、成功、警告或错误等含义 | 配套使用匹配的语义图标和颜色;即使脱离颜色,含义仍然可用 |
| 对象或 Logo 图标 | 标识特定对象、产品或品牌 | 仅在与该对象的识别相关时使用;不作为某个类别或版块的通用装饰 |
尺寸角色¶
Astryx 提供四种 Icon 尺寸。这些值在 16px 根字号下为 px 等效值;Icon 会随文档根字体大小继续缩放。
| 角色 | 当前 Icon 尺寸 | 用途及当前关系 |
|---|---|---|
| 紧凑型指示符 | 12px(xsm) |
辅助指示符、元数据和高密度操作提示 |
| 标准控件 | 16px(sm) |
大多数控件和展开提示;当前 Button sm 和 md 的图标框 |
| 重要控件 | 20px(md) |
大型控件和视觉上重要的纯图标操作;当前 Button lg 的图标框 |
| 展示或对象 | 24px(lg) |
大型独立符号、对象标识或特殊的展示级尺寸处理 |
这些角色描述的是视觉意图,而非新的公开 Icon 尺寸名称。组件契约决定各自的角色分配。独立 Icon 目前默认使用 md(20px),而许多组合控件会明确将其图标槽限制为 16px 或 20px。一项进行中的上下文尺寸调整变更可能使未指定尺寸的 Icon 从其所属控件继承尺寸;本文档不依赖该变更是否落地。
线框与填充图形¶
线框图形是起点。当以下一个或多个条件适用时,可以(MAY)使用填充图形:
- 该图标还传达激活或开启状态,例如开关或选中的导航项。
- 该图标为 12px 等效或更小,且填充能明显提升识别度。
- 信息性图标带有持续性的语义颜色,例如信息、成功、警告或错误状态。
- 该图标有意需要更高的强调度,例如主要操作或对象标识。
- 该图标出现在媒体或其他视觉上杂乱的背景上,且填充能改善对比度或识别度。
- 该图标的规范图形本身即为填充的 Logo 或品牌标志。
符号的形状或次要前景色本身并不足以要求使用填充。Astryx 当前的后备 V 形箭头、关闭标记、搜索图标和排序箭头在所有尺寸下均为线框,而状态图标为填充,诸如 more 和 stop 等本质上为实心的标记仍保持实心。同级控件应使用一致的图形语言,但一致性不会覆盖它们的语义角色。
填充例外 MUST 保持有目的且局部化。它不会让填充图形成为全局默认。没有有意义的线框对应形态、本质上为实心的基本图形,不会仅仅因为包含实心形状就被视为填充变体。
状态呈现¶
| 状态或上下文 | 必需呈现 | 允许的变化 |
|---|---|---|
| rest(静止) | 使用该角色正常的尺寸、颜色和描边图形,除非适用填充型例外 | 主题图形和光学调整可以有所变化 |
| active or on(激活或开启) | 可在保留一个可识别符号的前提下,从描边变为填充 | 其他已确立的非填充状态处理方式可强化该状态 |
| compact indicator(紧凑指示器) | 保持从属地位且可识别;在 12px 或更小时,若有助于识别则允许填充 | 按尺寸特化的图形可改善可读性 |
| semantic status(语义状态) | 将状态图标与其对应的语义颜色和无障碍含义配对 | 填充图形可提供持续的强调 |
| disabled(禁用) | 使用已批准的禁用前景色,且不丧失可识别性 | 图形保持与角色一致 |
| on media or busy surface(位于媒体上或繁忙表面) | 在变化的内容上保持对比度和可识别性 | 可使用填充图形和继承的高对比度前景色 |
| alternate theme(替代主题) | 含义、角色层级和描边/填充意图保持可识别 | 图标库和具体图形可以不同;角色特定尺寸需要暴露的目标 |
从描边到填充的变化 MUST NOT 成为某个状态的唯一提示,因为该状态的区分必须保持可感知。程序化状态、无障碍命名、位置、颜色或其他已确立的处理方式必须继续提供这一区分。
颜色角色¶
Astryx Icon 目前提供 primary、secondary、tertiary、disabled、accent、success、warning、error 和 inherit,以及具名的调色板颜色。设计意图如下:
- Primary(主要) 承载普通的高强调图标内容。
- Secondary(次要)与 Tertiary(第三) 承载辅助性图标内容。它们当前的 token 映射可能重合,但语义角色仍然不同。
- Disabled(禁用) 传达不可用的图标内容,而不暗示状态。
- Accent(强调) 在所属组件赋予该含义时,传达选中强调或信息。
- Success(成功)、Warning(警告)与 Error(错误) 保留用于匹配的语义结果。
- Inherit(继承) 让所属控件或表面提供正确的前景色,包括媒体和其他繁忙表面。
- 具名的调色板颜色 不会从 Icon 获得语义含义。仅当所属组件或产品定义并一致应用非语义类别映射时,才可使用它们。
placeholder 和 onMedia 不是当前 Icon 的颜色值。组件可以通过继承或限定的主题目标创建这些视觉角色,但本设计记录不会发明新的 Icon API 值。
响应式与输入行为¶
- DR8 — 密度不消除含义。 密集布局 MAY 为辅助性指示器选择紧凑角色,但主要控件 MUST 仍然可被识别为控件。
- DR9 — 输入适配属于目标对象。 触控或粗指针模式 MAY 在不改变字形的情况下增大包含目标或间距,只要其语义角色不变。
- DR10 — 角色变化是显式的。 响应式组合 MUST NOT 仅为了让图标适配,就在紧凑、标准控件、突出控件和展示角色之间静默移动图标;组件或组件族契约必须确立这种变化。
- DR11 — 紧凑图形保持可识别性。 在等效 12px 或更小尺寸下,当描边资源失去清晰度时,主题 MAY 选择填充或经光学简化的图形。16px 图标不会仅仅因为尺寸小就变为填充;填充使用标准之一仍必须适用。符号的含义和周围布局必须保持不变。
组合指南¶
控件中的图标¶
- 交互式图标 MUST 放置在 IconButton、Button、链接或其他能够提供交互状态、焦点、无障碍名称和足够目标的控件中。
- 裸 Icon MUST NOT 在没有所属控件的情况下,通过附加点击处理程序(click handler)变为可交互。
选项卡中的图标¶
- 前导选项卡图标 MAY 用于标识目的地或强化可见标签。当装饰性图标只会增加干扰或宽度而无助于识别时,SHOULD 省略。
- 当标签和选项卡语义继续承载选中状态时,选中图标 MAY 变化以强化该状态。
- 状态图标、徽标和状态圆点应位于选项卡的尾端内容或状态位置,而不是替换选项卡标签。
Token 与徽标中的图标¶
- 信息性状态处理将语义图标与颜色配对,使组合能够传达状态,而不会随意更改容器的颜色。
- Token 或徽标 MAY 通过组件自有的语义变体来协调其表面与图标;单独的嵌套图标不会重新定义容器的含义。
链接中的图标¶
- 链接 SHOULD 主要使用文本。当图标能提供有用的视觉提示时,MAY 补充该文本。
- 当目标在上下文中可识别,且 Link 获得非空的无障碍
label时,MAY 使用仅图标的链接。当交互应被视为控件而非行内导航时,优先使用带href的 Button。
列表中的图标¶
- 不可选择的描述列表和菜单列表应通常使用轮廓图标,尺寸为标准 16px 等效大小,并使用受支持的前景色角色。
- 当本记录中的其他规则适用时,可以使用填充图形、紧凑尺寸或命名调色板颜色;仅凭装饰本身不足以构成增加强调的理由。
标题中的图标¶
- 当标题标识特定对象且图标能实质性地帮助识别时,标题可以包含对象媒体。
- 大多数类别标题和章节标题不应包含图标;通用媒体只会增加噪音,无助于阐明章节。
导航中的图标¶
- 导航图标 MUST 经过有意选择:使用清晰、简单的符号表示目的地,而不是通用的装饰性标记。
- 当文本、
aria-current或其他既定处理方式仍能标识选中状态时,选中的导航可以使用组件自有的轮廓到填充成对图标。
无障碍意图¶
- 当信息尚未在文本中提供时,提供信息的图标需要无障碍图像名称。当符号本身可能产生歧义时,应提供解释性文本或工具提示。
- 装饰性图标不暴露重复名称,并始终与传达含义的可见文本配对。
- 图标图形 MUST 在其渲染尺寸下保持可识别。Astryx 不要求所有 16px 或以下图标都为填充样式:当前备用方案大多为轮廓图形,另有填充状态图标和本身为实心的标记。可用时优先选择特定尺寸或经过光学调整的图形;仅当上述填充使用标准适用时才使用填充。
- 图标前景色 MUST 与其背景保持适用的对比度。
- 交互式图标需要足够的周围空间以便识别,且需要由其控件拥有的可操作目标。
代表性示例¶
- 分组行的展开箭头是整个区域的交互控件,因此其预期标准角色是 16px 等效大小,而不是 12px 辅助指示符。Astryx 当前的备用展开箭头仍为轮廓样式。
- 表格排序方向箭头是与列标题关联的紧凑指示符,因此它使用 12px 等效角色,而按钮和
aria-sort承载交互与状态。它不需要填充图形。 - 当附近内容或无障碍名称对其作说明时,持续性语义信息提示可以使用填充图形和强调色。
- 开/关控件可以将“关”的轮廓图形与“开”的对应填充图形配对,同时其语义状态保持独立可用。
- 当包含目标与间距支持时,大型仅图标 Button 使用 20px 等效的突出控件字形;仅图标并不自动意味着突出。
- 24px 等效图标保留用于展示级或对象处理,而不是默认的图标按钮字形。
- 不可选择的列表项通常使用标准尺寸的轮廓图标,并采用主要或次要前景色。
视觉参考¶
不包含规范性资产。在推广之前,应在 docs/design/assets/iconography/ 下添加关于语义角色、12/16/20/24 尺寸阶梯、轮廓/填充例外、颜色角色及代表性构图的公共安全示例。
组件契约链接¶
component:Icon拥有共享的 12/16/20/24 尺寸词汇、裸 Icon 的md默认值、缩放行为、目标、颜色 API 和渲染语义;本记录为角色、颜色和图形选择分配设计意图。- 交互组件拥有其目标、状态、焦点、无障碍名称和图标槽位几何;Icon 仍然是该所有者内部的字形。
component:Table拥有所生成的 Table 可供性中哪些属于紧凑指示符、哪些属于标准控件的决定权。本记录成为现行规范后,分组行展开是第一个明确标准控件链接的候选。architecture:icon-resolution-and-component-slots拥有语义名称和图形解析。组件在注册表提供图形之前选择位置、尺寸、颜色和状态;注册表不是这些角色的所有者。architecture:component-theming-surface拥有主题化保证。共享的 Icon 目标反映size和color,因此主题可以一致地为现有值设置样式。局部组件角色覆盖仍需要具有相关属性保证的合格拥有目标;本记录不会创建这样一个目标。
决策日志¶
DEC-1 — 轮廓图形为默认,填充图形为刻意例外¶
参考: design:iconography/DEC-1
决策者: 待设计负责人批准
当存在有意义的成对图形时,从轮廓图形开始。仅在活动状态、经验证的 12px 或更小尺寸下的紧凑识别、持久语义状态、刻意强调、繁忙背景或规范徽标情况下使用填充图形。在同级控件之间保持一致性,不要将符号的形状或次要颜色视为自动填充的许可。
已否决:将填充图形作为普遍默认、填充所有 16px 及以下的图标、对展开箭头和关闭标记一律使用填充、将填充作为唯一状态提示,或仅仅因为资源存在就选择填充。
DEC-2 — Astryx 使用 12 / 16 / 20 / 24 角色阶梯¶
参考: design:iconography/DEC-2
决策者: 待设计负责人批准
使用 12px 等效尺寸用于紧凑的辅助指示符,16px 等效尺寸用于标准控件和展开控件,20px 等效尺寸用于突出控件(如大型图标按钮),24px 等效尺寸用于展示级或对象处理。裸 Icon 当前默认使用 20px 等效的 md;组合组件可以独立约束其图标槽位。
已否决:原样沿用旧版 12/16/24 三尺寸方案、将 16px 称为原始 Icon 默认值、对所有图标使用单一尺寸,或仅根据可用空间选择尺寸而不考虑含义。
DEC-3 — 信息性图标与装饰性图标具有不同的内容义务¶
参考: design:iconography/DEC-3
决策者: 待设计负责人批准
信息性图标除其标签外可能还承载额外含义,因此在独立使用时需要可访问的名称和充分的解释。装饰性图标不增加任何独立含义,始终与文本搭配使用,并向辅助技术隐藏,以避免重复播报。
已否决:将所有图标都视为信息性图标,或允许装饰性图标在没有标签的情况下独立存在。
DEC-4 — 主题在其所属表面上调优共享角色与组件角色¶
参考: design:iconography/DEC-4
决策者: 待设计负责人批准
主题可以替换共享语义图标名称对应的艺术资源,并可通过共享的 Icon 目标对现有 Icon.size 值进行一致调优。局部角色(例如某组件的展开控件)在存在合格的组件自有目标且该目标能保证相关属性时,应改用该目标。组件继续拥有位置、状态和可访问语义;本记录不会创建新的目标或保证。
已否决:添加临时的尺寸名称、仅为影响单个组件而更改共享尺寸、将艺术资源注册表作为组件行为或状态的属主,或假定当前每个承载图标的角色都可独立主题化。
未决问题¶
- OQ1 — 主题目标的推广。 哪些现有组件角色需要专用的合格目标,以便主题作者独立调优尺寸、颜色或艺术资源?
- OQ2 — 当前一致性。 哪些已发布的调用点与当前的 12/16/20/24 角色阶梯、轮廓默认样式或组合指南不一致,因而需要显式的组件自有例外?
- OQ3 — 规范性证据。 哪些安全可公开的示例最能展示含义角色、尺寸与艺术资源规则、颜色以及组合在参考系统主题与刻意不同的主题个性之间的差异?
内容边界¶
本文件定义了图标体系的公开视觉、组合与可访问性意图。它不规定特定的图标库、资产管理流程、请求流程、实现框架、属性语法、目标选择器、注册表描述符或迁移工具。它不改变 Icon 已发布的尺寸词汇或默认值,不定义命中目标阈值,不选择具体的 SVG 几何形状,也不实现主题覆盖。
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 as/astryx