9.3 屏幕阅读器适配

屏幕阅读器是视觉障碍用户访问数字内容的主要辅助工具，文档的语义化标记对屏幕阅读器的正确解读至关重要。

R-157 必须

表格必须使用正确的语义标记

技术文档中的数据表格必须使用正确的 HTML 语义标记，包括 <thead>、<tbody>、<th> 等元素。行标题使用 scope="row"，列标题使用 scope="col"。复杂表格应添加 <caption> 元素说明表格内容。正确的语义标记能帮助屏幕阅读器准确传达表格的结构和数据关系。

R-158 必须

避免使用纯图片传达关键信息

关键的技术信息（如操作步骤、配置参数、错误信息等）不得仅以图片形式呈现。所有包含文字信息的图片必须提供等效的替代文本或在图片下方提供完整的文字说明。截图中的关键操作步骤应同时以文字形式在正文中描述。

无障碍表格 HTML 标记示例

<table>
  <caption>系统配置要求</caption>
  <thead>
    <tr>
      <th scope="col">配置项</th>
      <th scope="col">最低要求</th>
      <th scope="col">推荐配置</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <th scope="row">操作系统</th>
      <td>Windows 10</td>
      <td>Windows 11</td>
    </tr>
    <tr>
      <th scope="row">内存</th>
      <td>8 GB</td>
      <td>16 GB</td>
    </tr>
  </tbody>
</table>

技巧

可使用 axe、WAVE 等工具检测网页文档的可访问性。axe 浏览器扩展可以自动扫描页面并报告可访问性问题，WAVE 则提供可视化的问题标注。建议在文档发布前使用这些工具进行检测，并修复所有严重级别（critical）和重要级别（serious）的问题。