# 沛云科技 · 图片替代文本（Alt Text）编写规范

> 编制：前端与内容团队　依据：WCAG 2.1 AA 相关成功准则（1.1.1 非文本内容、1.4.5 文字图片）
> 版本：v1.0（2026-08-01 首发，为投标整改专门制定）

---

## 一、核心原则

**替代文本的目的不是"描述图片长什么样"，而是"让看不到图的人获得同样的信息"。**

判断一条 alt 是否合格，只问一个问题：
**把图片换成这段文字，读者获得的信息是否等价？**

## 二、按图片类型分类处理（**最重要的一节**）

| 类型 | 判定 | **alt 怎么写** |
|---|---|---|
| **① 装饰性图片** | 移除后不损失任何信息（分隔线、背景纹理、纯装饰插画） | **`alt=""`（空 alt）** —— 让读屏工具直接跳过。**不是不写 alt 属性，是写一个空的。** |
| **② 信息性图片** | 承载正文没有的信息（图表、示意图） | 简明概括 **+ 关键数据**；复杂图另配长描述 |
| **③ 含文字的图片** | 图中有文字内容 | **必须把图中文字完整转录**；不得只写"一张写着营业时间的图" |
| **④ 功能性图片** | 图片本身是按钮或链接 | 写**它的功能与目标**，不写外观。如"下载 2025 年度报告 PDF"，**不是**"PDF 图标" |
| **⑤ 与邻近文字重复** | 图注或正文已完整表达图中信息 | **`alt=""`** 或极简，避免读屏重复朗读两遍 |
| **⑥ 人物照片** | 视上下文而定 | 只描述与内容相关的信息；**不描述外貌特征**；**未获授权不得写出姓名职务** |

## 三、长度与写法

1. **一般不超过 100 字**；超过说明该用长描述。
2. **不以"图片""一张图""图示"开头**——读屏工具已经会播报"图片"，重复冗余。
3. 不使用"点击这里""见下图"这类依赖视觉的表述。
4. 数据类图片：**趋势 + 关键数值 + 拐点**，不必逐点罗列。
5. 标点使用中文全角，数字与单位保留。

## 四、长描述（Long Description）

以下情况必须在 alt 之外另提供长描述（放在页面可见文字中，或通过可访问的展开区域提供）：

- 数据点较多的图表；
- 流程图、组织架构图等**关系型**图形；
- alt 无论如何压缩都超过 100 字的。

**长描述应包含完整数据或完整流程关系**，并放在页面上**所有人都能读到**的位置（不要藏起来只给读屏用）。

## 五、绝对禁止

| 禁止 | 原因 |
|---|---|
| 缺失 alt 属性 | 读屏工具会朗读文件名，如"图 4 客户服务时间含文字图 点 p n g" |
| 用文件名当 alt | 同上 |
| 装饰图写长 alt | 制造大量噪音，是无障碍体验最常见的破坏来源 |
| **图中信息只存在于图片里** | 违反 WCAG 1.4.5；**必须同时提供文字版本** |
| **描述图片中不存在的内容** | AI 识图常见问题；**每条 alt 必须逐项与原图核对** |
| 对人物外貌、年龄、体态的描述 | 与内容无关，且可能不当 |

## 六、人工核对要求

**AI 生成的 alt 一律视为初稿。** 发布前须由人：

1. 逐图打开原图，**核对 alt 中的每一个事实与数字**；
2. 确认没有编造图中不存在的元素；
3. 确认类型判定正确（尤其是装饰性与功能性两类）；
4. 含文字图片，**逐字核对转录是否完整**。

---

*本规范为虚构练习素材，不构成合规意见。*