UI 视觉设计 / 系统课时

验证控件语义与辅助技术提示

验证控件语义与辅助技术提示

一张页面即使视觉分组清楚,也可能让屏幕阅读器用户找不到主内容、听不懂按钮用途,或无法判断哪个字段填写错误。本课以新建工单表单为例,检查标题、地标、控件名称和错误关联,并通过浏览器辅助功能树与屏幕阅读器完成实际验收。

学习目标

  • 核查页面标题层级、地标区域及其辅助技术导航顺序。
  • 使用原生 HTML 和必要的 ARIA 属性表达控件名称、说明与错误状态。
  • 通过键盘、浏览器辅助功能树和屏幕阅读器验证实际操作体验。

检查标题层级与页面地标

屏幕阅读器可以按标题和地标快速跳转,不必逐字朗读整个页面。因此,视觉上的大标题、侧栏和内容分区,需要在语义结构中拥有对应的位置。

以新建工单页面为例,建议按以下规则检查:

  1. 页面主标题使用一个表达当前页面主题的 h1,例如“新建工单”;下一级内容分组使用 h2,例如“基本信息”。不要为了获得较大的字体而随意使用标题标签。
  2. 页面级页头使用 header,主要导航使用 nav,核心内容使用 main,页面级页脚使用 footer。通常每个页面只设置一个可见的主要内容地标。
  3. 存在多个导航区域时,使用 aria-label 或 aria-labelledby 区分“主导航”“工单导航”等用途,避免导航列表出现多个无法区分的同名区域。
  4. 使用带有目标锚点的“跳到主要内容”链接,让键盘用户可以跳过重复导航。

工单页面视觉分区与辅助技术标题地标导航结构对照

检查时不要只看 DOM 标签数量,还要确认语义是否符合实际用途。例如,一个只用于卡片视觉分组的容器不一定需要额外的 region 地标;过多地标反而会增加屏幕阅读器导航负担。

检查控件的名称、角色与状态

辅助技术主要通过控件的名称、角色、状态和说明理解界面。对每一个可操作元素,都要确认用户不看屏幕也能知道它是什么、能做什么,以及当前是否可以操作。

检查对象 正确做法 常见问题
文本输入框 使用 label 的 for 与输入框 id 关联 只有 placeholder,缺少持久标签
普通按钮 使用 button 并提供明确的可见名称 使用可点击的 div,缺少键盘行为
图标按钮 提供准确的可访问名称,例如 aria-label 只有图标,没有操作名称
必填字段 使用原生 required 属性 只在标签后画红色星号
禁用按钮 使用原生 disabled 属性 仅降低透明度,实际上仍可点击
辅助说明 使用 aria-describedby 关联说明文字 说明文字虽然相邻,但没有程序化关联

原生 HTML 已经能表达的语义,应优先使用原生元素。例如,真正的 button 默认支持键盘聚焦和 Enter、Space 激活,通常不需要额外声明 role='button'。

aria-label 也不应随意覆盖清楚的可见文字。一个已经显示“提交工单”的按钮,直接使用按钮文本作为名称即可;对缺乏文字的图标按钮,才需要补充合适的可访问名称。

将表单错误关联到具体字段

表单错误是最容易出现“看得到却听不到”的问题。仅将输入框边框改为红色,无法让屏幕阅读器知道输入无效,也无法告诉用户如何修正。

下面是一份可以直接保存为 ticket.html 并用现代浏览器打开的完整示例。它使用原生邮箱校验、字段标签、关联说明与错误状态,同时保留可供辅助技术导航的页面地标。

html
<!doctype html>
<html lang='zh-CN'>
<head>
  <meta charset='utf-8'>
  <meta name='viewport' content='width=device-width, initial-scale=1'>
  <title>新建工单</title>
</head>
<body>
  <a href='#main'>跳到主要内容</a>
  <header>
    <p>工单系统</p>
    <nav aria-label='主导航'>
      <a href='#ticket-form'>工单表单</a>
    </nav>
  </header>
  <main id='main'>
    <h1>新建工单</h1>
    <section aria-labelledby='basic-heading'>
      <h2 id='basic-heading'>基本信息</h2>
      <form id='ticket-form' novalidate>
        <label for='email'>联系邮箱(必填)</label>
        <input id='email' name='email' type='email'
               required aria-describedby='email-help'>
        <p id='email-help'>用于接收工单处理进度。</p>
        <p id='email-error' hidden>错误:请输入有效的联系邮箱。</p>
        <button type='submit'>提交工单</button>
      </form>
    </section>
    <p id='status' role='status'></p>
  </main>
  <footer><p>帮助中心</p></footer>
  <script>
    const form = document.querySelector('#ticket-form');
    const email = document.querySelector('#email');
    const error = document.querySelector('#email-error');
    const status = document.querySelector('#status');

    form.addEventListener('submit', (event) => {
      event.preventDefault();
      // 使用原生约束校验,覆盖必填和邮箱格式
      const invalid = !email.checkValidity();
      error.hidden = !invalid;
      email.setAttribute('aria-describedby',
        invalid ? 'email-help email-error' : 'email-help');

      if (invalid) {
        email.setAttribute('aria-invalid', 'true');
        status.textContent = '';
        email.focus();
        return;
      }

      // 校验通过只更新状态,不模拟真实服务器响应
      email.removeAttribute('aria-invalid');
      status.textContent = '校验通过,演示页面未发送请求。';
    });
  </script>
