검색: 사양
검색을 사용하면 키워드나 문구를 입력해 관련 정보를 찾을 수 있습니다.
변형
| 변형 | M3 | M3 익스프레시브 |
|---|---|---|
| 검색 | 활성화 | 활성화 |
구성
스타일
검색은 다음 두 가지 스타일로 제공됩니다:
- 컨테인드: 익스프레시브한 외관과 느낌을 제공합니다. 채워진 컨테이너를 사용해 검색 바를 제안 또는 결과 목록과 분리합니다.
- 분할형(기준선): 최신 시각 스타일, 모션, 유연성을 갖추지 않습니다.


레이아웃
검색 제안과 결과는 사용자 지정 가능한 목록에 표시되며, 전체 화면과 도크형이라는 두 가지 레이아웃 옵션이 있습니다. 검색 레이아웃 자세히 보기




| 카테고리 | 구성 | M3 | M3 익스프레시브 |
|---|---|---|---|
| 스타일 | 컨테인드 | -- | 활성화 |
| 분할형 | 활성화 | 권장하지 않음. 컨테인드 사용. | |
| 레이아웃 | 도크형, 전체 화면 | 활성화 | 활성화 |
토큰 및 사양
표의 메뉴에서 토큰 세트를 선택하세요. 검색 바 세트에는 포커스되지 않은 검색 바의 토큰만 포함됩니다. 검색 뷰 세트에는 모든 스타일과 레이아웃에서 검색과 상호작용할 때 사용되는 나머지 토큰이 모두 포함됩니다. 디자인 토큰 자세히 알아보기
검색 - 뷰
| Token | 값 |
|---|---|
| Search view container surface tint layer color | #6750A4 |
검색 - 바
구조
검색은 검색 바와 검색 제안 및 결과를 담는 컨테이너로 구성됩니다. 컨테이너는 기본적으로 비어 있습니다. 콘텐츠를 추가하려면 목록 컴포넌트를 사용하세요. 분할형(기준선) 스타일에서는 구분선이 검색 바와 결과 영역을 분리합니다.

- 검색 바 컨테이너
- 선행 아이콘
- 보조 텍스트
- 후행 아이콘 및 아바타(선택 사항)
- 입력 텍스트
- 검색 제안 또는 결과를 담는 컨테이너
예제
- 아바타가 있는 경우
- 후행 아이콘 버튼이 1개 있는 경우
- 후행 아이콘 버튼이 2개 있는 경우
- 후행 아이콘 버튼과 아바타가 있는 경우

색상
색상 값은 디자인 토큰을 통해 구현됩니다. 디자이너는 토큰에 대응하는 색상 값으로 작업하며, 구현 단계에서 색상 값은 특정 값을 참조하는 토큰으로 표현됩니다.
전체 화면 레이아웃

라이트 테마와 다크 테마에서 사용되는 전체 화면 검색 색상 역할:
- 표면 컨테이너 낮음
- 표면 변형 위
- 표면 변형 위
- 표면 컨테이너 높음
- 표면 변형 위
- 표면 위
도크형 레이아웃

라이트 테마와 다크 테마에서 사용되는 도크형 검색 색상 역할:
- 표면 컨테이너 높음
- 표면 변형 위
- 표면 변형 위
- 표면 컨테이너 높음
- 표면 변형 위
- 표면 위
상태
상태는 컴포넌트나 상호작용 요소의 현재 상태를 전달하는 시각적 표현입니다. 포커스된 검색에서는 개별 요소가 자체 상호작용 상태를 유지합니다. 상호작용 상태 자세히 알아보기
검색 바

- 활성화됨
- 호버됨
- 포커스됨
- 눌림(리플)
검색 제안 및 결과
검색은 제안 및 결과를 담는 컨테이너를 포함합니다. 컨테이너는 기본적으로 비어 있습니다. 콘텐츠를 추가하려면 목록 컴포넌트를 사용하세요.

- 활성화됨
- 호버됨
- 포커스됨
- 눌림(리플)
측정값
검색 바


M3 익스프레시브에서 검색 바는 포커스되면 확장되며, 여백이 24dp에서 12dp로 변경됩니다.


| 요소 | 속성 | 값 |
|---|---|---|
| 컨테이너 | 너비 | 최소: 360dp, 최대: 720dp |
| 높이 | 56dp | |
| 레이블 정렬 | 시작점 정렬 | |
| 선행 패딩 | 포커스 없음: 24dp, 포커스 시: 12dp | |
| 후행 패딩 | 포커스 없음: 24dp, 포커스 시: 12dp | |
| 선행 아이콘 및 레이블 패딩(탭 타겟 기준) | 4dp | |
| 레이블 및 후행 아이콘 패딩(탭 타겟 기준) | 4dp | |
| 아바타 | 크기 | 30dp |
포커스된 검색
컨테인드 스타일


| 요소 | 속성 | 값 |
|---|---|---|
| 전체 화면 컨테이너 | 너비 | 전체 너비 |
| 높이 | 전체 높이 | |
| 도크형 컨테이너 | 너비 | 최소: 360dp, 최대: 720dp |
| 높이 | 최소: 240dp, 최대: 화면 높이의 3분의 2 | |
| 검색 바 컨테이너 | 높이 | 56dp |
| 레이블 정렬 | 시작점 정렬 | |
| 선행 패딩 | 16dp | |
| 후행 패딩 | 16dp | |
| 선행 아이콘 및 레이블 패딩(탭 타겟 기준) | 4dp | |
| 선행 아이콘 및 레이블 패딩(탭 타겟 기준) | 4dp |
분할형 스타일

