Skip to content
Material Design 3
Main Navigation
v3
v2
v1

한국어

English
简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
Italiano
Polski
Türkçe
čeština
magyar

한국어

English
简体中文
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
Italiano
Polski
Türkçe
čeština
magyar

외관

Sidebar Navigation

기초

접근성

개요: 원칙

개요: 보조 기술

디자인: 개요

디자인: 색상 대비

디자인: 구조

디자인: 플로우

디자인: 요소

문구 작성과 텍스트: 모범 사례

글쓰기 및 텍스트: 텍스트 잘림

글쓰기 및 텍스트: 텍스트 크기 조정

모두를 위한 제품 만들기: 사용자 요구

모두를 위한 만들기: 공동 디자인

콘텐츠 디자인

개요

대체 텍스트

글로벌 글쓰기: 개요

글로벌 글쓰기: 단어 선택

알림

스타일 가이드: UX 라이팅 모범 사례

스타일 가이드: 단어 선택

스타일 가이드: 문법 및 구두점

Material 맞춤 설정

기기

워치용 디자인: 개요

워치 디자인: 기초

워치 디자인: 스타일

워치용 디자인: 레이아웃

XR

몰입형 XR을 위한 디자인: 개요

몰입형 XR 디자인: 상호작용

몰입형 XR 디자인: 레이아웃

몰입형 XR 디자인: 접근성

XR 컴포넌트: 개요

XR 컴포넌트: 앱 바

XR 컴포넌트: 대화상자

XR 컴포넌트: 내비게이션 바

XR 구성요소: 탐색 레일

XR 컴포넌트: 툴바

디자인 토큰: 개요

디자인 토큰: 토큰 사용 방법

상호작용

제스처

입력: 기초

선택: 개요

상태: 개요

상태: 상태 레이어

상태: 상태 적용

레이아웃

레이아웃 개요: 개요

레이아웃 개요: 레이아웃의 컴포넌트

레이아웃 개요: 적응형 디자인

스캐폴드: 개요

스캐폴드: 바

스캐폴드: 레일

스캐폴드: 페인

그리드와 간격: 개요

그리드 및 간격: 그리드

그리드 및 간격: 간격

그리드 및 간격: 밀도

브레이크포인트: 개요

브레이크포인트: 컴팩트

브레이크포인트: 중간

브레이크포인트: 확장형

브레이크포인트: 대형 및 초대형

양방향성 및 RTL

표준 레이아웃 예제: 개요

표준 레이아웃 예제: 피드

표준 레이아웃 예제: 목록-세부 정보

표준 레이아웃 예제: 보조 패널

사용성: 개요

사용성: M3 Expressive 적용

Material A-Z

스타일

색상

색상 시스템: 개요

색상 시스템: 작동 방식

색상 역할

색상 구성표

색상 구성표 선택

정적 색상 구성표: 기준선

정적 색상 구성표: 사용자 지정 브랜드

동적 색상 구성표: 소스 선택

동적 색상 구성표: 사용자 생성 소스

동적 색상 구성표: 콘텐츠 기반 소스

고급 사용자 지정: 개요

고급 사용자 지정: 색상 적용

고급 사용자 지정: 새 색상 정의

고급 사용자 지정: 기존 색상 조정

색상 리소스

엘리베이션: 개요

엘리베이션: 엘리베이션 적용

엘리베이션: 토큰

아이콘: 개요

아이콘: 아이콘 디자인

아이콘: 적용 방법

모션

모션 물리 시스템: 작동 방식

모션 물리 시스템: 명세

이징과 지속 시간: 이징과 지속 시간 적용

이징과 지속 시간: 토큰 및 사양

전환: 전환 패턴

전환: 전환 적용하기

모양: 개요 및 원칙

모양: 모서리 반경 스케일

모양: 모양 모핑

간격: 개요

간격: 간격 적용

간격: 토큰

타이포그래피: 개요

타이포그래피: 글꼴

타이포그래피: 타입 스케일 및 토큰

타이포그래피: 타입 적용

타이포그래피: 에디토리얼 트리트먼트

컴포넌트

앱 바: 개요

앱 바: 사양

앱 바: 가이드라인

앱 바: 접근성

배지: 개요

배지: 사양

배지: 가이드라인

배지: 접근성

버튼

모든 버튼

버튼 그룹: 개요

버튼 그룹: 사양

버튼 그룹: 가이드라인

버튼 그룹: 접근성

버튼: 개요

버튼: 사양

버튼: 가이드라인

버튼: 접근성

확장 FAB: 개요

