← Back to rules

jsx-a11y/img-redundant-alt 정확성

작동 방식

img의 alt 속성에 "이미지", "사진", "그림"과 같은 중복되는 단어가 포함되지 않도록 강제합니다.

왜 문제인가요?

스크린 리더는 이미 img 요소를 이미지로 미리 알립니다. 따라서 alt 텍스트에 "이미지", "사진", "그림" 등의 단어를 사용할 필요가 없습니다. 이는 보조 기술을 사용하는 사용자에게 중복된 정보를 제공하고, alt 텍스트를 더 복잡하게 만들며 유용성을 떨어뜨립니다.

예시

이 규칙에 부적절한 코드 예시:

<img src="foo" alt="Foo가 이상한 모습을 보여주는 사진." />
<img src="bar" alt="내가 바에서 있는 이미지." />
<img src="baz" alt="Baz가 버그를 고치는 그림." />

이 규칙에 적절한 코드 예시:

<img src="foo" alt="Foo가 샌드위치를 먹는 모습." />
<img src="bar" aria-hidden alt="나의 사진을 찍는 이미지에 대한 그림" /> // 숨겨져 있으므로 통과됨.
<img src="baz" alt={`Baz가 ${photo}를 타고`} /> // 사진이 변수 이름이므로 유효함.

구성

이 규칙은 다음 속성을 가진 구성 객체를 수락합니다.

components

type: string[]

기본값: ["img"]

규칙이 적용되는 JSX 요소 유형(컴포넌트 이름). 예를 들어, ["img", "Image"].

words

type: string[]

기본값: ["이미지", "사진", "그림"]

alt 텍스트에서 중복으로 간주되어 경고를 발생시켜야 할 단어들.

사용 방법

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

구성 파일 (.oxlintrc.json)

{
  "plugins": ["jsx-a11y"],
  "rules": {
    "jsx-a11y/img-redundant-alt": "error"
  }
}

CLI

oxlint --deny jsx-a11y/img-redundant-alt --jsx-a11y-plugin

참고 항목

• 규칙 소스