버튼: 사양
버튼은 UI에서 대부분의 작업을 수행하는 데 사용됩니다.
변형

- 기본 버튼
- 토글 버튼
| 변형 | M3 | M3 Expressive |
|---|---|---|
| 기본 | 사용 가능 | 사용 가능 |
| 토글(선택) | -- | 사용 가능 |
구성

- 크기
- 모양
- 색상
- Small 버튼 패딩
| 카테고리 | 구성 | M3 | M3 Expressive |
|---|---|---|---|
| 크기 | Small (기본값) | 사용 가능 | 사용 가능 |
| XS, M, L, XL | -- | 사용 가능 | |
| 모양 | Round (기본값) | 사용 가능 | 사용 가능 |
| Square | -- | 사용 가능 | |
| 색상 | 엘리베이티드, 채워진(기본값), 토널, 아웃라인드, 텍스트 | 사용 가능 | 사용 가능 |
| Small 버튼 패딩 | 24dp | 사용 가능 | 권장되지 않음. 16dp 사용 |
| 16dp | -- | 사용 가능 |
토큰 및 사양
테이블의 메뉴를 사용하여 토큰 세트를 선택하세요. 버튼 토큰 세트는 공통 토큰, 색상, 크기로 구분됩니다. 기준선 토큰 보기
버튼 - 색상 - 엘리베이티드
버튼 - 색상 - 채워진
버튼 - 색상 - 토널
버튼 - 색상 - 아웃라인드
버튼 - 색상 - 텍스트
버튼 - 크기 - 초소형
| Token | 값 |
|---|---|
| Button xsmall container height | 32dp |
| Button xsmall outline width | 1dp |
| Button xsmall label font | Roboto |
| Button xsmall label line height | 20pt |
| Button xsmall label size | 14pt |
| Button xsmall label weight | 500 |
| Button xsmall label tracking | 0.1pt |
| Button xsmall icon size | 20dp |
| Button xsmall shape round | Circular |
| Button xsmall shape square | 12dp |
| Button xsmall leading space | 12dp |
| Button xsmall between icon label space | 4dp |
| Button xsmall trailing space | 12dp |
| Button xsmall shape pressed morph | 8dp |
| Button xsmall shape spring animation damping | 0.9 |
| Button xsmall shape spring animation stiffness | 1400 |
| Button xsmall selected container shape round | 12dp |
| Button xsmall selected container shape square | Circular |
버튼 - 크기 - 소형
| Token | 값 |
|---|---|
| Button small container height | 40dp |
| Button small outline width | 1dp |
| Button small label font | Roboto |
| Button small label line height | 20pt |
| Button small label size | 14pt |
| Button small label weight | 500 |
| Button small label tracking | 0.1pt |
| Button small icon size | 20dp |
| Button small shape round | Circular |
| Button small shape square | 12dp |
| Button small leading space | 16dp |
| Button small between icon label space | 8dp |
| Button small trailing space | 16dp |
| Button small shape pressed morph | 8dp |
| Button small shape spring animation damping | 0.9 |
| Button small shape spring animation stiffness | 1400 |
| Button small selected container shape round | 12dp |
| Button small selected container shape square | Circular |
버튼 - 크기 - 중형
| Token | 값 |
|---|---|
| Button medium container height | 56dp |
| Button medium outline width | 1dp |
| Button medium label font | Roboto |
| Button medium label line height | 24pt |
| Button medium label size | 16pt |
| Button medium label weight | 500 |
| Button medium label tracking | 0.15pt |
| Button medium icon size | 24dp |
| Button medium shape round | Circular |
| Button medium shape square | 16dp |
| Button medium leading space | 24dp |
| Button medium between icon label space | 8dp |
| Button medium trailing space | 24dp |
| Button medium shape pressed morph | 12dp |
| Button medium shape spring animation damping | 0.9 |
| Button medium shape spring animation stiffness | 1400 |
| Button medium selected container shape round | 16dp |
| Button medium selected container shape square | Circular |
버튼 - 크기 - 대형
| Token | 값 |
|---|---|
| Button large container height | 96dp |
| Button large outline width | 2dp |
| Button large label font | Roboto |
| Button large label line height | 32pt |
| Button large label size | 24pt |
| Button large label weight | 400 |
| Button large label tracking | 0 |
| Button large icon size | 32dp |
| Button large shape round | Circular |
| Button large shape square | 28dp |
| Button large leading space | 48dp |
| Button large between icon label space | 12dp |
| Button large trailing space | 48dp |
| Button large shape pressed morph | 16dp |
| Button large shape spring animation damping | 0.9 |
| Button large shape spring animation stiffness | 1400 |
| Button large selected container shape round | 28dp |
| Button large selected container shape square | Circular |
버튼 - 크기 - 초대형
| Token | 값 |
|---|---|
| Button xlarge container height | 136dp |
| Button xlarge outline width | 3dp |
| Button xlarge label font | Roboto |
| Button xlarge label line height | 40pt |
| Button xlarge label size | 32pt |
| Button xlarge label weight | 400 |
| Button xlarge label tracking | 0 |
| Button xlarge icon size | 40dp |
| Button xlarge shape round | Circular |
| Button xlarge shape square | 28dp |
| Button xlarge leading space | 64dp |
| Button xlarge between icon label space | 16dp |
| Button xlarge trailing space | 64dp |
| Button xlarge shape pressed morph | 16dp |
| Button xlarge shape spring animation damping | 0.9 |
| Button xlarge shape spring animation stiffness | 1400 |
| Button xlarge selected container shape round | 28dp |
| Button xlarge selected container shape square | Circular |
구조

