무료GitHub에 공개한국어 소개

aria-toggle-field-name

체크박스, 라디오 버튼, 스위치의 읽기용 이름을 점검합니다. 무엇을 선택하거나 켜고 끄는지 전달하도록 레이블 수정안을 제시하고 접근성 도구로 검증하는 방법을 설명합니다.

원문원문 설명 보기

Use when reviewing rendered HTML, interactive components, or design-system patterns related to Provide accessible names for toggle fields. Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output where relevant.

thedaviddias/Front-End-Checklist

AI 평가100점/ 100 설치 방법 보기

이럴 때 유용합니다

체크박스와 라디오 버튼 레이블 확인
스위치 이름이 목적을 전달하는지 점검
누락되거나 모호한 접근 가능한 이름 수정
접근성 도구와 음성 읽기로 레이블 검증

한국어 소개

할 수 있는 일

체크박스, 라디오 버튼, 스위치에 음성으로 읽었을 때 목적이 전달되는 이름이 있는지 확인합니다. 접근 가능한 이름은 보조 기술이 조작 요소를 식별할 때 사용하는 명칭입니다.

빈 레이블이나 의미가 모호한 이름을 찾아 <label>, aria-label, aria-labelledby를 이용한 수정안을 제시합니다. 대상 요소와 역할을 구체적으로 짚고 수정 후 확인 방법도 설명합니다.

이럴 때 유용합니다

설정 화면이나 입력 양식에서 무엇을 선택하고 무엇을 켜거나 끄는지 음성으로도 이해할 수 있는지 점검할 때 활용합니다. 공통 UI 컴포넌트나 디자인 시스템의 레이블을 검토할 때도 사용할 수 있습니다.

사용 예시

“이 양식의 체크박스와 라디오 버튼 이름을 확인해 주세요.”
“설정 스위치의 목적이 음성으로 전달되도록 레이블을 수정해 주세요.”

주의 사항

코드뿐 아니라 브라우저에서 렌더링된 HTML과 상호작용 상태도 확인하는 방침입니다. 표준 HTML 요소가 가진 의미를 먼저 확인하고 필요에 따라 키보드 조작과 포커스 이동도 점검합니다. 수정 결과는 브라우저 접근성 검사 기능이나 보조 기술로 검증합니다.

이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.

객관 평가

AI가 SKILL.md의 내용만을 근거로 4가지 관점에서 판정했습니다. 스타 수나 인기도는 판정에 넣지 않았습니다.

지시의 명확성언제 쓰고 무엇을 하는지 알 수 있는가: A양호체크박스, 라디오 버튼, 스위치의 이름을 점검하고 설명하는 레이블을 추가하도록 명시합니다.
절차의 구체성절차·입출력·예시가 구체적으로 적혀 있는가: A양호세 가지 레이블 지정 방식과 대상 요소 보고, 브라우저 도구나 보조 기술을 통한 검증을 지정합니다.
안전성전송·삭제·명령 실행 등을 명시하고 있는가: A양호조작 요소의 레이블 점검과 수정이 중심이며 삭제나 인증 정보 읽기를 지시하지 않습니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: A양호검증에 브라우저 접근성 도구나 보조 기술을 제시하며 API 키를 요구하지 않습니다.

총점은 각 항목을 A=25점, B=15점, C=5점으로 더한 값입니다. 2026년 10월 23일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.

평가가 다르다고 생각되면 재검토를 요청하기

포함된 파일(2)

SKILL.md1.8 KB
references/rule.md2.4 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Provide accessible names for toggle fields

Toggle fields like checkboxes and switches are unusable for screen reader users if they don't have a label, as the user won't know what they are turning on or off.

Quick Reference

Use aria-label, aria-labelledby, or <label> for checkboxes and radios
Ensure the label clearly describes the state or action of the toggle
Avoid empty or non-descriptive labels for switches

Check

Check all toggle fields (checkboxes, radio buttons, switches) for a valid accessible name.

Fix

Add an accessible name to the toggle field using a label element, aria-label, or aria-labelledby.

Explain

Explain why all interactive toggle controls must have descriptive names for users to understand their purpose.

Code Review

Review the rendered markup and interactive states that affect Provide accessible names for toggle fields. Flag exact elements, roles, labels, focus behavior, or keyboard interactions that violate the rule, and note how to verify the fix with browser accessibility tooling or assistive tech.

For full implementation details, code examples, and framework-specific guidance, see references/rule.md.

Rule page: https://frontendchecklist.io/rules/accessibility/aria-toggle-field-name

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