PAYATHON 2026

嵌套表格的 role="presentation" 导致 VoiceOver 漏读正常吗?

数据小陈

结论

role="presentation" 不应让嵌套表格中的商品名称和品牌从无障碍内容中消失。ARIA 规范也不将这种漏读视为预期行为。

根据题述现象,可以先按 Mac Mail 与 VoiceOver 组合下的兼容性问题排查。现有信息还不能确认这是已有官方记录的 bug,也不能断定缺陷仅由 VoiceOver 造成。需要检查邮件实际渲染后的结构、无障碍树和具体的导航方式。

ARIA 规范要求保留什么

role="presentation" 用于移除元素的隐式原生语义。用在 layout table 上时,内层 <table> 及其结构性后代,例如 <tbody>、<tr> 和 <td>,会失去表格、行和单元格语义,其中的文本和其他内容仍应保留。规范区分了移除结构语义和移除内容。WAI-ARIA:presentation role

对这段代码而言,预期是:

  • 内层 layout table 不再作为独立的数据表格提供导航。
  • Product name 和 Brand: LEG 仍可访问。
  • 内层表格上的角色不会向上取消外层 <td> 或外层 data table 的语义。

这里的角色继承针对表格所需的结构性后代,并不意味着所有后代内容都应隐藏。role="presentation" 也不等同于 aria-hidden="true"。WAI-ARIA:presentation role

为什么 Mail 与 Chrome 的结果不同

即使都使用 VoiceOver,Mail 和 Chrome 提供的无障碍结构也可能不同。应用对 HTML 的处理、内容向 accessibility API 的暴露方式,以及 VoiceOver 的遍历方式,都会影响朗读结果。WAI-ARIA 的交互模型包含 user agent、accessibility API 和辅助技术等环节。WAI-ARIA:User Agent Support

Chrome 中正常而 Mail 中异常,有助于缩小排查范围,但仅凭这一差异不能确定由哪个组件负责。还需要核对实际收到的邮件,确认邮件客户端是否改写了 HTML。

表格导航时没有自动读出某段文字,与这段文字在所有阅读方式下都无法访问,是两种不同的情况。ARIA 要求内容可访问,并未规定每次移动到单元格时都必须以完全相同的方式播报。

如何排查和处理

  1. 对同一份邮件内容做对照测试,只切换内层表格的 role="presentation"。原示例中两个表格的列标题、数据和列顺序也不同,直接比较会引入额外变量。
  2. 分别测试连续朗读、逐项导航和表格单元格导航,记录商品名称与品牌在哪种方式下被跳过。
  3. 核对接收后的 HTML,并在工具允许时检查 Mail 暴露的无障碍树。如果文本节点已经缺失,优先调查内容处理或无障碍映射;如果节点存在却无法朗读,再调查导航与播报行为。
  4. 交付时可以先移除内层表格的 role="presentation"。题述测试表明这一改动在当前两个环境中有效,但仍需在目标邮件客户端回归测试。

移除该角色后,内层 layout table 可能被当作额外表格播报,需要实际检查。不能因此推断所有布局表格都应该省略该角色。

可替换的代码结构

如果内层表格只负责把图片放在详情上方,可以尝试去掉这层嵌套,保留外层 data table:

<table width="100%" cellpadding="0" cellspacing="0" border="0">
  <thead>
    <tr>
      <th scope="col">Free product(s)</th>
      <th scope="col">Qty</th>
      <th scope="col">Total</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>
        <div>
          <img src="product.jpg" alt="Product image" />
        </div>
        <div>
          <span>Product name</span>
          <p>Brand: LEG</p>
        </div>
      </td>
      <td>1</td>
      <td>Free</td>
    </tr>
  </tbody>
</table>

这个示例减少了表格层级,但仍需测试它是否符合实际邮件的排版要求,以及能否解决目标环境中的漏读,不能将其视为已验证的修复。

注意事项

外层表格表达商品、数量和金额之间的数据关系,应保留 <thead> 和 <th scope="col">。不要为了解决内层布局问题,也给外层 data table 添加 role="presentation"。

role="none" 与 role="presentation" 是规范中的同义角色。改用另一个名称没有语义上的修复依据,也不能保证避开实现问题。WAI-ARIA:none role

如果准备提交缺陷报告,应附上最小邮件样例、macOS、Mail 和 Chrome 的版本,以及准确的 VoiceOver 操作步骤。规范要求保留内容;要确认是否属于已知缺陷、判断由哪个组件造成,还需要这些复现证据。

备注:内容仅供参考。