- 컨테이너
- 레이블 텍스트
- 아이콘 (선택 사항)
색상
색상 값은 디자인 토큰디자인 토큰은 모든 UI 요소의 기본 구성 단위입니다. 동일한 토큰이 디자인, 도구, 코드에서 사용됩니다.토큰 자세히 알아보기으로 구현됩니다. 디자이너는 토큰에 대응하는 색상 값으로 작업하고, 실제 구현에서는 해당 값을 참조하는 토큰을 사용합니다.
- 기본으로 제공되는 버튼 색상 스타일은 엘리베이티드, 채워진, 토널, 아웃라인드, 텍스트의 다섯 가지입니다.
- 기본 버튼과 토글 버튼은 서로 다른 색상을 사용합니다.
- 토글 버튼은 텍스트 스타일을 사용하지 않습니다.
TIP
이러한 색상 역할은 디자인의 일관성과 익숙함을 위해 선택되었습니다. 컨테이너와 텍스트가 3:1 대비를 충족한다면 tertiary와 on tertiary 같은 다른 색상 역할도 사용할 수 있습니다.

A. 엘리베이티드, B. 채워진, C. 토널, D. 아웃라인드, E. 텍스트
- 기본
- 토글: 미선택
- 토글: 선택
| 1. 기본 | 2. 토글 미선택 | 3. 토글 선택 | |
|---|---|---|---|
| 엘리베이티드 컨테이너 엘리베이티드 아이콘 & 레이블 | 표면 컨테이너 낮음 기본 | 표면 컨테이너 낮음 기본 | 기본 기본 위 |
| 채워진 컨테이너 채워진 아이콘 & 레이블 | 기본 기본 위 | 표면 컨테이너 표면 변형 위 | 기본 기본 위 |
| 토널 컨테이너 토널 아이콘 & 레이블 | 보조 컨테이너 보조 컨테이너 위 | 보조 컨테이너 보조 컨테이너 위 | 보조 보조 위 |
| 아웃라인드 컨테이너 아웃라인드 아이콘 & 레이블 | 아웃라인 변형(아웃라인) 표면 변형 위 | 아웃라인 변형(아웃라인) 표면 변형 위 | 반전 표면 반전 표면 위 |
| 텍스트 아이콘 & 레이블 | 기본 | -- | -- |
상태
상태상태는 컴포넌트 또는 UI 요소의 상호작용 상태를 보여줍니다.상태 자세히 알아보기는 컴포넌트나 상호작용 요소의 현재 상태를 전달하는 시각적 표현입니다.엘리베이티드 버튼 상태
엘리베이티드 버튼 스타일의 엘리베이션 값은 기본 상태에서 1이며, 비활성화 상태에서는 0입니다.
기본