확장 FAB: 사양

확장 FAB: 가이드라인

확장 FAB: 접근성

FAB 메뉴: 개요

FAB 메뉴: 사양

FAB 메뉴: 가이드라인

FAB 메뉴: 접근성

플로팅 작업 버튼 (FAB)(FAB): 개요

플로팅 작업 버튼 (FAB)(FAB): 사양

플로팅 작업 버튼 (FAB)(FAB): 가이드라인

플로팅 작업 버튼 (FAB)(FAB): 접근성

아이콘 버튼: 개요

아이콘 버튼: 사양

아이콘 버튼: 가이드라인

아이콘 버튼: 접근성

세그먼트 버튼: 개요

세그먼트 버튼: 사양

세그먼트 버튼: 가이드라인

세그먼트 버튼: 접근성

분할 버튼: 개요

분할 버튼: 사양

분할 버튼: 가이드라인

분할 버튼: 접근성

카드: 개요

카드: 사양

카드: 가이드라인

카드: 접근성

캐러셀: 개요

캐러셀: 사양

캐러셀: 가이드라인

캐러셀: 접근성

체크박스: 개요

체크박스: 사양

체크박스: 가이드라인

체크박스: 접근성

칩: 개요

칩: 사양

칩: 가이드라인

칩: 접근성

날짜 및 시간 선택기

날짜 선택기: 개요

날짜 선택기: 사양

날짜 선택기: 가이드라인

날짜 선택기: 접근성

시간 선택기: 개요

시간 선택기: 사양

시간 선택기: 가이드라인

시간 선택기: 접근성

대화상자: 개요

대화상자: 사양

대화상자: 가이드라인

대화상자: 접근성

구분선: 개요

구분선: 사양

구분선: 가이드라인

구분선: 접근성

목록: 개요

목록: 사양

목록: 가이드라인

목록: 접근성

로딩 및 진행 상태

로딩 표시기: 개요

로딩 표시기: 사양

로딩 표시기: 가이드라인

로딩 표시기: 접근성

진행 표시기: 개요

진행 표시기: 사양

진행 표시기: 가이드라인

진행 표시기: 접근성

메뉴: 개요

메뉴: 사양

메뉴: 가이드라인

메뉴: 접근성

내비게이션

내비게이션 바: 개요

내비게이션 바: 사양

내비게이션 바: 가이드라인

내비게이션 바: 접근성

내비게이션 드로어: 개요

내비게이션 드로어: 사양

내비게이션 드로어: 가이드라인

내비게이션 드로어: 접근성

탐색 레일: 개요

탐색 레일: 사양

탐색 레일: 가이드라인

탐색 레일: 접근성

라디오 버튼: 개요

라디오 버튼: 사양

라디오 버튼: 가이드라인

라디오 버튼: 접근성

검색: 개요

검색: 사양

검색: 가이드라인

검색: 접근성

시트

바텀 시트: 개요

바텀 시트: 사양

바텀 시트: 가이드라인

바텀 시트: 접근성

측면 시트: 개요

측면 시트: 사양

측면 시트: 가이드라인

측면 시트: 접근성

슬라이더: 개요

슬라이더: 사양

슬라이더: 가이드라인

슬라이더: 접근성

스낵바: 개요

스낵바: 사양

스낵바: 가이드라인

스낵바: 접근성

스위치: 개요

스위치: 사양

스위치: 가이드라인

스위치: 접근성

탭: 개요

탭: 사양

탭: 가이드라인

탭: 접근성

텍스트 필드: 개요

텍스트 필드: 사양

텍스트 필드: 가이드라인

텍스트 필드: 접근성

툴바: 개요

툴바: 사양

툴바: 가이드라인

툴바: 접근성

툴팁: 개요

툴팁: 사양

툴팁: 가이드라인

툴팁: 접근성

이 페이지에서

디자인 토큰: 개요 ​

디자인 토큰은 모든 UI 요소의 빌딩 블록입니다. 동일한 토큰을 디자인, 도구, 코드에서 공통으로 사용합니다.


  • 토큰은 색상, 글꼴, 치수와 같은 스타일 값을 나타냅니다
  • 하드코딩된 값 대신 디자인 토큰을 사용하세요
  • 각 토큰의 이름은 사용 방식이나 위치를 반영해 지정됩니다(예: md.comp.fab.기본.container.color는 FAB 컨테이너 색상을 설정합니다)
  • 토큰의 최종 값이 변경되더라도 이름과 용도는 그대로 유지됩니다
  • Material Design에는 참조, 시스템, 컴포넌트의 세 가지 토큰 클래스가 있습니다
