6.2 替代文本
本节规范了技术文档中图片替代文本(alt text)的编写要求,以满足无障碍访问标准。
R-120
必须
所有图片必须提供替代文本
技术文档中的所有图片元素都必须提供替代文本(alt text)。这是无障碍访问(Accessibility)的基本要求。替代文本使视觉障碍用户能够通过屏幕阅读器理解图片传达的信息。缺少替代文本的图片不符合 WCAG 2.1 AA 级合规要求。
R-121
推荐
替代文本应描述图片传达的信息
替代文本应描述图片所传达的关键信息,而非图片本身的外观。例如,对于一张显示错误提示的截图,替代文本应描述错误信息的内容,而不是「一个弹窗的截图」。替代文本长度建议不超过 125 个字符,如需更详细的描述,应使用长描述(longdesc)或在正文中补充说明。
替代文本写法对比
| 图片类型 | 好的替代文本 | 差的替代文本 |
|---|---|---|
| 截图 | 系统设置页面,「网络」选项卡处于选中状态 | 截图 |
| 图表 | 2024 年各季度用户增长趋势折线图,Q4 达到峰值 50 万 | 图表 |
| 装饰图 | (使用空的 alt 属性:alt="") | 蓝色横幅图片 |
| 图标 | 保存(用于描述保存功能的磁盘图标) | 图标 |