디자인 토큰: 개요
디자인 토큰은 모든 UI 요소의 빌딩 블록입니다. 동일한 토큰을 디자인, 도구, 코드에서 공통으로 사용합니다.
- 토큰은 색상, 글꼴, 치수와 같은 스타일 값을 나타냅니다
- 하드코딩된 값 대신 디자인 토큰을 사용하세요
- 각 토큰의 이름은 사용 방식이나 위치를 반영해 지정됩니다(예: md.comp.fab.기본.container.color는 FAB 컨테이너 색상을 설정합니다)
- 토큰의 최종 값이 변경되더라도 이름과 용도는 그대로 유지됩니다
- Material Design에는 참조, 시스템, 컴포넌트의 세 가지 토큰 클래스가 있습니다

리소스
| 유형 | 링크 | 상태 |
|---|---|---|
| 디자인 | Design Kit (Figma) | 사용 가능 |
| Material Theme Builder Figma 플러그인 | 사용 가능 | |
| 구현 | Material 기준선 테마 및 토큰 (DSP) | 사용 가능 |
디자인 토큰이란 무엇인가요?
디자인 토큰은 디자인 시스템의 시각적 스타일을 구성하는 작고 재사용 가능한 디자인 결정입니다. 토큰은 정적 값을 의미를 알 수 있는 이름으로 대체합니다.
디자인 토큰은 두 가지 요소로 구성됩니다.
- md.ref.palette.secondary90과 같은 코드 형태의 이름
- #E8DEF8과 같은 대응하는 값
토큰의 값은 색상, 글꼴, 치수 또는 다른 토큰일 수 있습니다.

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

토큰이 중요한 이유는 무엇인가요?
디자인 토큰을 사용하면 디자인 시스템에 신뢰할 수 있는 단일 출처, 즉 스타일 선택이 기록되고 변경 사항을 추적할 수 있는 저장소가 생깁니다.
토큰은 재사용 가능하고 목적에 맞게 설계되어 테마와 컨텍스트 전반에 시스템 전체 업데이트를 적용할 수 있습니다. 예를 들어 토큰을 사용해 가시성 향상을 위한 고대비 색상 팔레트를 체계적으로 적용하거나, TV 화면에서 텍스트 가독성을 확보하기 위해 타이포그래피 스케일을 변경할 수 있습니다.
디자인과 구현 모두에서 토큰을 사용하면 스타일 업데이트가 전체 제품 또는 제품군에 일관되게 반영됩니다. 또한 디자이너와 엔지니어가 “같은 언어를 사용”하게 하여 디자인에서 구현으로 인계하는 과정의 혼란을 줄입니다.

토큰이 적합한지 결정하기
토큰은 다음 경우에 가장 유용합니다:
- 제품 디자인을 업데이트할 계획이거나 제품을 처음부터 개발하는 경우
- 디자인 시스템이 여러 제품 또는 플랫폼에 적용되는 경우
- 앞으로 스타일을 쉽게 유지 관리하거나 업데이트하려는 경우
- 동적 색상과 같은 기능을 포함해 Material Design 시스템을 최대한 활용하려는 경우
토큰의 효과가 크지 않은 경우:
- 하드코딩된 값을 사용하는 기존 앱이 있고 향후 1~2년 안에 변경될 가능성이 낮은 경우
- 제품에 디자인 시스템이 없는 경우
토큰과 Material Design
과거에는 Material 스타일이 가이드라인, 디자인 파일, 도구, 플랫폼별 컴포넌트 라이브러리를 통해 제공되었습니다.
이제 디자인 토큰을 사용하면 Material 스타일을 다운로드하고 사용자 지정하고 적용하여 디자인 및 개발 프로세스 전반에 통합할 수 있습니다.
토큰을 사용하면 디자인 결정을 플랫폼 중립적이고 공유 가능한 형식으로 문서화할 수 있습니다.

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

컴포넌트 문서의 사양 탭에서도 토큰을 확인할 수 있습니다.
토큰은 먼저 상태(활성, 비활성, 호버 등)별로 그룹화된 다음 요소별로 그룹화됩니다. 요소는 토큰이나 값이 적용되는 컴포넌트의 일부이며, 컨테이너 또는 레이블 텍스트 등이 여기에 해당합니다.
열의 구성은 다음과 같습니다:
- 이름 – 색상이나 글꼴처럼 토큰이 적용되는 컴포넌트 스타일 속성
- 토큰 ID – 컴포넌트 스타일 속성을 정의하는 토큰
- 설명 – 추가 설명(선택 사항)
- 컨텍스트/값 – 특정 컨텍스트에서 토큰에 저장된 값

