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

参照