Alternative Text
替代文本
替代文本会在用户看不到图片时,说明图片的重要信息。内容应符合图片在该页面的用途。
另一个例子
天气图表的替代文本写着:“16:00 的降雨概率最高,为 70%。”装饰用的云纹使用空 alt。可点击的标志说明链接目标,而不是描述像素。
主要部分
- 01上下文中的用途
- 02简洁等价内容
- 03复杂数据替代
什么时候用
说明图片在页面场景中的意义。复杂图表或图解要用另一种形式提供相同数据。
什么时候不要用
不要用“一张……的图片”开头,也不要重复图注或描述没有信息的装饰。
代码里的名称
img alt, accessible name, or adjacent long-form equivalent 上线前要检查
发布前检查页面结构、键盘操作、清楚可见的焦点、对比度与缩放。也要检查加载、没有内容、错误、成功、取消与减少动态效果。
预期结果:使用 替代文本 (Alternative Text) 解决这项需求,同时保留用户当前的操作上下文。 用户场景:天气图表的替代文本写着:“16:00 的降雨概率最高,为 70%。”装饰用的云纹使用空 alt。可点击的标志说明链接目标,而不是描述像素。 建议界面模式:替代文本 (Alternative Text)。 适用理由:说明图片在页面场景中的意义。复杂图表或图解要用另一种形式提供相同数据。 不应使用的情况:不要用“一张……的图片”开头,也不要重复图注或描述没有信息的装饰。 产品要求:定义默认、加载、没有内容、错误、成功与恢复状态。保留用户已输入的内容,每个操作后都提供清楚反馈。 无障碍与韧性:使用结构正确的 HTML(语义化 HTML)和完整键盘操作。焦点要清楚可见,布局缩放后仍要好用。也要提供减少动态效果。遵守项目现有规则。除非项目已采用,否则不要新增界面组件库。 验收标准:主要任务可只用键盘完成,在 320px 宽度也能正常使用。焦点与状态变化可被辅助工具读出。加载、失败、重试、取消与减少动态效果都已验证。 证据与限制(证据边界):标准只涵盖列出的范围,不会替你决定外观、产品做法或 Vibulary 的教学示例。 待确认:产品文字、数据来源、分析事件、支持设备与语言,以及平台特有限制。
检查这份需求
请 AI 编程助手检查当前如何使用 替代文本 (Alternative Text)。 定义:替代文本会在用户看不到图片时,说明图片的重要信息。内容应符合图片在该页面的用途。 生产环境检查:发布前检查页面结构、键盘操作、清楚可见的焦点、对比度与缩放。也要检查加载、没有内容、错误、成功、取消与减少动态效果。 修改程序前,先列出看到的证据、缺口、严重程度,以及最小且安全的修正。