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[]

기본값: ["audio"]

<audio> 요소로 간주할 요소 이름

track

type: string[]

기본값: ["track"]

<track> 요소로 간주할 요소 이름

video

type: string[]

기본값: ["video"]

<video> 요소로 간주할 요소 이름

사용 방법

이 규칙을 설정 파일 또는 명령줄 인터페이스에서 활성화하려면 다음과 같이 사용할 수 있습니다:

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

참고 자료