디자인 목업, 코드 및 제품에서의 FAB 컨테이너 색상 토큰
하드코딩된 값 대신 디자인 토큰을 사용하면 디자인 시스템을 기반으로 제품을 구축, 유지 관리, 확장하는 과정이 간소화됩니다

리소스 ​

유형링크상태
디자인Design Kit (Figma)사용 가능
Material Theme Builder Figma 플러그인사용 가능
구현Material 기준선 테마 및 토큰 (DSP)사용 가능

디자인 토큰이란 무엇인가요? ​

디자인 토큰은 디자인 시스템의 시각적 스타일을 구성하는 작고 재사용 가능한 디자인 결정입니다. 토큰은 정적 값을 의미를 알 수 있는 이름으로 대체합니다.

디자인 토큰은 두 가지 요소로 구성됩니다.

  1. md.ref.palette.secondary90과 같은 코드 형태의 이름
  2. #E8DEF8과 같은 대응하는 값

토큰의 값은 색상, 글꼴, 치수 또는 다른 토큰일 수 있습니다.

라일락 색상 견본 #E8DEF8을 가리키는 화살표가 있는 토큰 md.ref.palette.secondary90.
참조 토큰과 해당 색상 값의 예

디자인 토큰은 서로 명확한 관계가 없을 수 있는 스타일 선택을 의미 있는 방식으로 연결합니다.

예를 들어 디자이너의 목업과 엔지니어의 구현이 모두 “secondary container color”(보조 컨테이너 색상)에 대한 동일한 토큰을 참조하면, 디자인과 구현 모두에서 같은 색상이 사용된다고 확신할 수 있습니다. 토큰에 할당된 16진수 값이 업데이트되어도 이 관계는 유지됩니다.

FAB의 시스템 토큰을 나타내는 다이어그램: 표면 색상에는 secondary, 아이콘 색상에는 on secondary
FAB의 컨테이너와 아이콘에 각각 할당된 secondary 및 on secondary 색상 역할 토큰의 예

토큰이 중요한 이유는 무엇인가요? ​

디자인 토큰을 사용하면 디자인 시스템에 신뢰할 수 있는 단일 출처, 즉 스타일 선택이 기록되고 변경 사항을 추적할 수 있는 저장소가 생깁니다.

토큰은 재사용 가능하고 목적에 맞게 설계되어 테마와 컨텍스트 전반에 시스템 전체 업데이트를 적용할 수 있습니다. 예를 들어 토큰을 사용해 가시성 향상을 위한 고대비 색상 팔레트를 체계적으로 적용하거나, TV 화면에서 텍스트 가독성을 확보하기 위해 타이포그래피 스케일을 변경할 수 있습니다.

디자인과 구현 모두에서 토큰을 사용하면 스타일 업데이트가 전체 제품 또는 제품군에 일관되게 반영됩니다. 또한 디자이너와 엔지니어가 “같은 언어를 사용”하게 하여 디자인에서 구현으로 인계하는 과정의 혼란을 줄입니다.

토큰 값 변경이 디자인 시스템에서 제품 영역 및 3개 제품으로 어떻게 연쇄되는지 보여주는 다이어그램
디자인 시스템이 발전함에 따라 일부 값이 변경됩니다. 디자인 토큰을 사용하면 변경 사항을 추적하고 제품 전반의 일관성을 보장할 수 있습니다.

토큰이 적합한지 결정하기 ​

토큰은 다음 경우에 가장 유용합니다:

  • 제품 디자인을 업데이트할 계획이거나 제품을 처음부터 개발하는 경우
  • 디자인 시스템이 여러 제품 또는 플랫폼에 적용되는 경우
  • 앞으로 스타일을 쉽게 유지 관리하거나 업데이트하려는 경우
  • 동적 색상과 같은 기능을 포함해 Material Design 시스템을 최대한 활용하려는 경우

토큰의 효과가 크지 않은 경우:

  • 하드코딩된 값을 사용하는 기존 앱이 있고 향후 1~2년 안에 변경될 가능성이 낮은 경우
  • 제품에 디자인 시스템이 없는 경우

토큰과 Material Design ​

과거에는 Material 스타일이 가이드라인, 디자인 파일, 도구, 플랫폼별 컴포넌트 라이브러리를 통해 제공되었습니다.

이제 디자인 토큰을 사용하면 Material 스타일을 다운로드하고 사용자 지정하고 적용하여 디자인 및 개발 프로세스 전반에 통합할 수 있습니다.

