목록: 사양
목록은 텍스트, 이미지 등의 항목을 세로 방향으로 연속 나열하는 인덱스입니다.
변형
익스프레시브 목록
더 유연한 스타일링, 강조된 선택 상태, 사용자 정의 가능한 슬롯을 지원하려면 익스프레시브 목록 변형을 사용하세요.

기준선 목록
기준선 목록은 여전히 사용할 수 있지만, 최신 시각 스타일, 선택 상태 표현, 슬롯 기능은 제공하지 않습니다.
웹에서 익스프레시브 목록은 기준선 목록을 기반으로 구현됩니다.

| 변형 | M3 | M3 Expressive |
|---|---|---|
| 목록(익스프레시브) | -- | 활성화 |
| 목록(기준선) | 활성화 | 권장하지 않음. 대신 익스프레시브 목록을 사용하세요. |
구성
스타일
표준 및 분할형 스타일은 외관상의 선택일 뿐이며 목록의 동작에는 영향을 주지 않습니다.

- 표준
- 분할형
목록 선택
목록에는 한 번에 하나의 선택 모드만 적용할 수 있습니다. 예를 들어 단일 작업 목록을 다중 선택 목록으로 바꿀 수는 있지만, 두 모드를 동시에 적용할 수는 없습니다.




목록 상호작용
목록이 지원하는 상호작용:

| 카테고리 | 구성 | M3 | M3 Expressive |
|---|---|---|---|
| 스타일 | 표준 | 사용 가능 | 사용 가능 |
| 분할형 | -- | 사용 가능 | |
| 선택 모드 | 단일 작업, 다중 작업, 단일 선택, 다중 선택 | 사용 가능 | 사용 가능 |
| 상호작용 | 확장, 스와이프\* | 사용 가능 | 사용 가능 |
* 스와이프하여 작업을 표시하는 상호작용은 Android Views에서만 사용할 수 있습니다
토큰 및 사양
표의 메뉴에서 토큰 세트를 선택하세요. 공통(Common) 세트는 기준선 토큰에 새로운 익스프레시브 모양과 크기를 결합한 것입니다. 확장(Expand) 세트에는 확장 상호작용용 토큰이 포함되어 있습니다. 디자인 토큰 자세히 알아보기
목록 - 공통
목록 - 확장
구조

컨테이너와 레이블 텍스트는 필수 요소입니다. 다른 모든 요소는 선택 사항입니다:
- 컨테이너
- 오버라인
- 레이블 텍스트
- 뒤쪽 텍스트
- 보조 텍스트
- 뒤쪽 아이콘
- 구분선
- 앞쪽 아바타
- 앞쪽 아이콘
- 앞쪽 미디어 - 이미지 또는 동영상
유연성 및 슬롯
M3 디자인 키트에는 유연한 항목 레이아웃을 설계하기 위한 사용자 정의 슬롯이 있는 목록이 포함되어 있습니다. 사용자 정의 목록은 앞쪽, 콘텐츠, 뒤쪽의 세 슬롯을 가진 컨테이너로 생각할 수 있습니다. 각 슬롯에는 서로 다른 요소를 넣을 수 있습니다.
슬롯 접근성
슬롯은 기본적으로 접근성 기능을 제공하지 않습니다. 다음 사항을 고려하세요:
- 요소는 목록의 규칙, 구조 및 상호작용 패턴을 따라야 합니다
- 표준 목록 항목 패딩을 사용하세요
- 터치 타깃 크기는 최소 48x48dp여야 합니다
- 특히 스크린 리더 사용자가 목록 항목을 탐색하기 어렵게 만드는 상호작용 요소를 추가하지 마세요

- 앞쪽 슬롯
- 콘텐츠 슬롯
- 뒤쪽 슬롯
WARNING
슬롯을 사용하려면 직접 작성하고 유지 관리해야 하는 사용자 정의 코드가 필요합니다
앞쪽 및 뒤쪽 슬롯은 콘텐츠 섹션보다 너비가 작아야 합니다.
1. 앞쪽 슬롯에는 다음이 포함될 수 있습니다:
- 시각적 요소: 아바타, 아이콘, 이미지 또는 동영상 썸네일
- 선택 컨트롤: 체크박스, 라디오 버튼 또는 스위치
- 사용자 정의 요소: 배지 또는 더 큰 이미지
2. 콘텐츠 슬롯은 너비가 가장 큰 슬롯이어야 하며 다음을 포함할 수 있습니다:
- 기본 콘텐츠: 레이블 텍스트, 보조 텍스트
- 선택적 추가 항목: 배지, 아이콘, 인라인 레이블 또는 추가 텍스트 요소
- 가독성을 유지하려면 긴 텍스트 줄을 피하세요
3. 뒤쪽 슬롯에는 다음이 포함될 수 있습니다:
- 작업 요소 또는 텍스트: 아이콘, 아이콘 버튼 또는 뒤쪽 텍스트
- 선택 컨트롤: 체크박스, 라디오 버튼 또는 스위치

선택 목록
선택 목록에서는 목록 항목당 하나의 선택 상호작용만 사용하세요.