- 활성화
- 비활성화
- 호버
- 포커스
- 누름
토글

A. 미선택, B. 선택
- 활성화
- 비활성화
- 호버
- 포커스
- 누름
채워진 버튼 상태
기본

- 활성화
- 비활성화
- 호버
- 포커스
- 누름
토글

A. 미선택, B. 선택
- 활성화
- 비활성화
- 호버
- 포커스
- 누름
토널 버튼 상태
기본

- 활성화
- 비활성화
- 호버
- 포커스
- 누름
토글

A. 미선택, B. 선택
- 활성화
- 비활성화
- 호버
- 포커스
- 누름
아웃라인드 버튼 상태
아웃라인드 버튼의 컨테이너 채움은 기본 상태에서는 보이지 않습니다. 그러나 비활성화, 호버, 포커스, 누름 상태에서는 불투명도와 상태 레이어가 다른 버튼 스타일과 동일하게 동작합니다.
기본

- 활성화
- 비활성화
- 호버
- 포커스
- 누름
토글

- 활성화
- 비활성화
- 호버
- 포커스
- 누름
텍스트 버튼 스타일 상태
텍스트 버튼의 컨테이너는 기본 상태에서는 보이지 않습니다. 그러나 비활성화, 호버, 포커스, 누름 상태에서는 불투명도와 상태 레이어가 다른 버튼 스타일과 동일하게 동작합니다. 토글 텍스트 버튼은 없습니다.

- 활성화
- 비활성화
- 호버
- 포커스
- 누름
모양 모핑
누름 상태
버튼을 누르면 모양이 모핑되어 더 사각형에 가까워질 수 있습니다. 둥근 버튼과 사각형 버튼 모두 눌림 상태의 모양은 동일해야 합니다.
모서리 반경 값은 버튼 크기마다 다릅니다. 전체 버튼 모서리 치수 보기

A. 둥근 버튼, B. 사각형 버튼
- 활성화
- 호버
- 누름
선택 시
눌림 상태의 모양 변화 외에도, 토글 버튼은 기본 모양이 Round(미선택)에서 Square(선택)로 변경됩니다.
기본 미선택 모양이 Square인 경우, 선택된 모양은 Round여야 합니다.

A. 둥근 버튼, B. 사각형 버튼
- 활성화
- 호버
- 누름
- 선택
측정값

각 버튼 크기의 패딩 및 치수
- 초소형
- 소형
- 중형
- 대형
- 초대형
타겟 영역
초소형 및 소형 아이콘 버튼은 접근성을 위해 48x48dp 이상의 타깃 크기를 가져야 합니다.

A. 초소형 B. 소형
- 둥근 버튼
- 아이콘이 있는 버튼
- 사각형 버튼
모서리 크기

| XS | S | M | L | XL | |
|---|---|---|---|---|---|
| A. 둥근 버튼 | Full | Full | Full | Full | Full |
| B. 사각형 버튼 | 12dp | 12dp | 16dp | 28dp | 28dp |
| C. 누름 상태 | 8dp | 8dp | 12dp | 16dp | 16dp |
기준선 토큰
테이블의 메뉴를 사용하여 토큰 세트를 전환할 수 있습니다. 기준선 버튼 토큰 세트는 색상별로 구성되어 있습니다.