목록: 접근성
목록은 텍스트와 이미지를 세로로 연속 배치한 항목 모음입니다.
사용 사례
사용자는 보조 기술을 사용해 다음 작업을 수행할 수 있어야 합니다:
- 목록 항목으로 이동
- 목록 항목 선택
색상 외의 방법으로 선택 상태 표시
선택된 항목을 모든 사용자가 명확히 인식할 수 있도록 색상만을 유일한 시각적 단서로 사용하지 마세요.
항목이 선택되었음을 나타내는 다음과 같은 추가 표시자를 함께 사용하세요:
- 라디오 버튼 또는 체크박스
- 선행 또는 후행 아이콘
- 밑줄이 그어진 텍스트처럼 색상에 의존하지 않는 시각적 스타일

상호작용 및 스타일
터치
사용자가 목록 항목을 탭하면 터치 리플이 표시되어 상호작용 피드백을 제공합니다.
커서
마우스를 올리면 호버 상태가 표시되어 목록 항목이 상호작용 가능함을 알리는 시각적 단서를 제공합니다.


키보드 및 스위치 기기
사용자가 Tab 키로 단일 동작 목록에 이동하면 포커스 표시자가 나타납니다. 이 표시자는 첫 번째 목록 항목이 이제 포커스를 받았으며 동작을 수행할 수 있음을 알리는 시각적 단서입니다.
포커스된 목록 항목에서 Space 또는 Enter 키를 누르면 해당 동작이 수행됩니다.
스와이프
스와이프 가능한 목록 항목에는 더 보기 아이콘처럼 숨겨진 동작에 접근할 수 있는 대체 방법이 포함되어야 합니다.
스와이프 대신 사용할 수 있는 방법은 다음과 같습니다:
- 단일 탭
- 더블 탭
- 길게 누르기
- 기타 단일 포인터 상호작용

포커스
단일 동작 목록
목록의 첫 번째 요소는 항상 포커스를 받아야 합니다. 단, 선택된 목록 항목이 있으면 해당 항목에 포커스가 지정되어야 합니다.
목록 항목이 포커스를 받으면 사용자는 화살표 키로 목록 내에서 탐색할 수 있어야 합니다.


모든 목록 항목은 Space 또는 Enter 키를 사용해 활성화할 수 있어야 합니다.

다중 동작 목록
다중 동작 목록 항목에는 기본 동작과 하나 이상의 추가 동작이 포함됩니다.
목록 항목 자체는 선택 대상이 아니며, 개별 동작만 선택할 수 있습니다.
사용자는 키보드를 사용해 다음을 수행할 수 있어야 합니다:
- Tab 키를 눌러 목록 항목으로 이동하면 첫 번째 요소에 포커스가 지정됩니다
- Up, Down, Left, Right 화살표 키로 목록 내 모든 포커스 가능 요소 사이를 이동할 수 있습니다
- Space 또는 Enter 키로 포커스된 요소를 활성화할 수 있습니다





키보드 탐색
| 키 | 동작 |
|---|---|
| Tab | 포커스를 목록의 첫 번째 또는 마지막 항목으로 이동하거나, 목록 컴포넌트 밖으로 이동합니다 |
| Down 및 Right 화살표 키 | 목록의 다음 요소로 이동합니다. 포커스된 요소가 목록의 마지막 요소이면 목록 맨 위로 돌아갑니다 |
| Up 및 Left 화살표 키 | 목록의 이전 요소로 이동합니다. 포커스된 요소가 목록의 첫 번째 요소이면 목록 맨 아래로 돌아갑니다 |
| Space 또는 Enter | 아직 선택되지 않은 목록 항목을 선택합니다 |
요소 레이블 지정
접근성 레이블은 스크린 리더와 같은 보조 기술에서 사용됩니다.
일반적으로 목록 항목의 접근성 레이블은 레이블 텍스트 및 보조 텍스트와 같습니다.
일부 레이블, 역할, 상태는 플랫폼에 따라 달라집니다.

플랫폼별 레이블
단일 선택 목록
| 특성 | 웹 | Android Views (MDC-Android) | Jetpack Compose |
|---|---|---|---|
| ARIA 레이블 | 컨테이너 레이블: 선택 유형을 설명해야 합니다 목록 항목: 화면에 표시되는 레이블 텍스트와 일치해야 합니다 | 목록 항목: 화면에 표시되는 레이블 텍스트와 일치해야 합니다 | 목록 항목: 화면에 표시되는 레이블 텍스트와 일치해야 합니다 |
| 역할 | 컨테이너: 목록 상자(List box), 목록 항목: 옵션(Option) | 목록 항목: 라디오 버튼 | 목록 항목: 라디오 버튼 |
| 상태 | 선택된 또는 선택되지 않음 | 체크됨 또는 체크되지 않음 | 체크됨 또는 체크되지 않음 |
다중 선택 목록
| 특성 | 웹 | Android Views (MDC-Android) | Jetpack Compose |
|---|---|---|---|
| ARIA 레이블 | 컨테이너 레이블: 선택 유형을 설명해야 합니다 목록 항목: 화면에 표시되는 레이블 텍스트와 일치해야 합니다 | 목록 항목: 화면에 표시되는 레이블 텍스트와 일치해야 합니다 | 목록 항목: 화면에 표시되는 레이블 텍스트와 일치해야 합니다 |
| 역할 | 컨테이너: 목록 상자(List box), 목록 항목: 옵션(Option) | 목록 항목: 체크박스 | 목록 항목: 체크박스 |
| 상태 | 선택된 또는 선택되지 않음 | 체크됨 또는 체크되지 않음 | 체크됨 또는 체크되지 않음 |
웹에서 목록 컨테이너의 접근성 레이블은 가능한 선택 유형을 설명하며, 역할은 목록 상자(List box)입니다.

Jetpack Compose에서는 역할이 목록 항목 전체에 적용됩니다.
목록을 선택할 수 없는 경우 스크린 리더는 역할 정보 없이 레이블 텍스트만 읽습니다.

