自动化测试 / 系统课时

验证无障碍属性

验证无障碍属性

本课解决按钮能被鼠标点击、却缺少辅助技术可识别语义或键盘无法操作的问题。使用一个本地构造的表单,通过 Playwright 验证角色、可访问名称、无障碍树快照与 Tab、Enter 的实际行为。

学习目标

  • 区分元素可见性与角色、可访问名称等无障碍语义。
  • 使用角色定位和 ARIA 快照断言检查表单控件。
  • 通过焦点与键盘激活断言验证基本操作路径。

检查元素语义

无障碍测试要检查浏览器暴露给辅助技术的角色(role)和可访问名称(accessible name)。例如 <button>Submit</button> 通常具有 button 角色和 Submit 名称;<label for="email">Email</label> 与同 ID 的输入框关联后,输入框才会获得 Email 名称。只检查 toBeVisible() 不能发现这些缺陷。

getByRole('button', { name: 'Submit' }) 按实际语义定位,toHaveAccessibleName() 则可直接断言名称;toMatchAriaSnapshot() 将某个区域的无障碍树与预期结构比较。相比逐一检查 aria-label 属性,这种方式也能覆盖原生 HTML 产生的语义。

验证角色、快照与键盘操作

将下方代码保存为 tests/accessibility.spec.ts,然后运行 npx playwright test tests/accessibility.spec.ts --project=chromium(项目需已安装 @playwright/test、Chromium,并配置名为 chromium 的测试项目)。页面由 page.setContent() 创建,不依赖在线网站。

ts
import { test, expect } from '@playwright/test';

test('验证无障碍属性和键盘操作', async ({ page }) => {
  await page.setContent(`
    <main>
      <label for="email">Email</label>
      <input id="email" type="email">
      <button id="submit" type="button">Submit</button>
      <p id="status" role="status">Ready</p>
    </main>
    <script>
      document.getElementById('submit').addEventListener('click', () => {
        document.getElementById('status').textContent = 'Submitted';
      });
    </script>
  `);

  const email = page.getByRole('textbox', { name: 'Email' });
  const submit = page.getByRole('button', { name: 'Submit' });

  // 校验原生控件的可访问语义及其顺序。
  await expect(email).toBeVisible();
  await expect(submit).toHaveAccessibleName('Submit');
  await expect(page.getByRole('main')).toMatchAriaSnapshot(`
    - textbox "Email"
    - button "Submit"
  `);

  // 从页面初始焦点开始,使用键盘到达并激活按钮。
  await page.keyboard.press('Tab');
  await expect(email).toBeFocused();
  await page.keyboard.press('Tab');
  await expect(submit).toBeFocused();
  await page.keyboard.press('Enter');
  await expect(page.getByRole('status')).toHaveText('Submitted');
});

预期输出(耗时随机器变化):

text
1 passed (<TIME>)

这里的 <TIME> 是运行器显示的实际耗时。测试通过说明:输入框与按钮可被正确识别,ARIA 快照包含预期控件,按两次 Tab 后焦点按顺序移动,Enter 能触发按钮,并使状态文本变为 Submitted。

定位失败与必要边界

若删除 label 的 for 关联,输入框可能失去 Email 名称,角色定位或快照断言会失败;若把原生按钮替换成没有键盘支持的普通 div,通常无法通过 button 角色定位,也无法按预期通过 Tab、Enter 操作。修复时应优先使用原生 <button>、<label>,不要只为通过断言而随意添加 ARIA 属性。

示例的 Tab 顺序只适用于当前仅有两个可聚焦控件的页面。真实页面要先确定起始焦点,再覆盖弹窗打开、焦点返回等关键路径;ARIA 快照也不能单独证明焦点行为正确。自动化通过后,还应使用屏幕阅读器检查朗读体验,并人工核验对比度和视觉焦点提示。

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

目录与阅读设置

阅读设置

17

记录一个想法

验证无障碍属性

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

登录哪都通