Coding

Accessibility Check

Try it

Use when reviewing or improving frontend accessibility, semantic structure, keyboard support, focus management, ARIA labels, screen reader behavior, WCAG 2.2 issues, touch accessibility, or assistive-technology regressions; Chinese triggers include accessibility, accessibility, a11y, WCAG, screen re

What it does

确保前端 UI 对残障用户可访问,满足 WCAG 2.2 AA 的核心要求,并能被键盘、屏幕阅读器、触控和缩放用户稳定使用。

The skill document

无障碍实现规范(WCAG 2.2 AA)

Purpose

确保前端 UI 对残障用户可访问,满足 WCAG 2.2 AA 的核心要求,并能被键盘、屏幕阅读器、触控和缩放用户稳定使用。

Procedure

  1. 检查语义结构:landmark、标题层级、表单 label、按钮/链接可访问名称、表格语义和图片 alt。
  2. 检查键盘路径:Tab 顺序、Enter/Space/Esc 行为、焦点可见、关闭后焦点恢复。
  3. 检查复杂组件:对话框、菜单、标签页、树、抽屉、表格和自定义控件的 ARIA 状态。
  4. 检查动态状态:loading、empty、error、toast 和异步更新需要被屏幕阅读器感知。
  5. 检查视觉与触控可读性:文本/背景对比、focus ring、缩放到 200%、减少动效偏好、触摸目标尺寸和移动端虚拟键盘行为。
  6. 用真实键盘路径复核关键流程,必要时补充屏幕阅读器或浏览器无障碍树观察;屏幕阅读器流程见 references/screen-reader-testing.md。
  7. 复核 WCAG 2.2 新增高频风险:可见焦点不被遮挡、拖拽操作有替代路径、目标尺寸过小、帮助入口和认证流程不依赖记忆负担。
  8. 输出分级报告;报告格式见 references/report-template.md。

Detailed References

撰写无障碍审查报告时,加载 references/report-template.md。需要验证屏幕阅读器公告、焦点读法和动态区域时,加载 references/screen-reader-testing.md。

Constraints

  • 优先使用语义化 HTML,而不是 ARIA。
  • role 不应覆盖原生语义。
  • 交互元素必须可键盘访问。
  • 表单错误必须与字段关联。
  • 颜色对比度风险需要指出具体文本/背景组合。
  • 不用 ARIA 弥补可以用原生 HTML 解决的问题。
  • 不把浏览器自动可访问树当作最终结论;关键路径需要用键盘和至少一种辅助技术或等价检查验证。

Expected Output

交互元素可键盘访问,语义和 ARIA 使用正确,焦点管理稳定;无障碍检查报告保存为 reports/accessibility-review-YYYY-MM-DD-HHmmss.md。

Related skills

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

Join a video meeting as an AI bot with voice, avatar, and screenshare across four operating modes.

by johnpatternai22 installs8 stars

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Find why your productivity system keeps failing, then apply the smallest fix — capacity math, bottleneck routing, durable local notes.

by Iván855 installs69 stars

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván559 installs18 stars

More from bovinphang

Browse all skills

Generate or edit diagrams, visual assets, and image workflows with reviewable PNG self-checks and bounded self-repair.

by bovinphang9 installs1 stars

Use when creating editable technical diagrams with draw.io / diagrams.net sources, including architecture diagrams, ERD, UML, sequence diagrams, flowcharts, ML model diagrams, official shape lookup, brand symbols, Graphviz auto-layout, codebase structure maps, .drawio validation, or draw.io CLI expo

by bovinphang5 installs

Use when building, reviewing, or improving frontend UI that needs product-specific design direction, design-system generation, Master/Page overrides, distinctive visual identity, anti-generic interface choices, first-screen hierarchy, UI polish, chart UX, interaction states, responsive behavior, or

by bovinphang8 installs

Use when creating or reviewing Next.js 14+ App Router projects, file routes, layouts, server/client component boundaries, SSR/SSG/ISR, streaming, metadata, middleware, server actions, or Next-specific data fetching. For generic client React component architecture, apply the project's React conventio

by bovinphang10 installs1 stars

Use when creating, reviewing, or restructuring frontend monorepos with pnpm workspace, Turborepo, Nx, multi-package dependency boundaries, task orchestration, package naming, or package publishing; Chinese triggers include monorepo, workspace, multi-package.

by bovinphang10 installs1 stars

Use when creating or reviewing Nuxt 3 projects, file routes, pages, layouts, SSR/SSG/SPA behavior, Nuxt data fetching, route middleware, plugins, modules, server routes, or Nuxt-specific Vue 3 conventions. For generic Vue component architecture, apply the project's Vue conventions separately; Chines

by bovinphang10 installs1 stars