← Back to rules

jsx-a11y/anchor-ambiguous-text 제한

작동 방식

링크 텍스트에 모호한 단어가 사용되었는지 확인합니다.

이 규칙은 앵커 요소의 aria-label이 존재할 경우 그 내용을 검사합니다.
애너커 요소에 aria-label이 없으면 자식 요소의 다음 텍스트를 조합하여 확인합니다:

• aria-label이 존재할 경우
• 자식 요소가 이미지일 경우, alt 텍스트
• HTML 요소의 텍스트 콘텐츠

왜 문제가 되나요?

스크린 리더 사용자는 링크 텍스트를 맥락으로 의존합니다. "여기 클릭"과 같은 모호한 표현은 충분한 맥락을 제공하지 않습니다.

예시

이 규칙에 대해 잘못된 코드 예시:

<a>링크</a>
<a>여기 클릭</a>

이 규칙에 대해 올바른 코드 예시:

<a>이 튜토리얼 읽기</a>
<a aria-label="oxc 린터 문서">여기 클릭</a>

구성

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

words

type: string[]

기본값: ["여기 클릭", "여기", "링크", "링크", "자세히 보기"]

앵커 텍스트에서 경고해야 할 모호한 단어 또는 구문 목록입니다.

사용 방법

구성 파일 또는 명령줄 인터페이스를 통해 이 규칙을 활성화하려면 다음을 사용할 수 있습니다:

Config (.oxlintrc.json)

{
  "plugins": ["jsx-a11y"],
  "rules": {
    "jsx-a11y/anchor-ambiguous-text": "error"
  }
}

CLI

oxlint --deny jsx-a11y/anchor-ambiguous-text --jsx-a11y-plugin

참고 자료

• 규칙 소스