토큰 모듈 사용 방법
채워진 버튼의 레이블 텍스트에 사용되는 색상 역할을 확인해야 한다고 가정해 보겠습니다.
공통 버튼 > 사양으로 이동해 채워진 버튼의 토큰 모듈을 찾은 다음, 요소 아래에서 “레이블 텍스트” 토큰을 검색하세요.
색상 토큰을 복사해 코드에 붙여넣거나 Figma의 색상 역할과 비교하세요.

토큰 이름의 컴포넌트
토큰 이름의 각 부분은 마침표로 구분되며, 가장 일반적인 정보(“md”)에서 가장 구체적인 정보(“on-secondary”) 순으로 이어집니다.
- 디자인 시스템의 모든 토큰 이름은 시스템 이름(예: Material Design의 “md”)으로 시작합니다
- 토큰 클래스 약어: 참조 토큰은 “ref”, 시스템 토큰은 “sys”, 컴포넌트 토큰은 “comp”입니다
- 토큰 이름은 토큰의 역할을 나타내는 설명 단어로 끝납니다

- 디자인 시스템을 나타냅니다
- 토큰 클래스를 나타냅니다
- 토큰의 목적을 나타냅니다
토큰 클래스
Material에는 세 가지 토큰 클래스가 있습니다:
- 참조 토큰
대응하는 값이 있는 사용 가능한 모든 토큰입니다. - 시스템 토큰
색상과 타이포그래피부터 엘리베이션(높이)과 모양까지, 디자인 시스템에 고유한 특성을 부여하는 결정과 역할입니다. - 컴포넌트 토큰
버튼 아이콘의 색상처럼 컴포넌트 요소에 할당된 디자인 속성입니다.
세 가지 토큰 클래스를 사용하면 팀은 디자인 결정을 전역적으로 업데이트하거나 단일 컴포넌트에 변경 사항을 적용할 수 있습니다.

참조 토큰
이 토큰은 디자인 시스템에서 사용 가능한 모든 스타일 옵션을 구성합니다.
일반적으로 16진수 색상 코드나 글꼴 크기와 같은 정적 값을 가리키지만, 다른 참조 토큰을 가리킬 수도 있습니다. 참조 토큰은 컨텍스트에 따라 값이 변경되지 않습니다.
참조 토큰은 옵션 목록을 제공하여 팀에 승인된 색상, 타이포그래피, 치수 등의 시작점을 제시합니다.
모든 참조 토큰은 접두사 ref로 시작합니다.

시스템 토큰
시스템 토큰은 특정 테마나 컨텍스트에 맞게 디자인 언어를 체계화하는 결정입니다.
시스템 토큰은 참조 토큰이 UI에서 수행하는 역할을 정의합니다.
테마 설정은 시스템 토큰에서 이루어집니다. 시스템 토큰은 라이트 테마 또는 다크 테마와 같은 컨텍스트에 따라 서로 다른 참조 토큰을 가리킬 수 있습니다.
가능한 경우 시스템 토큰은 정적 값이 아닌 참조 토큰을 가리켜야 합니다.
모든 시스템 토큰은 접두사 sys로 시작합니다.

컴포넌트 토큰(개발 중)
컴포넌트 토큰은 컴포넌트를 구성하는 요소(예: 컨테이너, 레이블 텍스트, 아이콘, 상태)와 해당 요소의 값(예: 크기, 모양, 색상, 엘리베이션)을 나타냅니다.
가능한 경우 컴포넌트 토큰은 시스템 또는 참조 토큰을 가리켜야 하며, 16진수 코드와 같은 하드코딩된 값을 포함하지 않아야 합니다.
컴포넌트의 모든 스타일 선택을 토큰으로 표현할 수 있는 것은 아니지만, 유사한 용도의 여러 컴포넌트에 동일한 디자인 선택을 적용할 때는 토큰을 사용해야 합니다.
모든 컴포넌트 토큰은 접두사 comp로 시작합니다.

컨텍스트
토큰은 조건에 따라 서로 다른 값을 가리킬 수 있습니다. 이러한 조건을 컨텍스트라고 하며, 컨텍스트에 따라 결정되는 값을 컨텍스트 값(contextual value)이라고 합니다.
다양한 컨텍스트의 예로는 기기 폼 팩터, 다크 테마, 고밀도 레이아웃, RTL(오른쪽에서 왼쪽) 쓰기 체계가 있습니다.
컨텍스트는 일종의 태그로 생각할 수 있습니다. 토큰 값에 다크 테마 태그가 있으면, 다크 테마 컨텍스트에서 해당 값이 기본 토큰 값을 재정의합니다.