색상
색상 값은 디자인 토큰을 통해 구현됩니다. 디자이너는 토큰에 연결된 색상 값으로 작업하며, 구현 시 색상 값은 특정 값을 참조하는 토큰이 됩니다. 디자인 토큰 자세히 알아보기

라이트 및 다크 테마에 사용되는 목록 색상 역할:
- 표면
- 표면 변형 위
- 표면 위
- 표면 변형 위
- 표면 변형 위
- 표면 변형 위
- 아웃라인 변형
- 기본 컨테이너
- 기본 컨테이너 위
- 표면 변형 위
상태
상태는 컴포넌트나 상호작용 가능한 요소의 현재 조건을 전달하는 시각적 표현입니다. 상호작용 상태 자세히 알아보기
기본 목록 항목

- 활성화됨
- 비활성화됨
- 호버
- 포커스
- 누름
- 드래그
선택된 목록 항목

- 활성화됨
- 비활성화됨
- 호버
- 포커스
- 누름
- 드래그
측정값

모양 모핑
목록 항목이 선택되면 활성 항목을 강조하기 위해 모서리 모양이 변경됩니다:
- 선택되지 않은 모서리 반경: 안쪽 4dp, 바깥쪽 16dp
- 선택된 모서리 반경: 16dp


목록(기준선)
기준선 목록 변형은 계속 사용할 수 있으며 기존 제품에서도 정상 동작합니다. 그러나 새 디자인에는 익스프레시브 목록 변형을 권장합니다.토큰 및 사양
기준선 목록 토큰은 공통(Common) 토큰 세트에 있습니다.
TIP
이 세트에는 몇 가지 익스프레시브 토큰도 포함되어 있습니다.
색상
색상 값은 디자인 토큰을 통해 구현됩니다. 디자이너는 토큰에 연결된 색상 값으로 작업하며, 구현 시 색상 값은 특정 값을 참조하는 토큰이 됩니다. 디자인 토큰 자세히 알아보기

라이트 및 다크 테마에 사용되는 목록 색상 역할:
- 표면
- 표면 위
- 표면 변형 위
- 표면 변형 위
- 표면 변형 위
- 아웃라인 변형
- 기본 컨테이너
- 기본 컨테이너 위
- 표면 변형 위
상태
상태는 컴포넌트나 상호작용 가능한 요소의 현재 조건을 전달하는 시각적 표현입니다.

- 활성화됨
- 비활성화됨
- 호버
- 포커스
- 누름
- 드래그
레이아웃
한 줄 목록


두 줄 목록


세 줄 목록


| 속성 | 값 |
|---|---|
| 레이블 정렬 | 중앙 |
| 높이가 88dp 이상인 경우 레이블 정렬 | 상단 |
| 레이블 왼쪽 패딩 | 16dp |
| 앞쪽 요소 정렬 (세로) | 중앙 |
| 높이가 88dp 이상인 경우 앞쪽 요소 정렬 (세로) | 상단 |
| 앞쪽 요소 왼쪽 패딩 | 16dp |
| 앞쪽 아이콘 정렬 (세로) | 상단 |
| 앞쪽 아이콘 위쪽 패딩 | 8dp |
| 높이가 88dp 이상인 경우 앞쪽 아이콘 위쪽 패딩 | 12dp |
| 뒤쪽 요소 정렬 (세로) | 중앙 |
| 높이가 88dp 이상인 경우 뒤쪽 요소 정렬 (세로) | 상단 |
| 뒤쪽 요소 왼쪽 패딩 | 16dp |
| 뒤쪽 요소 오른쪽 패딩 | 24dp |
| 구분선 위/아래 패딩 | 0dp |
| 터치 타깃 | 48dp |
| 구분선 전체 너비 | 100% |
| 구분선 들여쓰기 왼쪽 패딩 | 16dp |
| 구분선 들여쓰기 오른쪽 패딩 | 24dp |
구성
앞쪽 아바타

- 앞쪽 아바타 포함
- 앞쪽 아바타 및 뒤쪽 체크박스 포함
앞쪽 이미지 또는 썸네일

- 앞쪽 이미지 포함
- 앞쪽 이미지 및 뒤쪽 체크박스 포함
앞쪽 동영상

- 앞쪽 동영상 포함
- 앞쪽 동영상 및 뒤쪽 체크박스 포함
앞쪽 아이콘

- 앞쪽 아이콘 포함
- 앞쪽 아이콘 및 뒤쪽 체크박스 포함
텍스트만

- 텍스트만 사용
- 텍스트 및 뒤쪽 체크박스 포함
앞쪽 체크박스

- 앞쪽 체크박스 포함
- 앞쪽 체크박스 및 뒤쪽 텍스트 포함
앞쪽 라디오 버튼

- 앞쪽 라디오 버튼 포함
- 앞쪽 라디오 버튼 및 뒤쪽 텍스트 포함
뒤쪽 스위치

- 뒤쪽 스위치 포함
- 앞쪽 아이콘 및 뒤쪽 스위치 포함