토큰을 사용하면 디자인 결정을 플랫폼 중립적이고 공유 가능한 형식으로 문서화할 수 있습니다.

디자인 도구 및 플랫폼 코드와 연결된 디자인 토큰 다이어그램
디자인 토큰은 디자인 결정을 위한 중앙 저장소를 제공하며, 엔지니어와 디자이너를 위한 다양한 통합 지점을 갖습니다

이 사이트에서는 대화형 모듈에 나열된 토큰을 확인할 수 있습니다.

이 모듈을 사용하면 토큰이 색상, 글꼴, 글꼴 크기, 글꼴 굵기 등에 대해 저장하는 기본값을 빠르게 조회할 수 있습니다. 또한 역할, 해당 시스템 토큰, 참조 토큰, 저장된 사전 설정값 간의 관계를 보여줍니다.

기본 색상 세트에 대한 4개의 색상 견본이 있는 색상 시스템용 토큰 모듈.
토큰 모듈의 예

컴포넌트 문서의 사양 탭에서도 토큰을 확인할 수 있습니다.

토큰은 먼저 상태(활성, 비활성, 호버 등)별로 그룹화된 다음 요소별로 그룹화됩니다. 요소는 토큰이나 값이 적용되는 컴포넌트의 일부이며, 컨테이너 또는 레이블 텍스트 등이 여기에 해당합니다.

열의 구성은 다음과 같습니다:

  • 이름 – 색상이나 글꼴처럼 토큰이 적용되는 컴포넌트 스타일 속성
  • 토큰 ID – 컴포넌트 스타일 속성을 정의하는 토큰
  • 설명 – 추가 설명(선택 사항)
  • 컨텍스트/값 – 특정 컨텍스트에서 토큰에 저장된 값
상태(활성, 비활성 등)별로, 그다음 요소(컨테이너, 레이블 텍스트)별로 구성된 엘리베이티드 버튼의 토큰 모듈.
엘리베이티드 버튼의 다이어그램 및 토큰 모듈

토큰 모듈 사용 방법

채워진 버튼의 레이블 텍스트에 사용되는 색상 역할을 확인해야 한다고 가정해 보겠습니다.

공통 버튼 > 사양으로 이동해 채워진 버튼의 토큰 모듈을 찾은 다음, 요소 아래에서 “레이블 텍스트” 토큰을 검색하세요.

색상 토큰을 복사해 코드에 붙여넣거나 Figma의 색상 역할과 비교하세요.

레이블 텍스트 색상 토큰을 찾는 방법.
채워진 버튼 레이블 색상의 다이어그램 및 토큰 표

토큰 이름의 컴포넌트 ​

토큰 이름의 각 부분은 마침표로 구분되며, 가장 일반적인 정보(“md”)에서 가장 구체적인 정보(“on-secondary”) 순으로 이어집니다.

  1. 디자인 시스템의 모든 토큰 이름은 시스템 이름(예: Material Design의 “md”)으로 시작합니다
  2. 토큰 클래스 약어: 참조 토큰은 “ref”, 시스템 토큰은 “sys”, 컴포넌트 토큰은 “comp”입니다
  3. 토큰 이름은 토큰의 역할을 나타내는 설명 단어로 끝납니다
디자인 토큰 이름의 3가지 컴포넌트 다이어그램: 시스템 접두사, 토큰 유형, 역할 설명
  1. 디자인 시스템을 나타냅니다
  2. 토큰 클래스를 나타냅니다
  3. 토큰의 목적을 나타냅니다

토큰 클래스 ​

Material에는 세 가지 토큰 클래스가 있습니다:

  1. 참조 토큰
    대응하는 값이 있는 사용 가능한 모든 토큰입니다.
  2. 시스템 토큰
    색상과 타이포그래피부터 엘리베이션(높이)과 모양까지, 디자인 시스템에 고유한 특성을 부여하는 결정과 역할입니다.
  3. 컴포넌트 토큰
    버튼 아이콘의 색상처럼 컴포넌트 요소에 할당된 디자인 속성입니다.

세 가지 토큰 클래스를 사용하면 팀은 디자인 결정을 전역적으로 업데이트하거나 단일 컴포넌트에 변경 사항을 적용할 수 있습니다.

참조 토큰에 저장된 색상 값이 시스템 토큰에 저장되고, 컴포넌트 토큰에 저장되어 FAB의 컨테이너 색상으로 나타나는 모습
확장 가능한 색상 값을 정의하는 세 가지 토큰 체계로 컨테이너 색상이 지정된 버튼입니다. 색상 토큰은 특정 16진수 값을 가리키므로 토큰 이름 체계를 바꾸지 않고도 값을 쉽게 변경할 수 있습니다.

