Material Design 3
このスキルは、Google の Material Design 3(MD3) — パーソナルで、アダプティブで、エクスプレッシブな設計システムの実装をガイドします。MD3 は、ダイナミックカラー、トーナルサーフェス、丸みを帯びた形状、スプリングベースのモーションを使用して、生き生きとしてパーソナルな感覚の UI を作成します。
哲学
MD3 は3つの原則に基づいています:
- パーソナル: ダイナミックカラーは、ユーザーの壁紙やコンテンツに合わせて UI を適応させます。テーマ設定は個別化されており、一律ではありません。
- アダプティブ: レイアウトは5つのウィンドウサイズクラスにわたって変化します。コンポーネントは、レスポンシブにサイズ変更、再配置、フォームファクターの変更を行います。
- エクスプレッシブ: 形状のモーフィング、スプリング物理、強調されたタイポグラフィが、ユーザビリティを犠牲にすることなく、楽しさの瞬間を生み出します。
最新情報: Google I/O 2026
Material の Google I/O 2026 アップデート は、Compose ファースト の Android パスを強化し、エクスプレッシブ/アダプティブガイダンスを拡張します:
- Material Android は Compose ファースト: 新しい Android 開発では、最新のコンポーネント、エクスプレッシブ API、アダプティブスキャフォールド、Styles API 統合のために Jetpack Compose Material3 を推奨します。Android Views は既存のアプリで必要になる場合がありますが、新しい Material 3 実装のデフォルトパスとして扱うべきではありません。
- エクスプレッシブレイアウトシステム: エクスプレッシブレイアウトスキャフォールドを使用して、モバイル、デスクトップ、折りたたみデバイス、ウォッチ、XR、およびその他の空間フォームファクターにわたって画面を適応させます。固定の電話ファーストレイアウトではなく、アダプティブスキャフォールド/ウィンドウサイズクラスから始めます。
- 8dp スペーシングシステム: マージン、パディング、ギャップにスペーシングトークンを適用して、レイアウトとコンポーネントがデバイスタイプと密度に応じてプログラムで適応できるようにします。
- 新規/更新されたエクスプレッシブコンポーネント: リスト、メニュー、検索、検索アプリバーのエクスプレッシブガイダンスが更新され、Jetpack Compose が主要な実装ターゲットとなっています。
- ウォッチと XR: ウォッチは物理ベースのモーション、アークテキスト、エッジに沿ったコンテナを強調します。XR は空間パネルと深度ベースの標高を強調します。
MD2 との主な違い:
- トーナルサーフェスが、主要な奥行きの手がかりとして標高の影を置き換えます
- ダイナミックカラーが単一のシードカラーから完全なカラースキームを生成します
- デフォルトで完全に丸みを帯びたコーナー(わずかに丸いのではなく)
- スプリングベースのモーション物理が、コンポーネントの固定イージング曲線を置き換えます
- ユーザーが制御できる3レベルのコントラスト(標準/中/高)
フロントエンドデザインスキルとの関係: 両方のスキルがアクティブな場合、MD3 は設計システム(トークン、コンポーネント、レイアウトルール)を提供し、フロントエンドデザインはその制約内でクリエイティブな方向性を提供します。コンポーネント構造とトークンの使用法では、MD3 のルールが優先されます。注: Roboto/Roboto Flex は MD3 における正しいデフォルトタイプフェイスです — MD3 を実装する場合、Roboto を避けるというフロントエンドデザインのガイダンスは適用されません。
決定木
何を構築していますか?
完全なアプリスキャフォールド → 「共通パターン: アプリシェル」 + 参照/layout-and-responsive.md を参照
単一コンポーネント → 「コンポーネントクイックリファレンス」表 → 参照/component-catalog.md を参照
カスタムテーマ → 参照/theming-and-dynamic-color.md を参照
フォーム/入力レイアウト → 参照/component-catalog.md § 入力コンポーネントを参照
ナビゲーション構造 → 参照/navigation-patterns.md を参照
データ表示 → 参照/component-catalog.md § データ表示を参照
どのプラットフォームですか?
Jetpack Compose → プライマリ: androidx.compose.material3、MaterialTheme、参照/*
Flutter → ThemeData で useMaterial3: true、ColorScheme.fromSeed()
Web (vanilla JS) → @material/web(制限あり、メンテナンスモード)+ CSS カスタムプロパティ
Web (React/Vue/Svelte) → CSS カスタムプロパティ + ラッパーコンポーネント(公式 React ライブラリはなし)
Web (CSSのみ) → CSS カスタムプロパティとしての MD3 トークン値(<md-*> 要素なし)
設計トークンシステム
すべての MD3 トークンは md.sys 名前空間を使用します。Jetpack Compose はロールを MaterialTheme.colorScheme、MaterialTheme.typography、MaterialTheme.shapes にマッピングします(仕様と同じセマンティックロール)。Web 上では、これらは 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 | 装飾的な要素(区切り線) |
詳細: 参照/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の 強調 バリアント(より高い weight)があります。
詳細: 参照/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)
コンポーネントクイックリファレンス
| コンポーネント | Web Element | 主要なバリアント | カテゴリ |
|---|---|---|---|
| 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); トグル | アクション |
| Button group | md-button-group | Standard、Connected | アクション |
| Extended FAB | md-extended-fab | Surface、Primary、Secondary、Tertiary | アクション |
| FAB | md-fab | Small、Medium、Large | アクション |
| FAB menu | — | — | アクション |
| Icon button | md-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-button | Standard、Filled、Filled Tonal、Outlined | アクション |
| Segmented button | — | 単一選択、複数選択 | アクション |
| Split button | — | — | アクション |
| Badge | — | Small(ドット)、Large(カウント) | コミュニケーション |
| Loading indicator | — | 線形、円形 | コミュニケーション |
| Progress indicator | md-linear-progress, md-circular-progress | 線形、円形; 確定/不確定 | コミュニケーション |
| Snackbar | — | 一行、二行、アクション | コミュニケーション |
| Tooltip | — | Plain、Rich | コミュニケーション |
| Card | — | Filled、Outlined、Elevated | 格納 |
| Carousel | — | Multi-browse、Uncontained、Hero | 格納 |
| Dialog | md-dialog | Basic、Full-screen | 格納 |
| Bottom sheet | — | Standard、Modal | シート |
| Side sheet | — | Standard、Modal | シート |
| Divider | md-divider | Full-width、Inset | 格納 |
| Checkbox | md-checkbox | — | 入力 |
| Chips | md-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chip | Assist、Filter、Input、Suggestion | 入力 |
| Date picker | — | Docked、Modal、Range | 入力 |
| Menu | md-menu, md-menu-item | — | 入力 |
| Radio button | md-radio | — | 入力 |
| Slider | md-slider | Continuous、Discrete、Range | 入力 |
| Switch | md-switch | アイコンあり/なし | 入力 |
| Text field | md-filled-text-field, md-outlined-text-field | Filled、Outlined | 入力 |
| Time picker | — | Docked、Modal | 入力 |
| App bar (top) | — | Center-aligned、Small、Medium、Large | ナビゲーション |
| Navigation bar | md-navigation-bar | — | ナビゲーション |
| Navigation drawer | md-navigation-drawer | Standard、Modal | ナビゲーション |
| Navigation rail | — | — | ナビゲーション |
| Search | — | Search bar、Search view | ナビゲーション |
| Tabs | md-tabs, md-primary-tab, md-secondary-tab | Primary、Secondary | ナビゲーション |
| Toolbar | — | — | ナビゲーション |
| List | md-list, md-list-item | 一行、二行、三行 | データ表示 |
注: Web Element に — とマークされたコンポーネントは、まだ @material/web の実装がありません。これらのコンポーネントには、標準 HTML と CSS カスタムプロパティを使用してください。Compose のマッピングと例は、参照/component-catalog.md にあります。
コード例を含む完全なコンポーネント詳細: 参照/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: ウィンドウサイズクラス、リスト詳細、サポートペインレイアウト、折りたたみデバイス — 参照/layout-and-responsive.md および 参照/navigation-patterns.md を参照してください。
- エッジツーエッジとインセット:
WindowInsets/ スキャフォールドパディングを使用してコンテンツをレイアウトし、バーと IME が正しく動作するようにします — 参照/layout-and-responsive.md を参照してください。 - 実験的 API: 一部の Material 3 API は
@OptIn(ExperimentalMaterial3Api::class)またはエクスプレッシブオプトインを必要とします。BOM とコンパイラに一致させてください。
MaterialTheme(
colorScheme = colorScheme, // dynamicLightColorScheme / lightColorScheme などから
typography = Typography(),
shapes = Shapes(),
) {
// M3 コンテンツ — Scaffold、ナビゲーション、テキストフィールドについては参照を推奨
}
Web(制限あり): @material/web
重要: Web 向け Material Design 3 によると、Material Web Components はメンテナンスモード であり、M3 Expressive は Web に実装されていません。適切な場合にトークンベースの Web 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>
…
[翻訳のため省略]