nex_design_system/docs/06-accessibility-design.md

2.8 KiB
Raw Blame History

06. Accessibility as a Design Requirement

本文件定义产品界面应如何设计和实现无障碍体验。它不是屏幕阅读器测试手册、测试矩阵或质量验收流程。

1. 设计目标

默认以 WCAG 2.2 AA 作为 Web 产品的设计参考目标;具体法规、合同或客户要求优先。采用 NEX 不代表自动取得合规认证。

2. 语义结构

  • 使用符合意图的原生 HTML:按钮用 button,导航用 nav,链接用 a,表单控件使用适当原生元素。
  • 不把普通 div 当作交互控件,除非确实需要自定义复合控件并补齐语义与键盘行为。
  • 标题层级表达内容结构,不因视觉大小跳过语义层级。
  • 表单标签与控件建立明确关联;分组字段使用合适的语义分组。

3. 名称与图标

  • 每个交互控件都要有准确、简洁、可理解的可访问名称。
  • 图标旁已有可见文本时,装饰图标通常不参与名称计算,避免重复朗读。
  • 图标按钮应提供描述实际动作的业务名称。
  • 不将图标字体、glyph token 或内部图标库名称作为用户文案。
  • 重要截断文本必须有键盘、触屏和辅助技术均可获取的完整信息;不能只依赖 Hover Tooltip。

4. 键盘与焦点

  • 核心功能应可通过键盘完成。
  • Tab 顺序应符合视觉与任务顺序;焦点必须清晰可见。
  • 自定义控件应采用用户熟悉的键盘交互模式。
  • 拖拽排序、画布移动等操作应提供非拖拽替代路径,例如上移/下移按钮或其他等效操作。
  • 弹层、菜单和复合组件应明确焦点进入、移动、退出和返回方式。

5. 状态与动态内容

  • 状态不只依赖颜色,还应提供文本、图标或形状线索。
  • 错误信息应指出问题和修正方向。
  • 动态结果、保存状态和重要反馈应采用合适的语义表达;避免对每次细微变化都造成过量播报。
  • 仅在必要时使用 Live Region,并让提示内容简洁、时机合理。

6. 视觉可读性

  • 文本和交互元素与背景保持足够对比。
  • 不仅用颜色区分状态、图表系列或错误。
  • 字体大小、行高和内容宽度应支持长时间阅读。
  • 焦点、选中、禁用和悬停状态应有可辨识差异。

7. 动效与输入方式

  • 尊重 prefers-reduced-motion 或目标平台等效设置。
  • 关键操作不能只依赖 Hover。
  • 触控目标应有合理尺寸和间距,避免相邻操作误触。
  • 为拖拽、滑动或复杂手势提供其他可用操作方式。

8. 适用性

上述要求适用于项目真实存在的页面和控件。NEX 不要求每个项目都建立屏幕阅读器测试环境,也不规定 VoiceOver、NVDA、Orca 的启动、执行或记录流程;项目如有相关测试要求,由项目自己的工程规范决定。