jsx-a11y 与组件级防护
使用代码库中的检查规则捕获问题。
jsx-a11y 与组件级防护 是 CoddyKit 上的免费 Web Accessibility Academy 课时。 这是第 4 节课,共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Web Accessibility Academy 学习路径的一部分,你的进度在网页和 CoddyKit 应用中同步。 Web Accessibility Academy 课程共包含 4 节课。
在发布前发现错误
许多无障碍问题很容易在代码中发现。代码检查器可以在您输入时标记这些问题,早在真实用户遇到障碍之前就提醒您。🛡️
认识 jsx-a11y
eslint-plugin-jsx-a11y 软件包为 ESLint 的 JSX 添加了无障碍规则。它会检查组件中常见且广为人知的无障碍错误。
npm install eslint-plugin-jsx-a11y --save-dev启用推荐规则集
扩展插件的 recommended 配置,即可一次启用一套可靠的基础规则,而不必手动逐个开启。
extends: ['plugin:jsx-a11y/recommended']替代文本规则
当 img 没有 alt 属性时,插件会发出警告。这条规则就能避免一种非常常见且影响很大的无障碍问题。
<img src="logo.png" alt="Acme logo" />捕获静态元素上的点击操作
在没有键盘支持的 div 上添加 onClick 会触发警告。解决方法是使用真正的按钮,因为它可以获得焦点并支持键盘操作。
检查标签关联
规则会验证表单控件是否具有关联的标签。没有标签的字段会被标记,从而不会在没有名称的情况下到达用户面前。
仅使用有效的 ARIA
插件会检查 ARIA 属性和角色是否真实存在且使用正确。像 aria-lable 这样的拼写错误或无效角色都会立即被发现。
代码检查器也有局限
代码检查器只能看到静态代码。它无法判断您的 alt 文本是否有意义,也无法判断焦点顺序是否合理,因此手动测试仍然很重要。
构建无障碍组件
将无障碍能力内置到共享组件中。可复用的 Button 如果始终渲染真正的按钮元素,就能让整个应用都获得良好的行为。
在持续集成中设置门禁
在您的流水线中运行 ESLint,让无障碍警告导致构建失败。这样可以防止回归问题通过代码审查并进入生产环境。
编辑器反馈循环
使用 ESLint 编辑器扩展时,警告会直接出现在代码中。这种快速反馈能让团队在编写代码时就学会无障碍模式。
快速检查
您的团队将 eslint-plugin-jsx-a11y 添加到了项目中。您仍然不应期待它完成什么工作?
总结:代码中的防护栏
使用 jsx-a11y 捕获常见错误,构建无障碍共享组件,并在持续集成中设置门禁;对于其余问题,仍需依靠手动测试。✅
常见问题解答
「jsx-a11y 与组件级防护」课时是免费的吗?
是的 — 「jsx-a11y 与组件级防护」的完整文本可在网页上免费阅读。要进行交互式练习(内置代码编辑器和全天候 AI 导师)并解锁 Web Accessibility Academy 课程的其余内容,请升级到 CoddyKit PRO。 Web Accessibility Academy 课程共包含 4 节课。
「jsx-a11y 与组件级防护」这节课中我会学到什么?
使用代码库中的检查规则捕获问题。 你通过在浏览器中直接运行的动手代码来练习 Web Accessibility Academy,全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Web Accessibility Academy 需要有经验吗?
无需任何先前经验。CoddyKit 上的 Web Accessibility Academy 课程适合初学者到高级学习者,你可以从这里开始或从头开始,按照自己的节奏学习。 这是第 4 节课,共 4 节。
「jsx-a11y 与组件级防护」课时需要多长时间?
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动,所以你能稳步进步,并在网页和应用中从离开的地方继续。
我能在这节 Web Accessibility Academy 课中编写并运行代码吗?
能。每节 Web Accessibility Academy 课都包含内置代码编辑器,你可以在浏览器中直接编写并运行真实代码,并获得即时 AI 反馈 — 无需本地设置。