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