accessibility-compliance

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

权威入口

Authoritative Entries

  • .cursor/skills/accessibility-compliance/references/wcag-guidelines.md
  • .cursor/skills/accessibility-compliance/references/aria-patterns.md
  • .cursor/skills/accessibility-compliance/references/mobile-accessibility.md
  • .cursor/skills/accessibility-compliance/references/wcag-guidelines.md
  • .cursor/skills/accessibility-compliance/references/aria-patterns.md
  • .cursor/skills/accessibility-compliance/references/mobile-accessibility.md

适用场景

Applicable Scenarios

  • 页面需要通过键盘可操作与焦点可见性检查。
  • 组件需要补全语义与 ARIA 状态。
  • 需要兼容屏幕阅读器与移动端辅助功能。
  • Pages need to pass keyboard operability and focus visibility checks.
  • Components need to be supplemented with semantics and ARIA states.
  • Compatibility with screen readers and mobile accessibility features is required.

非适用场景

Not Applicable Scenarios

  • 不用于视觉风格美化或品牌设计决策。
  • 不替代业务接口、鉴权、数据层逻辑排查。
  • Not used for visual style beautification or brand design decisions.
  • Does not replace troubleshooting of business interfaces, authentication, or data layer logic.

执行步骤

Execution Steps

  1. 先检查语义标签和交互元素角色是否正确。
  2. 再检查焦点顺序、Tab 可达、Esc/Enter 行为。
  3. 补全名称与状态(label、aria-*、错误提示)。
  4. 验证颜色对比、文本缩放、移动端可点区域。
  5. 输出问题清单:严重级别、复现方式、修复建议。
  1. First check if semantic tags and interactive element roles are correct.
  2. Then check focus order, Tab accessibility, and Esc/Enter key behaviors.
  3. Complete names and states (label, aria-*, error prompts).
  4. Verify color contrast, text scaling, and mobile tappable areas.
  5. Output a list of issues: severity level, reproduction method, and repair suggestions.

常见陷阱

Common Pitfalls

  • 只加
    aria-label
    ,忽略真实可操作行为。
  • 仅鼠标可用,键盘无法完整完成任务流。
  • 用颜色单独传达状态,导致信息不可感知。
  • Only add
    aria-label
    while ignoring actual operable behaviors.
  • Only usable with a mouse, the task flow cannot be completed entirely with a keyboard.
  • Using color alone to convey status, resulting in imperceptible information.