Vue / 系统课时
可访问性基础
可访问性基础
可访问性要让页面在不用鼠标、看不清视觉状态或依赖辅助技术时仍然可以操作。本节从语义结构、键盘交互、焦点移动和状态提示建立 Vue 组件的最低可用标准,并用弹窗示例串起关键规则。
学习目标
- 优先使用原生语义元素,减少不必要的 ARIA 补丁。
- 为交互组件补齐键盘操作与清晰的焦点反馈。
- 在弹层和异步状态变化时正确管理焦点与提示信息。
从原生语义开始
可点击操作优先使用 button,页面跳转优先使用 a,表单字段使用真实 label。原生控件已经提供角色、键盘激活方式和基础可访问性;如果用 div 模拟按钮,就必须额外维护角色、焦点和键盘事件,遗漏概率更高。
页面本身也要有可理解的结构。标题应按内容层级递进,导航、主内容、表单等区域使用合适的语义元素。ARIA 更适合补充原生语义无法表达的信息,而不是给所有元素机械地添加属性。
保持键盘顺序与焦点可见
浏览器会按照文档顺序让原生交互元素参与 Tab 导航。不要为了调整顺序给大量元素设置正数 tabindex,否则视觉顺序、DOM 顺序和键盘顺序会互相冲突。普通自定义控件确需进入 Tab 顺序时,一般使用 tabindex="0"。
焦点样式也不能被无替代地删除。如果设计系统重置了默认 outline,就要提供清晰的 :focus-visible 样式,让键盘用户能够判断当前操作对象。菜单、标签页等复合控件还应根据对应交互模式实现方向键,而不能只支持鼠标点击。
在弹窗中管理焦点
弹窗打开后,键盘焦点不能继续留在被遮挡的页面内容中;弹窗关闭后,也不能让焦点丢失。下面使用原生 dialog 实现一个最小流程:打开时把焦点移入弹窗,关闭时回到原触发按钮。
<script setup lang="ts">
import { nextTick, ref } from 'vue'
const dialogRef = ref<HTMLDialogElement | null>(null)
const closeButtonRef = ref<HTMLButtonElement | null>(null)
const triggerRef = ref<HTMLButtonElement | null>(null)
async function openDialog() {
dialogRef.value?.showModal()
await nextTick()
// 明确指定初始焦点,避免用户重新寻找当前位置。
closeButtonRef.value?.focus()
}
function closeDialog() {
dialogRef.value?.close()
// 恢复到打开弹窗的触发点,保持键盘操作连续。
triggerRef.value?.focus()
}
</script>
<template>
<button ref="triggerRef" type="button" @click="openDialog">
删除项目
</button>
<dialog
ref="dialogRef"
aria-labelledby="delete-title"
@cancel="closeDialog"
>
<h2 id="delete-title">确认删除</h2>
<p>删除后无法恢复。</p>
<button ref="closeButtonRef" type="button" @click="closeDialog">
取消
</button>
</dialog>
</template>预期结果
按 Tab 聚焦“删除项目”并按 Enter:
弹窗打开,焦点移动到“取消”按钮。
按 Esc 或激活“取消”:
弹窗关闭,焦点返回“删除项目”按钮。真实业务若还包含“确认删除”等操作,需要根据风险和产品策略选择初始焦点。若项目因兼容要求不能使用原生 dialog,自定义弹层还必须处理背景不可交互、焦点约束以及关闭后的焦点恢复,不能只增加一个视觉遮罩。
让动态状态能够被感知
视觉 Toast、加载动画或颜色变化不一定会被屏幕阅读器感知。如果异步操作完成后不改变焦点,可以把普通状态消息放入 role="status" 区域;只有必须立即引起注意的严重错误,才考虑使用更强的 role="alert"。
状态不能只靠颜色表达。例如表单错误除了红色边框,还应有明确文字,并通过 aria-describedby 等方式把字段与错误信息关联。提交失败后,如果错误位于当前视口之外,还需要把焦点移动到错误摘要或首个无效字段附近。
<script setup lang="ts">
import { ref } from 'vue'
const saving = ref(false)
const message = ref('')
async function save() {
saving.value = true
message.value = ''
await Promise.resolve()
saving.value = false
message.value = '保存成功'
}
</script>
<template>
<button type="button" :disabled="saving" @click="save">
{{ saving ? '保存中…' : '保存' }}
</button>
<p role="status" aria-live="polite">{{ message }}</p>
</template>预期结果
激活“保存”后:按钮暂时显示“保存中…”并禁用。
操作完成后:页面显示“保存成功”,辅助技术可感知该状态变化。这里使用 status 而不是强制打断用户的警报角色,因为普通保存成功属于非紧急反馈。实际异步请求耗时可能不同,不应依赖固定延迟来控制可访问性状态。
按固定顺序做可访问性验收
检查组件时可以按照“语义 → 键盘 → 焦点 → 状态”的顺序进行。先确认控件类型、标签和标题结构,再验证主要操作是否都能由键盘完成,然后检查弹层打开、节点删除和路由变化后的焦点位置,最后确认加载、成功和错误能否通过非视觉方式感知。
自动化检查可以发现缺少标签、部分 ARIA 错误和明显的对比度问题,但不能证明完整交互流程可用。企业应用的关键路径仍应进行键盘实测,并使用至少一种屏幕阅读器抽查。可访问性的核心不是堆叠属性,而是让页面语义、操作顺序、焦点位置和状态变化始终保持一致。