video-captions

该规则用于为视频内容提供字幕（captions），适用于所有 <video> 元素以及页面所有者可控内容范围内的第三方视频嵌入（YouTube、Vimeo）。含音频的预录视频需提供同步字幕，对应 WCAG 2.1 SC 1.2.2（AA）；含音频的直播视频需提供实时字幕，对应 WCAG 2.1 SC 1.2.4（AA）。字幕对失聪及听障用户是必需的，也有益于在声音敏感环境、无耳机公开场合观看的用户、非母语用户以及有听觉处理障碍的用户；缺失字幕在 ADA、EN 301 549 等法规下属于合规失败。检查方式：找出所有 <video> 元素与视频嵌入（来自 YouTube、Vimeo 的 <iframe>），对含音频的 <video> 检查是否存在 kind='captions' 且 src 指向有效 .vtt 文件的 <track> 子元素；确认至少一个 track 带有 default 属性使字幕默认开启（或记录默认关闭的体验理由）；对 YouTube/Vimeo 嵌入检查平台字幕开关是否可访问；并核实 .vtt 文件存在且有效（非空、非仅音乐提示）。修复方式：为缺少字幕的 <video> 创建含同步字幕文本的 WebVTT（.vtt）文件，内容需包含全部对话、多说话人场景的说话人标识，以及相关非语音声音描述（如 '[applause]'、'[upbeat music]'）；在 <video> 内添加 <track kind='captions' srclang='en' label='English' src='captions-en.vtt' default>；对自动生成字幕（YouTube、AI 工具）进行审核纠错，因其平均准确率约 80%，常在专有名词、技术术语和带口音语音上出错；直播则通过第三方字幕服务或 CART 实现实时字幕。注意 captions 与 subtitles 不同：字幕（captions）面向听障观众，必须包含非语音信息；subtitle 仅翻译对话。kind='subtitles' 不满足 SC 1.2.2。完整实现细节、代码示例与框架相关指导见 references/rule.md，规则页为 https://frontendchecklist.io/en/rules/accessibility/video-captions。