참조 토큰

이 토큰은 디자인 시스템에서 사용 가능한 모든 스타일 옵션을 구성합니다.

일반적으로 16진수 색상 코드나 글꼴 크기와 같은 정적 값을 가리키지만, 다른 참조 토큰을 가리킬 수도 있습니다. 참조 토큰은 컨텍스트에 따라 값이 변경되지 않습니다.

참조 토큰은 옵션 목록을 제공하여 팀에 승인된 색상, 타이포그래피, 치수 등의 시작점을 제시합니다.

모든 참조 토큰은 접두사 ref로 시작합니다.

#E8DEF8을 가리키는 토큰 md.ref.palette.secondary90. Roboto Medium을 가리키는 토큰 md.ref.typeface.plain-medium
색상 및 타이포그래피 참조 토큰과 해당 값

시스템 토큰

시스템 토큰은 특정 테마나 컨텍스트에 맞게 디자인 언어를 체계화하는 결정입니다.

시스템 토큰은 참조 토큰이 UI에서 수행하는 역할을 정의합니다.

테마 설정은 시스템 토큰에서 이루어집니다. 시스템 토큰은 라이트 테마 또는 다크 테마와 같은 컨텍스트에 따라 서로 다른 참조 토큰을 가리킬 수 있습니다.

가능한 경우 시스템 토큰은 정적 값이 아닌 참조 토큰을 가리켜야 합니다.

모든 시스템 토큰은 접두사 sys로 시작합니다.

#E8DEF8을 가리키는 토큰 md.ref.palette.secondary90을 가리키는 시스템 토큰 md.sys.color.secondary-container. Roboto Medium을 가리키는 토큰 md.ref.typeface.plain-medium을 가리키는 시스템 토큰 md.sys.typescale.label-medium.font
시스템 토큰, 참조 토큰 및 해당 값

컴포넌트 토큰(개발 중) ​

컴포넌트 토큰은 컴포넌트를 구성하는 요소(예: 컨테이너, 레이블 텍스트, 아이콘, 상태)와 해당 요소의 값(예: 크기, 모양, 색상, 엘리베이션)을 나타냅니다.

가능한 경우 컴포넌트 토큰은 시스템 또는 참조 토큰을 가리켜야 하며, 16진수 코드와 같은 하드코딩된 값을 포함하지 않아야 합니다.

컴포넌트의 모든 스타일 선택을 토큰으로 표현할 수 있는 것은 아니지만, 유사한 용도의 여러 컴포넌트에 동일한 디자인 선택을 적용할 때는 토큰을 사용해야 합니다.

모든 컴포넌트 토큰은 접두사 comp로 시작합니다.

컨테이너 색상 및 레이블 텍스트에 대한 확장 FAB 컴포넌트 토큰이 시스템 토큰을 가리키고, 참조 토큰을 가리키고, 최종 결정된 값을 가리키는 모습
컴포넌트 토큰, 시스템 토큰, 참조 토큰 및 해당 값

컨텍스트 ​

토큰은 조건에 따라 서로 다른 값을 가리킬 수 있습니다. 이러한 조건을 컨텍스트라고 하며, 컨텍스트에 따라 결정되는 값을 컨텍스트 값(contextual value)이라고 합니다.

다양한 컨텍스트의 예로는 기기 폼 팩터, 다크 테마, 고밀도 레이아웃, RTL(오른쪽에서 왼쪽) 쓰기 체계가 있습니다.

컨텍스트는 일종의 태그로 생각할 수 있습니다. 토큰 값에 다크 테마 태그가 있으면, 다크 테마 컨텍스트에서 해당 값이 기본 토큰 값을 재정의합니다.

테마 컨텍스트에 따라 서로 다른 값을 가리키는 배경색용 시스템 토큰 다이어그램
배경색에 대한 동일한 시스템 토큰은 컨텍스트(라이트 테마 또는 다크 테마)에 따라 서로 다른 참조 토큰을 가리킬 수 있습니다
Pager
이전XR 컴포넌트: 툴바
다음디자인 토큰: 토큰 사용 방법

Apache 2.0 라이선스 또는 CC BY 4.0 하에 배포되었습니다.

Copyright © 2018-Present Google

https://m3.material.io/foundations/design-tokens/overview

Apache 2.0 라이선스 또는 CC BY 4.0 하에 배포되었습니다.

Copyright © 2018-Present Google