Vue / 系统课时

可访问性基础

可访问性基础

可访问性要让页面在不用鼠标、看不清视觉状态或依赖辅助技术时仍然可以操作。本节从语义结构、键盘交互、焦点移动和状态提示建立 Vue 组件的最低可用标准,并用弹窗示例串起关键规则。

学习目标

  • 优先使用原生语义元素,减少不必要的 ARIA 补丁。
  • 为交互组件补齐键盘操作与清晰的焦点反馈。
  • 在弹层和异步状态变化时正确管理焦点与提示信息。

从原生语义开始

可点击操作优先使用 button,页面跳转优先使用 a,表单字段使用真实 label。原生控件已经提供角色、键盘激活方式和基础可访问性;如果用 div 模拟按钮,就必须额外维护角色、焦点和键盘事件,遗漏概率更高。

页面本身也要有可理解的结构。标题应按内容层级递进,导航、主内容、表单等区域使用合适的语义元素。ARIA 更适合补充原生语义无法表达的信息,而不是给所有元素机械地添加属性。

保持键盘顺序与焦点可见

浏览器会按照文档顺序让原生交互元素参与 Tab 导航。不要为了调整顺序给大量元素设置正数 tabindex,否则视觉顺序、DOM 顺序和键盘顺序会互相冲突。普通自定义控件确需进入 Tab 顺序时,一般使用 tabindex="0"。

焦点样式也不能被无替代地删除。如果设计系统重置了默认 outline,就要提供清晰的 :focus-visible 样式,让键盘用户能够判断当前操作对象。菜单、标签页等复合控件还应根据对应交互模式实现方向键,而不能只支持鼠标点击。

在弹窗中管理焦点

弹窗打开后,键盘焦点不能继续留在被遮挡的页面内容中;弹窗关闭后,也不能让焦点丢失。下面使用原生 dialog 实现一个最小流程:打开时把焦点移入弹窗,关闭时回到原触发按钮。

vue
<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>

预期结果

text
按 Tab 聚焦“删除项目”并按 Enter:
弹窗打开,焦点移动到“取消”按钮。

按 Esc 或激活“取消”:
弹窗关闭,焦点返回“删除项目”按钮。

真实业务若还包含“确认删除”等操作,需要根据风险和产品策略选择初始焦点。若项目因兼容要求不能使用原生 dialog,自定义弹层还必须处理背景不可交互、焦点约束以及关闭后的焦点恢复,不能只增加一个视觉遮罩。

让动态状态能够被感知

视觉 Toast、加载动画或颜色变化不一定会被屏幕阅读器感知。如果异步操作完成后不改变焦点,可以把普通状态消息放入 role="status" 区域;只有必须立即引起注意的严重错误,才考虑使用更强的 role="alert"。

状态不能只靠颜色表达。例如表单错误除了红色边框,还应有明确文字,并通过 aria-describedby 等方式把字段与错误信息关联。提交失败后,如果错误位于当前视口之外,还需要把焦点移动到错误摘要或首个无效字段附近。

vue
<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>

预期结果

text
激活“保存”后:按钮暂时显示“保存中…”并禁用。
操作完成后:页面显示“保存成功”,辅助技术可感知该状态变化。

这里使用 status 而不是强制打断用户的警报角色,因为普通保存成功属于非紧急反馈。实际异步请求耗时可能不同,不应依赖固定延迟来控制可访问性状态。

按固定顺序做可访问性验收

检查组件时可以按照“语义 → 键盘 → 焦点 → 状态”的顺序进行。先确认控件类型、标签和标题结构,再验证主要操作是否都能由键盘完成,然后检查弹层打开、节点删除和路由变化后的焦点位置,最后确认加载、成功和错误能否通过非视觉方式感知。

自动化检查可以发现缺少标签、部分 ARIA 错误和明显的对比度问题,但不能证明完整交互流程可用。企业应用的关键路径仍应进行键盘实测,并使用至少一种屏幕阅读器抽查。可访问性的核心不是堆叠属性,而是让页面语义、操作顺序、焦点位置和状态变化始终保持一致。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

可访问性基础

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通