Skip to content
← Back to rules

jsx-a11y/media-has-caption 正确性

它的作用

检查 <audio><video> 元素是否包含用于字幕的 <track> 元素。
这可确保所有用户(包括听力障碍者)都能访问媒体内容。

为什么这是问题?

如果没有字幕,聋人或听力困难的用户将无法访问音频和视频内容。
字幕对于嘈杂环境中的用户,或在无法播放音频的情况下也十分有用。

示例

此规则的 错误 代码示例:

jsx
<audio></audio>
<video></video>

此规则的 正确 代码示例:

jsx
<audio><track kind="captions" src="caption_file.vtt" /></audio>
<video><track kind="captions" src="caption_file.vtt" /></video>

配置

该规则接受一个配置对象,包含以下属性:

audio

type: string[]

default: ["audio"]

应视为 <audio> 元素的元素名称

track

type: string[]

default: ["track"]

应视为 <track> 元素的元素名称

video

type: string[]

default: ["video"]

应视为 <video> 元素的元素名称

如何使用

要通过配置文件或 CLI 启用 此规则,可以使用:

json
{
  "plugins": ["jsx-a11y"],
  "rules": {
    "jsx-a11y/media-has-caption": "error"
  }
}
bash
oxlint --deny jsx-a11y/media-has-caption --jsx-a11y-plugin

参考资料