Material Design 3
이 스킬은 Google의 Material Design 3 (MD3) — 개인화되고, 적응형이며, 표현력이 풍부한 디자인 시스템의 구현을 안내합니다. MD3는 동적 색상, 톤 서페이스, 둥근 모양, 스프링 기반 모션을 사용하여 생동감 있고 개인화된 UI를 만듭니다.
철학
MD3는 세 가지 원칙을 기반으로 합니다:
- 개인화(Personal): 동적 색상이 사용자의 배경화면이나 콘텐츠에 맞춰 UI를 자동으로 조정합니다. 테마는 개인별로 다르며, 획일적이지 않습니다.
- 적응형(Adaptive): 레이아웃이 5가지 창 크기 클래스에 따라 변형됩니다. 컴포넌트는 반응형으로 크기, 위치, 형태 요소를 변경합니다.
- 표현형(Expressive): 형태 변형, 스프링 물리학, 강조된 타이포그래피는 사용성을 해치지 않으면서 즐거운 순간을 만들어냅니다.
최신 업데이트: Google I/O 2026
Material의 Google I/O 2026 업데이트는 Compose 우선 Android 경로를 강화하고 표현형/적응형 가이드를 확장합니다:
- Material Android는 Compose 우선: 새로운 Android 작업에는 최신 컴포넌트, 표현형 API, 적응형 스캐폴드, 스타일 API 통합을 위해 Jetpack Compose Material3를 선호합니다. Android Views는 기존 앱에서 여전히 필요할 수 있지만, 새로운 Material 3 구현의 기본 경로로 간주되어서는 안 됩니다.
- 표현형 레이아웃 시스템: 표현형 레이아웃 스캐폴드를 사용하여 모바일, 데스크탑, 폴더블, 시계, XR 및 기타 공간 폼팩터에 맞게 화면을 조정합니다. 고정된 폰 우선 레이아웃 대신 적응형 스캐폴드/창 크기 클래스부터 시작하세요.
- 8dp 간격 시스템: 여백, 패딩, 갭에 간격 토큰을 적용하여 레이아웃과 컴포넌트가 기기 유형과 밀도에 따라 프로그래밍 방식으로 조정될 수 있도록 합니다.
- 새로운/업데이트된 표현형 컴포넌트: 리스트, 메뉴, 검색, 검색 앱 바에 표현형 가이드가 새롭게 업데이트되었으며, 주요 구현 대상은 Jetpack Compose입니다.
- 시계 및 XR: 시계는 물리 기반 모션, 아크 텍스트, 가장자리 컨테이너를 강조합니다. XR은 공간 패널과 깊이 기반 고도를 강조합니다.
MD2와의 주요 차이점:
- 톤 서페이스가 그림자 대신 주요 깊이 단서로 사용됨
- 동적 색상이 단일 시드 색상에서 전체 색상 구성표를 생성함
- 기본적으로 완전히 둥근 모서리 (약간 둥근 모서리가 아님)
- 스프링 기반 모션 물리학이 컴포넌트의 고정 이징 곡선을 대체함
- 사용자 제어 대비 3단계 (표준/중간/높음)
프론트엔드 디자인 스킬과의 관계: 두 스킬이 모두 활성화된 경우, MD3는 디자인 시스템(토큰, 컴포넌트, 레이아웃 규칙)을 제공하고 프론트엔드 디자인은 해당 제약 조건 내에서 창의적인 방향을 제공합니다. 컴포넌트 구조와 토큰 사용에 있어 MD3 규칙이 우선합니다. 참고: Roboto/Roboto Flex는 MD3의 올바른 기본 서체입니다. MD3 구현 시, Roboto를 피하라는 프론트엔드 디자인 가이드는 적용되지 않습니다.
의사 결정 트리
무엇을 구축하고 있습니까?
전체 앱 스캐폴드 → "일반 패턴: 앱 쉘" + 참조/references/layout-and-responsive.md 참조
단일 컴포넌트 → "컴포넌트 빠른 참조" 표 → 참조/references/component-catalog.md 참조
맞춤 테마 → 참조/references/theming-and-dynamic-color.md 참조
폼 / 입력 레이아웃 → 참조/references/component-catalog.md § 입력 컴포넌트 참조
내비게이션 구조 → 참조/references/navigation-patterns.md 참조
데이터 표시 → 참조/references/component-catalog.md § 데이터 표시 참조
어떤 플랫폼입니까?
Jetpack Compose → 기본: androidx.compose.material3, MaterialTheme, 참조/*
Flutter → ThemeData에서 useMaterial3: true, ColorScheme.fromSeed()
웹 (바닐라 JS) → @material/web (제한적; 유지보수 모드) + CSS 커스텀 속성
웹 (React/Vue/Svelte) → CSS 커스텀 속성 + 래퍼 컴포넌트 (공식 React 라이브러리 없음)
웹 (CSS 전용) → CSS 커스텀 속성으로 MD3 토큰 값 사용 (<md-*> 요소 없음)
디자인 토큰 시스템
모든 MD3 토큰은 md.sys 네임스페이스를 사용합니다. Jetpack Compose는 역할을 MaterialTheme.colorScheme, MaterialTheme.typography, MaterialTheme.shapes (사양과 동일한 의미론적 역할)에 매핑합니다. 웹에서는 이 토큰이 CSS 커스텀 속성 (--md-sys-*)에 매핑됩니다:
색상 토큰 (--md-sys-color-*)
| 토큰 | 목적 |
|---|---|
primary | 높은 강조도의 채움, 텍스트, 서페이스 위 아이콘 |
on-primary | primary 위 텍스트/아이콘 |
primary-container | 주요 컴포넌트(FAB 등)의 눈에 띄는 채움 |
on-primary-container | primary-container 위 텍스트/아이콘 |
secondary / on-secondary | 덜 두드러지는 악센트 |
secondary-container / on-secondary-container | 덜 중요한 컴포넌트 (토널 버튼) |
tertiary / on-tertiary | 대조 악센트 |
tertiary-container / on-tertiary-container | 보완 컨테이너 |
error / on-error | 오류 상태 (정적 — 동적 색상으로 변경되지 않음) |
error-container / on-error-container | 오류 컨테이너 채움 |
surface | 기본 배경 |
on-surface | 모든 서페이스 위 텍스트/아이콘 |
on-surface-variant | 서페이스 위 낮은 강조도 텍스트/아이콘 |
surface-container-lowest | 가장 낮은 강조도 컨테이너 |
surface-container-low | 낮은 강조도 컨테이너 |
surface-container | 기본 컨테이너 (내비게이션 영역) |
surface-container-high | 높은 강조도 컨테이너 |
surface-container-highest | 가장 높은 강조도 컨테이너 |
surface-dim / surface-bright | 라이트/다크에서 상대적 밝기 유지 |
inverse-surface / inverse-on-surface / inverse-primary | 대비 요소 (스낵바) |
outline | 중요한 경계 (텍스트 필드 테두리) |
outline-variant | 장식 요소 (구분선) |
자세한 내용: references/color-system.md
타이포그래피 토큰 (--md-sys-typescale-*)
| 스타일 | 크기 | 용도 |
|---|---|---|
| Display | L / M / S | 히어로 텍스트, 큰 숫자 |
| Headline | L / M / S | 섹션 헤더 |
| Title | L / M / S | 작은 헤더, 카드 제목 |
| Body | L / M / S | 단락 텍스트, 설명 |
| Label | L / M / S | 버튼, 칩, 캡션 |
각 스타일에는 -font, -weight, -size, -line-height, -tracking 토큰이 있습니다.
또한 --md-sys-typescale-emphasized-*를 통한 15개의 강조 변형 (더 높은 굵기)이 있습니다.
자세한 내용: references/typography-and-shape.md
쉐이프 토큰 (--md-sys-shape-corner-*)
| 토큰 | 값 | 예시 컴포넌트 |
|---|---|---|
none | 0dp | — |
extra-small | 4dp | 칩, 스낵바 |
small | 8dp | 텍스트 필드, 메뉴 |
medium | 12dp | 카드 |
large | 16dp | FAB, 내비게이션 드로어 |
large-increased | 20dp | (표현형) |
extra-large | 28dp | 대화상자, 바텀 시트 |
extra-large-increased | 32dp | (표현형) |
extra-extra-large | 48dp | (표현형) |
full | 9999px | 버튼, 칩, 배지 |
고도 레벨
| 레벨 | DP | 톤 오프셋 | 용도 |
|---|---|---|---|
| 0 | 0dp | 없음 | 평평한 표면, 정지 상태의 대부분 컴포넌트 |
| 1 | 1dp | +5% primary | 고도 카드, 모달 시트 |
| 2 | 3dp | +8% primary | 메뉴, 내비게이션 바, 스크롤된 앱 바 |
| 3 | 6dp | +11% primary | FAB, 대화상자, 검색, 날짜/시간 선택기 |
| 4 | 8dp | +12% primary | (호버/포커스 증가만) |
| 5 | 12dp | +14% primary | (호버/포커스 증가만) |
MD3의 고도는 그림자가 아닌 톤 서페이스 색상을 통해 전달됩니다. 그림자는 복잡한 배경에 대한 추가 보호가 필요한 경우에만 사용됩니다.
모션
MD3 Expressive (2025년 5월)은 컴포넌트에 스프링 기반 모션 물리학을 도입했습니다. 기존의 이징/지속 시간 시스템은 전환 (진입/퇴장/공유 축)에 여전히 사용됩니다:
| 이징 | 지속 시간 | 전환 유형 |
|---|---|---|
| Emphasized | 500ms | 화면에서 시작 및 종료 |
| Emphasized decelerate | 400ms | 화면 진입 |
| Emphasized accelerate | 200ms | 화면 퇴장 |
| Standard | 300ms | 화면에서 시작 및 종료 (유틸리티) |
| Standard decelerate | 250ms | 화면 진입 (유틸리티) |
| Standard accelerate | 200ms | 화면 퇴장 (유틸리티) |
CSS 이징 값:
- Emphasized:
cubic-bezier(0.2, 0, 0, 1) - Emphasized decelerate:
cubic-bezier(0.05, 0.7, 0.1, 1) - Emphasized accelerate:
cubic-bezier(0.3, 0, 0.8, 0.15) - Standard:
cubic-bezier(0.2, 0, 0, 1) - Standard decelerate:
cubic-bezier(0, 0, 0, 1) - Standard accelerate:
cubic-bezier(0.3, 0, 1, 1)
컴포넌트 빠른 참조
| 컴포넌트 | 웹 요소 | 주요 변형 | 카테고리 |
|---|---|---|---|
| Button | md-filled-button, md-outlined-button, md-text-button, md-elevated-button, md-filled-tonal-button | Filled, Outlined, Text, Elevated, Tonal; 5가지 크기 (XS–XL); 토글 | Actions |
| Button group | md-button-group | 표준, 연결됨 | Actions |
| Extended FAB | md-extended-fab | Surface, Primary, Secondary, Tertiary | Actions |
| FAB | md-fab | Small, Medium, Large | Actions |
| FAB menu | — | — | Actions |
| Icon button | md-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-button | 표준, Filled, Filled Tonal, Outlined | Actions |
| Segmented button | — | 단일 선택, 다중 선택 | Actions |
| Split button | — | — | Actions |
| Badge | — | Small (점), Large (숫자) | Communication |
| Loading indicator | — | 선형, 원형 | Communication |
| Progress indicator | md-linear-progress, md-circular-progress | 선형, 원형; 결정적/비결정적 | Communication |
| Snackbar | — | 한 줄, 두 줄, 액션 | Communication |
| Tooltip | — | 일반, 리치 | Communication |
| Card | — | Filled, Outlined, Elevated | Containment |
| Carousel | — | 멀티 브라우즈, 언컨테인드, 히어로 | Containment |
| Dialog | md-dialog | 기본, 전체 화면 | Containment |
| Bottom sheet | — | 표준, 모달 | Sheets |
| Side sheet | — | 표준, 모달 | Sheets |
| Divider | md-divider | 전체 너비, 삽입 | Containment |
| Checkbox | md-checkbox | — | Input |
| Chips | md-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chip | Assist, Filter, Input, Suggestion | Input |
| Date picker | — | Docked, Modal, Range | Input |
| Menu | md-menu, md-menu-item | — | Input |
| Radio button | md-radio | — | Input |
| Slider | md-slider | 연속형, 이산형, 범위형 | Input |
| Switch | md-switch | 아이콘 있음/없음 | Input |
| Text field | md-filled-text-field, md-outlined-text-field | Filled, Outlined | Input |
| Time picker | — | Docked, Modal | Input |
| App bar (top) | — | 가운데 정렬, Small, Medium, Large | Navigation |
| Navigation bar | md-navigation-bar | — | Navigation |
| Navigation drawer | md-navigation-drawer | 표준, 모달 | Navigation |
| Navigation rail | — | — | Navigation |
| Search | — | 검색 바, 검색 뷰 | Navigation |
| Tabs | md-tabs, md-primary-tab, md-secondary-tab | Primary, Secondary | Navigation |
| Toolbar | — | — | Navigation |
| List | md-list, md-list-item | 한 줄, 두 줄, 세 줄 | Data Display |
참고: 웹 요소가 —로 표시된 컴포넌트는 아직 @material/web 구현이 없습니다. 이러한 컴포넌트에는 표준 HTML과 함께 CSS 커스텀 속성을 사용하세요. Compose 매핑 및 예제는 references/component-catalog.md에 있습니다.
전체 컴포넌트 세부 정보 및 코드 예제: references/component-catalog.md
Jetpack Compose (기본)
androidx.compose.material3 를 MaterialTheme 및 Material 3 컴포저블 (Scaffold, Button, NavigationBar, 상단 앱 바 등)과 함께 사용하세요.
- 테마 설정:
MaterialTheme(colorScheme = …, typography = …, shapes = …). 동적 색상이 필요한 경우 Android 12+ (API 31+) 에서는dynamicLightColorScheme/dynamicDarkColorScheme을 선호하고, 그렇지 않은 경우lightColorScheme/darkColorScheme또는 Material Theme Builder에서 생성된 테마 코드를 사용하세요. - 적응형 UI: 창 크기 클래스, list-detail 및 supporting-pane 레이아웃, 폴더블 —
references/layout-and-responsive.md및references/navigation-patterns.md를 참조하세요. - Edge-to-edge 및 인셋:
WindowInsets/ 스캐폴드 패딩을 사용하여 콘텐츠를 배치하면 바와 IME가 올바르게 동작합니다. —references/layout-and-responsive.md를 참조하세요. - 실험적 API: 일부 Material 3 API는
@OptIn(ExperimentalMaterial3Api::class)또는 표현형 옵트인이 필요합니다. BOM과 컴파일러 버전을 일치시키세요.
MaterialTheme(
colorScheme = colorScheme, // dynamicLightColorScheme / lightColorScheme 등에서
typography = Typography(),
shapes = Shapes(),
) {
// M3 콘텐츠 — Scaffold, 내비게이션, 텍스트 필드는 참조 문서를 선호
}
웹 (제한적): @material/web
중요: Material Design 3 for Web에 따르면, Material Web Components는 유지보수 모드이며 M3 Expressive는 웹에서 구현되지 않았습니다. 적절한 경우 토큰 기반 웹 UI에 @material/web을 사용하되, 현재의 Expressive 기능에 있어 Compose와 동등하게 취급하지 마십시오.
설정
npm install @material/web
개별 컴포넌트 가져오기
항상 사용하는 컴포넌트만 가져오세요. 전체 패키지를 가져오면 번들이 비대해집니다:
// 좋은 예 — 개별 가져오기
import '@material/web/button/filled-button.js';
import '@material/web/button/outlined-button.js';
import '@material/web/textfield/outlined-text-field.js';
import '@material/web/icon/icon.js';
// 나쁜 예 — 절대 이렇게 하지 마세요
import '@material/web'; // 모든 것을 가져옴
기본 사용법
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<link href="https://fonts.googleapis.com/css2?family=Roboto+Flex:wght@400;500;700&display=swap" rel="stylesheet">
<link href="https://fonts.googleapis.com/icon?family=Material+Symbols+Outlined" rel="stylesheet">
</head>
<body>
<md-filled-button>시작하기</md-filled-button>
<md-outlined-text-field label="이메일" type="email"></md-outlined-text-field>
<script type="module">
import '@material/web/button/filled-button.js';
import '@material/web/textfield/outlined-text-field.js';
</script>
</body>
</html>
…
[전체 내용은 번역을 위해 생략됨]