Material Design 3
此技能引導實作 Google 的 Material Design 3(MD3)—— 一套個人化、自適應且富有表現力的設計系統。MD3 使用動態色彩、色調表面、圓角造型及基於彈簧的動態效果,打造出生動且個人化的使用者介面。
核心理念
MD3 奠基於三大原則:
- 個人化:動態色彩讓 UI 根據使用者的桌布或內容進行調整。主題設定因人而異,非一體適用。
- 自適應:佈局會根據 5 種視窗尺寸類別進行轉換。元件能因應性地調整大小、重新定位及改變外觀形式。
- 表現力:造型變化、彈簧物理效果與強調字體排印,在不犧牲可用性的前提下創造令人愉悅的時刻。
最新更新:Google I/O 2026
Material 的 Google I/O 2026 更新 強化了 Compose 優先 的 Android 開發路徑,並擴展了表現力與自適應的指引:
- Material Android 是 Compose 優先:對於新的 Android 開發工作,優先採用 Jetpack Compose Material3 以獲得最新元件、表現力 API、自適應 Scaffold 以及 Styles API 整合。現有應用程式中可能仍需使用 Android Views,但對於新的 Material 3 實作,不應將其視為預設路徑。
- 表現力佈局系統:使用表現力佈局 Scaffold,以適配行動裝置、桌面電腦、摺疊裝置、手錶、XR 及其他空間形式的螢幕。應從自適應 Scaffold / 視窗尺寸類別開始,而非固定的手機優先佈局。
- 8dp 間距系統:應用間距權杖於邊距、內距與間隙,使佈局和元件能根據裝置類型和密度進行程式化調整。
- 新增/更新的表現力元件:列表、選單、搜尋及搜尋應用程式列已更新表現力指引,並以 Jetpack Compose 為主要實作目標。
- 手錶與 XR:手錶強調基於物理的動態效果、弧形文字及邊緣貼合容器。XR 則強調空間面板與基於深度的立體感。
與 MD2 的主要差異:
- 色調表面取代陰影作為主要的深度線索
- 動態色彩可從單一種子顏色生成完整的配色方案
- 預設為完全圓角(而非稍微圓角)
- 基於彈簧的動態物理效果取代了元件固定的緩動曲線
- 3 個使用者可控的對比度層級(標準 / 中等 / 高)
與前端設計技能之關係: 當兩個技能同時啟用時,MD3 提供設計系統(權杖、元件、佈局規則),而前端設計在這些約束條件下提供創意方向。對於元件結構和權杖使用,MD3 規則具有優先權。注意:Roboto / Roboto Flex 確實是 MD3 中的正確預設字型——前端設計中避免使用 Roboto 的指引在實作 MD3 時不適用。
決策樹
你在建構什麼?
完整應用程式 Scaffold → 請參閱「常見模式:App Shell」+ 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, references/*
Flutter → 在 ThemeData 中設定 useMaterial3: true, ColorScheme.fromSeed()
網頁 (原生 JS) → @material/web(有限支援;維護模式)+ CSS 自訂屬性
網頁 (React/Vue/Svelte) → CSS 自訂屬性 + 包裝元件(無官方 React 函式庫)
網頁 (僅 CSS) → MD3 權杖值作為 CSS 自訂屬性(不使用 <md-*> 元素)
設計權杖系統
所有 MD3 權杖皆使用 md.sys 命名空間。Jetpack Compose 將角色對應至 MaterialTheme.colorScheme、MaterialTheme.typography 和 MaterialTheme.shapes(與規格相同的語意角色)。在網頁上,這些對應至 CSS 自訂屬性(--md-sys-*):
色彩權杖(--md-sys-color-*)
| 權杖 | 用途 |
|---|---|
primary | 高強調度填色、文字、圖示(位於 surface 上) |
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 | 對比元素(Snackbar) |
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
另外還有 15 種強調變體(更高字重)可透過 --md-sys-typescale-emphasized-* 使用
完整詳細資料:references/typography-and-shape.md
形狀權杖(--md-sys-shape-corner-*)
| 權杖 | 數值 | 範例元件 |
|---|---|---|
none | 0dp | — |
extra-small | 4dp | 晶片、Snackbar |
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 | (僅 hover/focus 增加) |
| 5 | 12dp | +14% primary | (僅 hover/focus 增加) |
在 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 元素 | 主要變體 | 類別 |
|---|---|---|---|
| 按鈕 | md-filled-button, md-outlined-button, md-text-button, md-elevated-button, md-filled-tonal-button | Filled, Outlined, Text, Elevated, Tonal;5 種尺寸(XS–XL);切換 | 動作 |
| 按鈕群組 | md-button-group | Standard, Connected | 動作 |
| 擴展 FAB | md-extended-fab | Surface, Primary, Secondary, Tertiary | 動作 |
| FAB | md-fab | Small, Medium, Large | 動作 |
| FAB 選單 | — | — | 動作 |
| 圖示按鈕 | md-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-button | Standard, Filled, Filled Tonal, Outlined | 動作 |
| 分段按鈕 | — | 單選,多選 | 動作 |
| 分割按鈕 | — | — | 動作 |
| 徽章 | — | Small (dot), Large (count) | 溝通 |
| 載入指示器 | — | Linear, Circular | 溝通 |
| 進度指示器 | md-linear-progress, md-circular-progress | Linear, Circular;確定/不確定 | 溝通 |
| Snackbar | — | 單行,雙行,含動作 | 溝通 |
| 工具提示 | — | Plain, Rich | 溝通 |
| 卡片 | — | Filled, Outlined, Elevated | 容器 |
| 輪播 | — | Multi-browse, Uncontained, Hero | 容器 |
| 對話框 | md-dialog | Basic, Full-screen | 容器 |
| 底部工作表 | — | Standard, Modal | 工作表 |
| 側邊工作表 | — | Standard, Modal | 工作表 |
| 分隔線 | md-divider | Full-width, Inset | 容器 |
| 核取方塊 | md-checkbox | — | 輸入 |
| 晶片 | md-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chip | Assist, Filter, Input, Suggestion | 輸入 |
| 日期選擇器 | — | Docked, Modal, Range | 輸入 |
| 選單 | md-menu, md-menu-item | — | 輸入 |
| 選項按鈕 | md-radio | — | 輸入 |
| 滑桿 | md-slider | Continuous, Discrete, Range | 輸入 |
| 開關 | md-switch | 含/不含圖示 | 輸入 |
| 文字欄位 | md-filled-text-field, md-outlined-text-field | Filled, Outlined | 輸入 |
| 時間選擇器 | — | Docked, Modal | 輸入 |
| 頂端應用程式列 | — | 置中對齊, Small, Medium, Large | 導覽 |
| 導覽列 | md-navigation-bar | — | 導覽 |
| 導覽抽屜 | md-navigation-drawer | Standard, Modal | 導覽 |
| 導覽軌 | — | — | 導覽 |
| 搜尋 | — | Search bar, Search view | 導覽 |
| 分頁標籤 | md-tabs, md-primary-tab, md-secondary-tab | Primary, Secondary | 導覽 |
| 工具列 | — | — | 導覽 |
| 列表 | md-list, md-list-item | 單行,雙行,三行 | 資料顯示 |
注意: Web 元素標示為 — 的元件尚無 @material/web 實作。請對這些元件使用 CSS 自訂屬性搭配標準 HTML。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:視窗尺寸類別、列表-詳細資料和支援面板佈局、摺疊裝置——請參閱
references/layout-and-responsive.md和references/navigation-patterns.md。 - 全滿版與邊距:使用
WindowInsets/ scaffold 內距來佈局內容,使狀態列和 IME 行為正確——請參閱references/layout-and-responsive.md。 - 實驗性 API:部分 Material 3 API 需要使用
@OptIn(ExperimentalMaterial3Api::class)或表現力功能的 opt-in;請確認你的 BOM 和編譯器版本相符。
MaterialTheme(
colorScheme = colorScheme, // 來自 dynamicLightColorScheme / lightColorScheme 等
typography = Typography(),
shapes = Shapes(),
) {
// M3 內容 — 建議參閱 references 中的 Scaffold、導覽、文字欄位
}
網頁(有限):@material/web
重要: 根據 Material Design 3 for Web,Material Web Components 處於維護模式,並且M3 Expressive 未在網頁上實作。請在適當時使用 @material/web 建立基於權杖的網頁 UI,但對於目前的 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>
…
[已截斷以進行翻譯]