</body>
</html>

预期结果:页面显示“新建工单”标题、联系邮箱输入框及“提交工单”按钮。直接提交空表单或填写 abc 后提交,页面显示错误文字,焦点返回邮箱输入框,字段被标记为无效。改为 user@example.com 并再次提交,错误隐藏,页面显示“校验通过,演示页面未发送请求。”

此示例仅验证本地表单行为,没有连接后端,因此不会真正创建工单。

这里有四个需要同时成立的关系:

  • label 通过 for='email' 将“联系邮箱(必填)”设置为输入框的可访问名称。
  • aria-describedby 将辅助说明和当前可见的错误文字关联到输入框,多个引用 ID 使用空格分隔。
  • 校验失败后才添加 aria-invalid='true',避免用户尚未输入时就收到无效状态;修正并重新提交成功后移除该属性。
  • role='status' 用于通知非紧急的动态结果,通常具有礼貌播报行为,不需要强制转移焦点。

aria-describedby 和 aria-invalid 分别解决错误说明关联与无效状态表达,二者不能互相替代。实际项目还应在多个字段同时报错时提供可定位的错误摘要,并处理首次提交、重新编辑和再次提交之间的状态更新。

使用开发者工具与屏幕阅读器验收

浏览器开发者工具可以检查辅助功能树中的名称、角色和属性,但无法代替真实屏幕阅读器。建议采用以下顺序完成双重验证。

  1. 在 Chrome 中打开示例页面,按 F12,进入 DevTools 的 Elements 面板,选中邮箱输入框,再查看 Accessibility 面板或对应的辅助功能树视图。不同版本的面板入口可能有所调整。
  2. 检查输入框的角色是否为文本输入控件,可访问名称是否为“联系邮箱(必填)”,说明是否包含“用于接收工单处理进度。”。提交无效内容后,再检查无效状态与错误说明是否关联。
  3. 在 Windows 的 Chrome 中开启 NVDA,并进入浏览模式。尝试使用 H 按标题导航、D 按地标导航、B 按按钮导航,确认能找到页面主标题、主内容和提交按钮。这些快捷键适用于 NVDA 浏览模式,其他屏幕阅读器可能不同。
  4. 使用 Tab 聚焦控件,提交空表单,检查邮箱字段是否得到焦点,并能读到字段名称、必填或无效状态以及错误说明。实际播报措辞和先后顺序取决于浏览器与屏幕阅读器组合,不要求逐字相同。
  5. 在支持的移动设备上,使用 iOS Safari 与 VoiceOver,或 Android Chrome 与 TalkBack,检查标题导航、触摸探索、输入字段名称和提交错误反馈,确认没有依赖鼠标悬停才能获得的信息。

建议为项目记录至少一组明确的测试环境,例如 Windows、Chrome、NVDA,以及一组移动端屏幕阅读器环境。每条验收记录包含控件名称、操作方式、预期语义、实际播报与是否通过,而不只填写“已通过无障碍测试”。

修正常见的辅助技术体验缺陷

对工单表单进行最终审查时,可用以下问题定位高频缺陷:

  • 只使用占位文字:输入内容后提示消失,屏幕阅读器也可能缺少稳定名称。改为始终可见的 label,将占位文字仅用于格式示例。
  • 图标按钮读作无名称按钮:为没有可见文字的图标按钮提供准确名称,如“关闭编辑面板”,并检查名称是否与功能一致。
  • 错误只靠红框提示:增加可见的错误文字,通过 aria-describedby 与具体字段关联,并在校验失败后设置 aria-invalid。
  • 同一页面出现多个无法区分的导航地标:为不同用途的 nav 设置有意义的名称;如果两个导航具有相同用途和链接集合,可以使用相同名称。
  • 使用 ARIA 修饰错误的控件类型:不要依赖给普通容器添加 role='button' 来替代完整按钮行为。优先使用原生按钮;确需自定义控件时,必须额外实现焦点、键盘激活和相关状态。

最终验收以用户能够完成实际任务为准:屏幕阅读器用户应能定位“新建工单”、识别联系邮箱字段、理解错误原因、修改输入并完成校验。辅助功能树属性正确只是必要检查,只有配合键盘操作和真实辅助技术验证,才能发现漏报、重复播报与焦点位置不合理的问题。

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

目录与阅读设置

阅读设置

17

记录一个想法

验证控件语义与辅助技术提示

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

登录哪都通