nex_design_system/docs/08-accessibility-responsive.md

2.5 KiB

08. Accessibility & Responsive Quality

1. 语义优先

  • 触发动作使用原生按钮语义;页面跳转使用链接语义。
  • 避免用可点击 div / span 模拟按钮或链接,除非有充分理由且完整实现相应 ARIA、键盘和焦点行为。
  • 表单控件应有可访问名称;错误信息应能与对应控件关联。
  • 图标按钮应有可访问名称;装饰图标应避免重复朗读。

2. 键盘和焦点

  • 所有核心功能应可通过键盘访问。
  • Tab 顺序应与视觉和任务顺序一致。
  • Enter / Space 的行为应符合控件语义。
  • 焦点必须清晰可见,不得通过 CSS 全局移除焦点轮廓而不提供替代样式。
  • Modal、Drawer、Popover 等浮层应正确管理焦点进入、焦点返回和关闭行为。

3. 拖拽和复杂指针交互

任何依赖拖拽完成的核心操作都必须提供非拖拽替代路径,例如:

  • 通过按钮/菜单选择“上移/下移”或目标位置;
  • 通过键盘命令完成移动、排序或节点连接;
  • 提供可聚焦的操作控件和明确的状态反馈。

不能假设 HTML5 Drag and Drop API 自身就提供完整键盘体验。画布、排序列表和流程编辑器尤其需要验证替代路径。

4. 状态和文本

  • 状态不能只以颜色表示。
  • 截断后的重要状态、名称和错误信息必须有可访问的完整文本渠道。
  • Tooltip 不能成为键盘/触屏用户获取关键内容的唯一方式;必要时同步提供 aria-label、可展开文本或其他访问方式。
  • Loading、Empty、Error、Forbidden、Disabled 等状态使用清晰且可操作的文案。

5. 响应式

  • 使用项目既有断点;新增断点应有布局证据。
  • 验证导航、工具栏、表格、表单、多栏工作区和弹层在目标视口下的可用性。
  • 交互热区应满足目标平台和适用标准;不要只缩小图标而保留过小点击区域。
  • 移动端复杂表格可采用横向滚动、列优先级或卡片替代等策略,具体由项目设计规范决定。

6. 动效和偏好

  • 尊重 prefers-reduced-motion 或目标平台等效设置。
  • 避免闪烁、持续运动和不必要的空间位移。
  • 动效不应造成焦点丢失、滚动位置跳变或操作延迟。

7. 建议验收

至少覆盖:键盘路径、可见焦点、图标名称、状态文本、拖拽替代操作、窄屏关键操作、文本溢出和减少动态效果设置。根据项目范围和技术能力选择自动化与人工检查方式。