Androidプラットフォームデザインガイドライン — Material Design 3
1. Material You & テーマ設定 [重要]
1.1 ダイナミックカラー
ユーザーの壁紙から派生したダイナミックカラーを有効にします。ダイナミックカラーはAndroid 12+のデフォルトであり、主要なテーマ設定戦略であるべきです。
// Compose: ダイナミックカラーテーマ
@Composable
fun AppTheme(
darkTheme: Boolean = isSystemInDarkTheme(),
dynamicColor: Boolean = true,
content: @Composable () -> Unit
) {
val colorScheme = when {
dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
val context = LocalContext.current
if (darkTheme) dynamicDarkColorScheme(context)
else dynamicLightColorScheme(context)
}
darkTheme -> darkColorScheme()
else -> lightColorScheme()
}
MaterialTheme(
colorScheme = colorScheme,
typography = AppTypography,
content = content
)
}
<!-- XML: themes.xmlでのダイナミックカラー -->
<style name="Theme.App" parent="Theme.Material3.DayNight.NoActionBar">
<item name="dynamicColorThemeOverlay">@style/ThemeOverlay.Material3.DynamicColors.DayNight</item>
</style>
ルール:
- R1.1: Android 12未満のデバイス向けに、常にフォールバック用の静的カラースキームを提供してください。
- R1.2: コンポーネント内で色の16進数値をハードコードしないでください。常にテーマからカラーロールを参照してください。
- R1.3: 少なくとも3つの異なる壁紙でテストし、ダイナミックカラーの調和を確認してください。
1.2 カラーロール
Material 3は構造化されたカラーロールのセットを定義しています。これらを美的理由ではなく、意味的に使用してください。
| ロール | 使用法 | Onロール |
|---|---|---|
primary | 主要なアクション、アクティブ状態、FAB | onPrimary |
primaryContainer | 目立たない主要要素 | onPrimaryContainer |
secondary | 補助UI、フィルターチップ | onSecondary |
secondaryContainer | ナビゲーションバーのアクティブインジケーター | onSecondaryContainer |
tertiary | アクセント、コントラスト、補色 | onTertiary |
tertiaryContainer | 入力フィールド、控えめなアクセント | onTertiaryContainer |
surface | 背景、カード、シート | onSurface |
surfaceVariant | 装飾要素、区切り線 | onSurfaceVariant |
error | エラー状態、破壊的アクション | onError |
errorContainer | エラー背景 | onErrorContainer |
outline | 境界線、区切り線 | — |
outlineVariant | 控えめな境界線 | — |
inverseSurface | スナックバーの背景 | inverseOnSurface |
// 正しい: 意味的なカラーロール
Text(
text = "エラーメッセージ",
color = MaterialTheme.colorScheme.error
)
Surface(color = MaterialTheme.colorScheme.errorContainer) {
Text(text = "エラーの詳細", color = MaterialTheme.colorScheme.onErrorContainer)
}
// 間違い: ハードコードされた色
Text(text = "エラー", color = Color(0xFFB00020)) // アンチパターン
ルール:
- R1.4: すべての前景要素は、その背景に対して一致する
onカラーロールを使用する必要があります(例:primary背景の上にはonPrimaryテキスト)。 - R1.5: 背景には
surfaceとそのバリアントを使用してください。大きな背景領域としてprimaryやsecondaryを使用しないでください。 - R1.6:
tertiaryはアクセントと補色コントラストのためだけに控えめに使用してください。
1.3 ライトテーマとダークテーマ
ライトテーマとダークテーマの両方をサポートしてください。デフォルトではシステム設定に従ってください。
// Compose: システムテーマの検出
val darkTheme = isSystemInDarkTheme()
ルール:
- R1.7: 常にライトテーマとダークテーマの両方をサポートしてください。ライトのみのアプリをリリースしないでください。
- R1.8: ダークテーマのサーフェスは、純粋な黒色(#000000)ではなく、高度に基づいたトーンマッピングを使用します。これを自動的に処理する
surfaceカラーロールを使用してください。 - R1.9: アプリ設定で手動テーマオーバーライド(システム/ライト/ダーク)を提供してください。
1.4 カスタムカラーシード
ブランディングにカスタム色が必要な場合は、シードカラーを提供し、Material Theme Builderを使用してトーンパレットを生成してください。
// ブランドシードを使用したカスタムカラースキーム
private val BrandLightColorScheme = lightColorScheme(
primary = Color(0xFF1B6D2F),
onPrimary = Color(0xFFFFFFFF),
primaryContainer = Color(0xFFA4F6A8),
onPrimaryContainer = Color(0xFF002107),
// ... シードから完全なパレットを生成
)
ルール:
- R1.10: Material Theme Builderを使用してシードカラーからトーンパレットを生成してください。個別のトーンを手動で選択しないでください。
- R1.11: カスタム色を使用する場合でも、デフォルトとしてダイナミックカラーをサポートし、カスタム色をフォールバックとして使用してください。
2. ナビゲーション [重要]
2.1 ナビゲーションバー(下部)
3〜5個のトップレベルデスティネーションを持つ電話向けの主要なナビゲーションパターンです。
// Compose: ナビゲーションバー
NavigationBar {
items.forEachIndexed { index, item ->
NavigationBarItem(
icon = {
Icon(
imageVector = if (selectedItem == index) item.filledIcon else item.outlinedIcon,
contentDescription = item.label
)
},
label = { Text(item.label) },
selected = selectedItem == index,
onClick = { selectedItem = index }
)
}
}
ルール:
- R2.1: コンパクト画面では3〜5個のトップレベルデスティネーションにナビゲーションバーを使用してください。3未満または5を超える場合は使用しないでください。
- R2.2: ナビゲーションバーのアイテムには常にラベルを表示してください。アイコンのみのナビゲーションバーは許可されていません。
- R2.3: 選択状態には塗りつぶしアイコンを、非選択状態にはアウトラインフィルアイコンを使用してください。
- R2.4: アクティブインジケーターには
secondaryContainer色を使用します。これをオーバーライドしないでください。
2.2 ナビゲーションレール
中画面および拡大画面(タブレット、折りたたみデバイス、デスクトップ)向け。
// Compose: 大画面向けナビゲーションレール
NavigationRail(
header = {
FloatingActionButton(
onClick = { /* 主要アクション */ },
containerColor = MaterialTheme.colorScheme.tertiaryContainer
) {
Icon(Icons.Default.Add, contentDescription = "作成")
}
}
) {
items.forEachIndexed { index, item ->
NavigationRailItem(
icon = { Icon(item.icon, contentDescription = item.label) },
label = { Text(item.label) },
selected = selectedItem == index,
onClick = { selectedItem = index }
)
}
}
ルール:
- R2.5: 中画面(600-839dp)および拡大画面(840dp+)のウィンドウサイズではナビゲーションレールを使用してください。コンパクト画面ではナビゲーションバーと組み合わせてください。
- R2.6: オプションで、主要アクション用にレールヘッダーにFABを含めることができます。
- R2.7: レールのラベルはオプションですが、明確さのために推奨されます。
2.3 ナビゲーションドロワー
5つ以上のデスティネーションや複雑なナビゲーション階層に使用し、通常は拡大画面で使用します。
// Compose: 大画面向けパーマネントナビゲーションドロワー
PermanentNavigationDrawer(
drawerContent = {
PermanentDrawerSheet {
Text("アプリ名", modifier = Modifier.padding(16.dp),
style = MaterialTheme.typography.titleMedium)
HorizontalDivider()
items.forEach { item ->
NavigationDrawerItem(
label = { Text(item.label) },
selected = item == selectedItem,
onClick = { selectedItem = item },
icon = { Icon(item.icon, contentDescription = null) }
)
}
}
}
) {
Scaffold { /* ページコンテンツ */ }
}
ルール:
- R2.8: コンパクト画面ではモーダルドロワーを、拡大画面ではパーマネントドロワーを使用してください。
- R2.9: ドロワーアイテムを区切り線とセクションヘッダーでグループ化してください。
2.4 予測的戻るジェスチャー
Android 13+はアニメーションプレビュー付きの予測的戻るをサポートしています。
// Compose: BackHandlerを使用した予測的戻る(androidx.activity.compose)
BackHandler(enabled = true) {
// 戻るが確定したときに呼び出されます; ナビゲーションコントローラーで戻る
navController.popBackStack()
}
// Compose: predictiveBackHandler修飾子を使用した予測的戻る進行アニメーション
// (androidx.activity:activity-compose 1.8+)
Modifier.predictiveBackHandler(enabled = true) { progress ->
// progressはBackEventCompatのFlowで、x, y, swipeEdge, progress (0.0–1.0) を含む
progress.collect { backEvent ->
animationState = backEvent.progress
}
}
<!-- AndroidManifest.xml: 予測的戻るへのオプトイン -->
<application android:enableOnBackInvokedCallback="true">
ルール:
- R2.10: マニフェストで予測的戻るにオプトインしてください。Composeアプリでは、
BackHandler(androidx.activity.composeから)を使用して戻るイベントをインターセプトします。Viewベースのアプリでは、onBackPressed()をオーバーライドする代わりに、OnBackInvokedCallback(API 33+)またはOnBackPressedCallback(AndroidX)を実装してください。 - R2.11: システムの戻るジェスチャーはナビゲーションスタック内で戻ります。Upボタン(ツールバーの矢印)はアプリ階層内で上に移動します。これらは異なる場合があります。
- R2.12: 未保存のユーザー入力がない限り、システムの戻るをインターセプトして「本当に戻りますか?」ダイアログを表示しないでください。
- R2.13: システム提供の戻るプレビューアニメーションを抑制しないでください。カスタムの遷移アニメーションを実装する場合は、
BackEventCompat.progress(0.0–1.0)を使用してそれらを補間し、BackEventCompat.swipeEdge(EDGE_LEFT/EDGE_RIGHT)を尊重して、終了画面が開始エッジに向かって縮小およびシフトし、システムアニメーションと一致するようにしてください。 - R2.14: 想起よりも認識を優先してください。デスティネーションにラベルを付け、選択状態を可視化し、バックスタックコンテキストを保持することで、ユーザーがナビゲーションステップごとに自分がどこにいるかを再構築する必要がないようにしてください。
// Compose: 予測的戻る進行からカスタムアニメーションを駆動
Modifier.predictiveBackHandler(enabled = true) { progress ->
progress.collect { backEvent ->
// backEvent.progress: 0.0 (ジェスチャー開始) → 1.0 (確定)
// backEvent.swipeEdge: BackEventCompat.EDGE_LEFT または EDGE_RIGHT
exitScale = 1f - (backEvent.progress * 0.1f)
exitOffsetX = if (backEvent.swipeEdge == BackEventCompat.EDGE_LEFT) -backEvent.progress * 32.dp.toPx() else backEvent.progress * 32.dp.toPx()
}
}
2.5 ナビゲーションコンポーネントの選択
| 画面サイズ | 3-5個のデスティネーション | 5個以上のデスティネーション |
|---|---|---|
| コンパクト (< 600dp) | ナビゲーションバー | モーダルドロワー + ナビゲーションバー |
| 中 (600-839dp) | ナビゲーションレール | モーダルドロワー + ナビゲーションレール |
| 拡大 (840dp+) | ナビゲーションレール | パーマネントドロワー |
3. レイアウト & レスポンシブ [高]
3.1 ウィンドウサイズクラス
アダプティブレイアウトには、生のピクセルブレークポイントではなく、ウィンドウサイズクラスを使用してください。
// Compose: ウィンドウサイズクラス
val windowSizeClass = calculateWindowSizeClass(this)
when (windowSizeClass.widthSizeClass) {
WindowWidthSizeClass.Compact -> CompactLayout()
WindowWidthSizeClass.Medium -> MediumLayout()
WindowWidthSizeClass.Expanded -> ExpandedLayout()
}
| クラス | 幅 | 代表的なデバイス | カラム数 |
|---|---|---|---|
| コンパクト | < 600dp | 電話縦向き | 4 |
| 中 | 600-839dp | タブレット縦向き、折りたたみデバイス | 8 |
| 拡大 | 840dp+ | タブレット横向き、デスクトップ | 12 |
ルール:
- R3.1: レスポンシブレイアウトの決定には、常に
material3-window-size-classのWindowSizeClassを使用してください。 - R3.2: 固定ピクセルのブレークポイントを使用しないでください。デバイスカテゴリは流動的です。
- R3.3: 3つの幅サイズクラスすべてをサポートしてください。最低でもコンパクトと拡大をサポートします。
3.2 Materialグリッド
正規のMaterialグリッドマージンとガターを適用してください。
| サイズクラス | マージン | ガター | カラム数 |
|---|---|---|---|
| コンパクト | 16dp | 8dp | 4 |
| 中 | 24dp | 16dp | 8 |
| 拡大 | 24dp | 24dp | 12 |
ルール:
- R3.4: 拡大画面では、コンテンツが全幅にわたらないようにしてください。最大コンテンツ幅約840dp、またはリスト詳細レイアウトを使用してください。
- R3.5: グリッド仕様に一致する一貫した水平マージンを適用してください。
3.3 エッジツーエッジ表示
Android 15+はエッジツーエッジを強制します。すべてのアプリはシステムバーの背後に描画する必要があります。
// Compose: エッジツーエッジ設定
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
enableEdgeToEdge()
super.onCreate(savedInstanceState)
setContent {
Scaffold(
modifier = Modifier.fillMaxSize(),
// Scaffoldは上部/下部バーのインセットを自動的に処理します
) { innerPadding ->
Content(modifier = Modifier.padding(innerPadding))
}
}
}
}
ルール:
- R3.6:
setContentの前にenableEdgeToEdge()を呼び出してください。ステータスバーとナビゲーションバーの両方の背後に描画します。 - R3.7:
WindowInsetsを使用して、コンテンツをシステムバーからパディングで離してください。Scaffoldは、トップバーとボトムバーのコンテンツに対してこれを自動的に処理します。 - R3.8: スクロール可能なコンテンツは、透明なシステムバーの背後でスクロールし、リストの上部と下部に適切なインセットパディングを適用する必要があります。
3.4 折りたたみデバイスのサポート
// Compose: 折りたたみ姿勢の検出
val foldingFeatures = WindowInfoTracker.getOrCreate(context)
.windowLayoutInfo(context)
.collectAsState(initial = WindowLayoutInfo(emptyList()))
ルール:
- R3.9: ヒンジ/折りたたみ位置を検出し、折り目をまたいで重要なコンテンツを配置しないようにしてください。
- R3.10: 折りたたみデバイス対応レイアウトには、Material3アダプティブライブラリの
ListDetailPaneScaffoldまたはSupportingPaneScaffoldを使用してください。
4. タイポグラフィ [高]
4.1 Materialタイプスケール
| ロール | デフォルトサイズ | デフォルトウェイト | 使用法 |
|---|---|---|---|
| displayLarge | 57sp | 400 | ヒーローテキスト、オンボーディング |
| displayMedium | 45sp | 400 | 大きな特徴テキスト |
| displaySmall | 36sp | 400 | 目立つ表示 |
| headlineLarge | 32sp | 400 | 画面タイトル |
| headlineMedium | 28sp | 400 | セクションヘッダー |
| headlineSmall | 24sp | 400 | カードタイトル |
| titleLarge | 22sp | 400 | トップアプリバータイトル |
| titleMedium | 16sp | 500 | タブ、ナビゲーション |
| titleSmall | 14sp | 500 | サブタイトル |
| bodyLarge | 16sp | 400 | 主要本文テキスト |
| bodyMedium | 14sp | 400 | 二次本文テキスト |
| bodySmall | 12sp | 400 | キャプション |
| labelLarge | 14sp | 500 | ボタン、目立つラベル |
| labelMedium | 12sp | 500 | チップ |
…
[翻訳のため省略]