장인 정신과 함께하는 접근성
접근성은 마지막에 덧붙이는 규정 준수 체크박스가 아니라, 인터페이스 장인 정신의 바닥입니다. 플랫폼을 사용한다면 대부분의 접근성은 공짜입니다: 네이티브 요소는 키보드 지원을 내장하고, 실제 레이블은 스스로를 알리며, 가시적인 포커스 링은 단 하나의 CSS 규칙입니다. UI 코드를 구축하거나 리뷰할 때 이 원칙들을 적용하고, 수정 사항을 적용할 때는 프로젝트의 기존 스타일 시스템(Tailwind, 일반 CSS, CSS-in-JS)과 일치시키십시오.
리뷰할 때는 먼저 키보드 전용 사용자로서 인터페이스를 탐색하고(모든 흐름이 마우스 없이 완료되어야 함), 그다음 스크린 리더 사용자로서 탐색하십시오: 각 컨트롤이 이름, 역할, 상태를 알리는가? 확실하지 않을 때는 커스텀 재구축보다 플랫폼 기본값을 선호하고, ARIA를 추가하기보다 제거하십시오.
렌더링된 쌍의 대비 측정 및 색상 교정은 better-colors 스킬에서 다루고, 시각적 텍스트 크기와 iOS 입력 확대/축소는 better-typography, 공간적 RTL 레이아웃은 better-layout에서 다룹니다.
빠른 참조
| 카테고리 | 사용 시기 |
|---|---|
| 포커스 및 키보드 | 포커스 링, 건너뛰기 링크, tabindex, 포커스 트래핑, APG 키보드 패턴 |
| 시맨틱 및 ARIA | 네이티브 요소 우선, 버튼 vs 링크, 랜드마크, 접근 가능한 이름, 비활성 상태 |
| 폼 | 레이블, 자동 완성, 오류 메시지, 입력 유형 |
| 스크린 리더 | 시각적으로 숨겨진 콘텐츠, 라이브 영역, 토스트, 대체 텍스트, SVG |
| 힛 영역 | 대상 크기, 힛 영역 확장, 충돌 규칙 |
| 모션 및 확대/축소 | prefers-reduced-motion, 자동 재생 및 시간 제한 UI, 200% 확대, 리플로우, rem vs px |
핵심 원칙
1. 네이티브 요소 우선
ARIA의 첫 번째 규칙: 네이티브 요소가 있을 때 ARIA를 사용하지 마십시오. 동작에는 <button>, 내비게이션에는 <a href> (Cmd/Ctrl/중간 클릭을 지원해야 함), 절대 <div onClick>을 사용하지 마십시오. 잘못된 ARIA보다 ARIA가 없는 것이 낫습니다.
2. 가시적인 포커스 링
bare :focus가 아닌 :focus-visible을 스타일링하여 키보드 사용자는 링을 얻고 마우스 사용자는 보통 얻지 못하게 하십시오. 브라우저의 수정되지 않은 포커스 표시기를 선호하십시오. 디자인에 커스텀 링이 필요한 경우, 프로젝트 포커스 토큰이나 다른 명시적인 색상을 사용하고, 완전한 표시기를 인접한 모든 색상과 비교하여 확인하십시오; currentColor는 동일한 확인 후에만 허용됩니다. 최소 2px 실선 둘레 또는 동등한 가시 영역을 사용하십시오. 검증된 대체 수단 없이 outline: none을 사용하지 말고, forced-colors 모드에서 시스템 색상을 보존하십시오.
3. 전체 키보드 지원
모든 포인터 상호작용에는 키보드 경로가 필요하며, ARIA APG 패턴을 따라야 합니다: Escape는 오버레이를 닫고, 화살표 키는 복합 위젯(탭, 메뉴, 목록 상자) 내에서 이동하며, Tab은 위젯 사이를 이동하고, Enter와 Space는 활성화합니다. tabindex="0" (자연 탭 순서에 합류)와 tabindex="-1" (프로그래매틱 포커스)만 사용하고, 자연 순서를 깨는 양수 값은 절대 사용하지 마십시오. 복합 위젯은 로빙 tabindex를 사용합니다: 활성 항목은 0, 나머지는 모두 -1입니다.
4. 포커스 트래핑 및 복원
모달은 배경 콘텐츠에 inert를 설정하고, 열 때 포커스를 내부로 이동시키고, 닫을 때 포커스를 트리거로 되돌립니다. 배경 콘텐츠가 스크롤되지 않도록 overscroll-behavior: contain을 추가하십시오.
5. 최소 힛 영역
WCAG 2.5.8의 Level AA 기준은 24×24 CSS 픽셀 대상 또는 정의된 간격, 동등 제어, 인라인, 사용자 에이전트, 필수 예외 중 하나입니다. 더 쉬운 활성화를 위해, 터치 맥락에서는 44×44px, 데스크톱 인터페이스에서는 밀도가 허용할 때 40×40px를 목표로 하십시오. 가시 요소를 더 작게 유지해야 한다면 의사 요소로 확장하십시오. 확장된 힛 영역이 겹치지 않도록 하십시오.
6. 모든 컨트롤에 레이블과 유형 지정
모든 입력에는 <label for> 또는 래핑 <label>이 있어야 합니다; 플레이스홀더는 레이블이 아니며, 레이블과 컨트롤은 하나의 힛 대상을 공유합니다: 체크박스와 텍스트 사이에 데드 존이 없어야 합니다. 의미 있는 name과 함께 autocomplete를 추가하고, 키보드에 맞는 올바른 type과 inputmode를 사용하십시오. 붙여넣기를 차단하지 마십시오; 사용자는 비밀번호와 일회용 코드를 붙여넣습니다.
7. 오류를 알리는 폼
요청이 시작될 때까지 제출을 활성화 상태로 유지하고, 그런 다음 스피너와 함께 비활성화하되 원래 레이블을 유지하십시오. 제출 시 검증: 실패한 필드를 aria-invalid="true"로 표시하고, aria-describedby를 인라인 오류 텍스트로 지정한 후 첫 번째 잘못된 필드에 포커스하십시오. 네이티브 컨트롤이 진정으로 사용 불가능한 경우 네이티브 disabled를 사용하십시오. 포커스 가능성이나 발견 가능성을 유지하려는 경우에만 aria-disabled="true"를 사용하십시오; 그런 다음 코드에서 포인터, 키보드, 폼 동작을 차단하고 상태를 명시적으로 스타일링하십시오.
8. 모든 곳에 접근 가능한 이름
아이콘 전용 버튼에는 설명적인 aria-label이 필요합니다. 보이는 레이블 텍스트는 접근 가능한 이름에 포함되어야 합니다. 장식적 요소는 aria-hidden="true"를 사용하고, 포커스 가능한 요소에는 절대 사용하지 마십시오.
9. 색상에만 의존하지 마십시오
상태에는 중복된 신호가 필요합니다: 색상과 함께 아이콘, 텍스트 또는 밑줄. 콘텐츠와 상태에 어떤 WCAG 대비 요구사항이 적용되는지 확인한 다음, better-colors를 사용하여 렌더링된 전경/배경 쌍을 측정하십시오. 대비가 실패하면, 쌍과 그것이 놓친 요구사항을 보고하십시오; 요청받지 않는 한 프로젝트의 색상을 변경하지 마십시오.
10. prefers-reduced-motion 존중
모션을 @media (prefers-reduced-motion: no-preference)로 감싸서 옵트인이 되게 하십시오. 모션 감소 아래에서는 슬라이드와 스케일을 불투명도 크로스페이드로 대체하고, 패럴랙스와 자동 재생을 완전히 없애십시오. 환경 설정과 무관하게: 자동 재생 미디어에는 가시적인 일시 정지 컨트롤이 필요하고, 액션이나 오류를 담은 토스트는 사용자가 닫을 때까지 유지됩니다.
11. 동적 콘텐츠 알리기
필드별 검증에는 aria-describedby를, 컨트롤에 묶이지 않은 토스트나 결과 개수 같은 긴급하지 않은 업데이트에는 공손한 라이브 영역(role="status")을, 컨트롤에 묶이지 않은 긴급 오류에만 role="alert"를 사용하십시오. 반복되는 공손한 알림을 안정적으로 전달하려면, 텍스트를 업데이트하기 전에 안정적인 빈 영역을 렌더링하십시오; 동적으로 삽입된 알림은 지원이 다르며 대상 스크린 리더로 테스트해야 합니다.
12. 목적에 따른 대체 텍스트
장식적 이미지는 alt="", 정보 제공 이미지는 의미를 설명하고, 기능적 이미지는 동작을 설명합니다: 검색 아이콘 버튼은 alt="돋보기"가 아니라 alt="검색"입니다.
13. 구조는 내비게이션이다
섹션을 설명하고 일관된 개요를 형성하는 제목을 사용하십시오; 하나의 페이지 수준 <h1>과 적절히 중첩된 수준이 권장되는 기본값이며, 독립적인 WCAG 통과/실패 규칙이 아닙니다. 하나의 가시적인 기본 <main> 랜드마크를 노출하십시오. 반복되는 내비게이션이나 크롬이 앞에 올 경우, "Skip to content" 링크를 첫 번째 포커스 가능한 요소로 만드십시오. 앵커가 있는 제목에는 scroll-margin-top을 추가하십시오.
14. 확대/축소 및 텍스트 크기 조정에 견디기
페이지는 200% 확대/축소와 320px 너비에서 수평 스크롤 없이 리플로우되어야 합니다. 텍스트 컨테이너에는 고정 height 대신 min-height를 사용하고, 코드베이스의 관례에 맞는 경우 rem 중단점을 선호하며, 뷰포트 메타가 사용자가 확대/축소할 수 있는 정도를 제한하지 않도록 하십시오.
일반적인 실수
| 실수 | 수정 |
|---|---|
포커스 링을 제거하기 위해 outline: none | :focus-visible을 대신 스타일링하십시오; 마우스 클릭 시 표시되지 않습니다 |
| 커스텀 포커스 색상이 모든 곳에서 작동한다고 가정 | 인접한 모든 색상 및 forced-colors 모드에서 완전한 표시기를 확인하십시오 |
버튼이나 링크에 <div onClick> | 동작에는 <button>, 내비게이션에는 <a href> |
| 유일한 레이블로 플레이스홀더 사용 | 가시적인 <label for>를 추가하십시오; 플레이스홀더는 입력 시 사라집니다 |
포커스 순서를 수정하기 위해 양수 tabindex | DOM 순서를 수정하십시오; 0과 -1만 사용하십시오 |
| 반복되는 공손한 업데이트가 일관되지 않게 알려짐 | 안정적인 빈 상태 영역을 유지하고 텍스트를 업데이트하십시오; 대상 스크린 리더를 테스트하십시오 |
일상적인 토스트에 assertive 라이브 영역 | polite를 사용하십시오; assertive는 오류용으로 남겨두십시오 |
포커스 가능한 요소에 aria-hidden="true" | 제거하거나 요소를 포커스 불가능하게 만드십시오 |
| 기능적 아이콘 alt가 그림을 설명 | 동작을 설명하십시오: alt="돋보기"가 아니라 alt="검색" |
| 폼이 유효할 때까지 제출 비활성화 | 활성화 상태로 유지하십시오; 제출 시 검증하고 첫 번째 오류에 포커스하십시오 |
리뷰 출력 형식
이 형식은 사용자가 독립적인 접근성 리뷰를 요청할 때만 사용하십시오. better-interface가 리뷰를 조정할 때는 해당 스킬에 도메인 증거와 결과를 제공하고, 그 출력 형식, 심각도 척도, 통합 규칙, 상한, 판정이 우선합니다.
독립적인 리뷰를 두 부분으로 제시하십시오.
발견 사항
확인된 모든 발견 사항을 원칙별로 그룹화하십시오. 심각도, 위치, 이전, 이후, 이유 열이 있는 마크다운 테이블을 사용하십시오. 별도의 "이전:" / "이후:" 줄을 절대 사용하지 마십시오.
- 심각도:
HIGH는 작업을 차단하거나, 보조 기술로부터 콘텐츠를 숨기거나, 시스템적인 접근성 실패를 만듭니다;MEDIUM은 상호작용을 의미 있게 어렵게 만듭니다;LOW는 고립된 개선 사항입니다. - 위치:
경로/파일:줄을 인용하십시오. 아티팩트에 소스 파일이 없는 경우, 정확한 화면과 컴포넌트를 대신 인용하십시오. - 이전 / 이후: 현재 구현과 실행 가능한 대체 수단을 보여주십시오.
- 이유: 위반된 원칙과 사용자 영향을 명시하십시오.
반복되는 시스템적 문제는 하나의 행으로 통합하고 영향을 받는 모든 위치를 나열하십시오. 발견 사항이 없는 원칙은 생략하십시오.
예시
모든 곳에 접근 가능한 이름
| 심각도 | 위치 | 이전 | 이후 | 이유 |
|---|---|---|---|---|
| HIGH | src/Dialog.tsx:42 | <button><XIcon /></button> | aria-label="닫기" 추가; 아이콘을 aria-hidden="true"로 표시 | 아이콘 전용 컨트롤에 접근 가능한 이름이 없음 |
| HIGH | src/Nav.tsx:18 | <a href="/settings"><GearIcon /></a> | aria-label="설정" 추가 | 링크 대상이 스크린 리더에 제공되지 않음 |
가시적인 포커스 링
| 심각도 | 위치 | 이전 | 이후 | 이유 |
|---|---|---|---|---|
| HIGH | src/button.css:12 | button:focus { outline: none; } | button:focus-visible { outline: 2px solid; outline-offset: 2px; } | 키보드 사용자가 포커스를 볼 수 없음 |
| HIGH | src/Menu.tsx:31 | focus:outline-none | focus-visible:outline-2 focus-visible:outline-offset-2 | 메뉴 내비게이션에 가시적인 포커스 표시기가 없음 |
오류를 알리는 폼
| 심각도 | 위치 | 이전 | 이후 | 이유 |
|---|---|---|---|---|
| HIGH | src/EmailField.tsx:27 | 오류가 border-red-500으로만 표시됨 | aria-invalid="true" + 인라인 오류 텍스트와 함께 aria-describedby="email-error" 추가 | 색상만으로는 오류를 설명하거나 알리지 않음 |
| MEDIUM | src/SignupForm.tsx:64 | 폼이 유효할 때까지 제출 비활성화 | 제출 활성화 유지; 실패 시 첫 번째 잘못된 필드에 포커스 | 비활성화된 동작은 무엇을 고쳐야 하는지 숨김 |
최소 힛 영역
| 심각도 | 위치 | 이전 | 이후 | 이유 |
|---|---|---|---|---|
| MEDIUM | src/Toolbar.tsx:22 | size-4 아이콘 전용 버튼 | after:absolute after:size-11로 힛 영역을 44×44px로 확장 | 대상이 신뢰할 수 있는 터치 입력에 비해 너무 작음 |
검증 및 판정
발견 사항 이후:
- 검증: 실행된 정확한 검사와 관찰된 결과(키보드 탐색, 접근 가능한 이름 검사, 스크린 리더 또는 자동화된 검사 등)를 나열하십시오. 검사가 실행되지 않은 경우, 여전히 검증이 필요한 사항을 명시하십시오.
- 판정:
HIGH발견 사항이 남아 있으면Block,MEDIUM또는LOW발견 사항만 남아 있으면Needs changes, 실행 가능한 발견 사항이 없을 때만Approve입니다.
발견 사항이 없으면 테이블을 생략하고, "실행 가능한 접근성 발견 사항 없음"을 명시하고, 검증을 보고한 후 Approve로 끝내십시오.