如何为Nuxt.js站点实现基于Tab键的无障碍(a11y)键盘导航
问题排查与解决方案
1. 优先排查全局焦点样式配置
这是 Tailwind CSS 项目里最常见的诱因:
- 很多开发者会在全局样式里加
* { outline: none; }或者给所有元素统一加focus:outline-none重置样式,又没有补充自定义的焦点高亮样式,会造成「元素没拿到焦点」的错觉 - 验证方法:按 Tab 键的同时在浏览器控制台执行
document.activeElement,如果返回的是你预期的链接/按钮元素,说明焦点正常只是样式被隐藏,补充focus:outline/focus:ring类的焦点样式即可 - 如果
activeElement一直返回<html>或<body>根元素,再往下排查结构问题
2. Nuxt 框架相关配置排查
- 检查布局文件的根容器有没有误加
tabindex="-1"、aria-hidden="true"、inert这类禁用交互的属性,父级容器被设为不可交互时,子元素的焦点行为会受影响 - 排查路由过渡配置:如果用了自定义的
<Transition>组件,过渡动画过程中如果仅修改了透明度、位移属性,没有同步处理可见状态,会导致焦点被锁在根节点 - 排查第三方模块冲突:部分弹窗、模态框类的Nuxt模块如果没有正确实现焦点释放逻辑,会强制把焦点限制在根文档层级
3. HTML 结构的属性错误排查
- 确认所有可交互元素用的是原生
<a>、<button>标签,而非<div>、<span>模拟的组件:原生标签默认支持焦点导航,模拟元素仅加tabindex不够,还需要补充 Enter、Space 键的触发事件 - 不要给可交互元素设置大于 0 的
tabindex值,会打乱默认的导航顺序,原生可交互元素保留默认tabindex即可,模拟可交互元素仅需加tabindex="0" - 排查父级元素有没有加
pointer-events: none属性,该属性会禁用所有交互行为包括焦点获取
4. 快速验证方法
新建一个空白Nuxt页面,仅保留以下测试代码:
<template> <div> <a href="/test">测试链接</a> <button type="button">测试按钮</button> </div> </template>
如果该页面可以正常用Tab键导航,说明是原有页面的样式或属性配置问题,和Nuxt、Tailwind本身无关。
内容的提问来源于stack exchange,提问作者Sahil Shaheen
相关产品推荐
相关产品推荐

