PrimeVue 的无障碍支持包括哪些内容?

PrimeVue 宣称组件默认遵循 WCAG，并在键盘导航、屏幕阅读器语义、ARIA 属性与焦点管理四个方面开箱即用。如果你的项目需要表单、对话框、数据表格等组件在键盘操作和辅助技术下可用，这套默认能力可以作为选型依据；但“默认合规”不等于“整站自动合规”，页面结构、文案和自定义样式仍需自行检查。

四项默认能力

根据 PrimeVue 官网的 Accessibility 区块，其无障碍支持覆盖以下内容：

这四项是相互配合的：例如一个 Dialog 打开后，焦点被限制在弹层内（焦点陷阱），按 Escape 关闭，焦点回到原来的按钮（焦点恢复），同时屏幕阅读器通过 ARIA 属性识别这是一个模态对话框。PrimeVue 把这些行为做进了组件内部，而不是留给使用方逐项配置。

键盘操作的实际含义

官网列出的按键包括 Tab、方向键、Enter 和 Escape。对应到常见组件：

• Tab：在可聚焦元素之间移动，如按钮、输入框、表格单元格。
• 方向键：在菜单项、选项列表、标签页之间切换。
• Enter：确认选择或触发当前项。
• Escape：关闭弹层、取消当前操作。

这意味着，对于一个只用键盘的用户，选择、确认、取消这些核心流程不需要鼠标即可完成。验证方法很直接：在浏览器中只用键盘走一遍你的关键流程（登录、填表、打开对话框、提交），观察焦点是否可见、是否按预期移动、Escape 是否能退出弹层。

自动 ARIA 与焦点管理解决了什么

手写无障碍最耗时的部分往往不是加一个 role，而是维护状态同步：展开/收起、选中/未选中、禁用、错误提示，这些状态要在正确时机更新到正确的元素上。PrimeVue 按 WAI-ARIA 模式自动应用角色、状态和属性，相当于把这部分一致性交给组件库。

焦点管理同理。模态对话框的焦点陷阱如果手写，容易漏掉边界情况（比如弹层内没有可聚焦元素时）。PrimeVue 声明内置焦点陷阱、焦点恢复和可见焦点指示，使用方只需保证弹层内容本身可聚焦、可读。

使用前需要确认的条件

• 版本与组件范围：官网描述的是组件整体能力，具体某个组件的行为以其文档页为准，接入前应查看对应组件的 Accessibility 说明。
• 自定义主题不影响语义：PrimeVue 的主题通过设计令牌定制颜色、间距、圆角，属于视觉层；无障碍能力来自组件结构与行为，两者可以独立看待。
• 整站合规仍需自查：组件默认合规只覆盖组件本身。页面标题层级、图片替代文本、颜色对比度（尤其自定义主题后）、表单错误提示的关联，都需要在应用层验证。
• 测试不能省：建议至少做一次纯键盘走查，并用屏幕阅读器抽测关键页面；有条件时再引入自动化无障碍扫描工具。

一个判断例子

假设你要做一个带筛选和分页的数据表格，用户需要完全用键盘完成“筛选条件输入 → 选择某行 → 打开详情对话框 → 关闭返回列表”。如果使用 PrimeVue 的 DataTable 与 Dialog，键盘导航、ARIA 状态和焦点恢复由组件承担，你只需确认筛选输入框有可读标签、对话框标题被正确关联。若自行用原生元素拼装同样交互，上述每一项都要手工实现和测试。这就是“默认无障碍”在工程上的实际价值：把重复且易错的部分前置到组件层。