Material Design 3
此技能指导如何实现 Google 的 Material Design 3 (MD3) —— 一种个性化、自适应、富有表现力的设计系统。MD3 使用动态颜色、色调表面、圆角和基于弹簧的动效来打造感觉生动且个性化的 UI。
理念
MD3 基于三个原则构建:
- 个性化:动态颜色使 UI 适应用户的壁纸或内容。主题是个性化的,而非一刀切。
- 自适应:布局可跨 5 个窗口大小类进行变换。组件可响应式调整大小、重新定位和改变形态。
- 表现力:形状变形、弹簧物理和强调排版在不牺牲可用性的前提下创造令人愉悦的瞬间。
最新动态:Google I/O 2026
Material 的 Google I/O 2026 更新 强化了 Compose-first 的 Android 路径,并扩展了表现力和自适应指南:
- Material Android 以 Compose 为首选:对于新的 Android 工作,优先使用 Jetpack Compose Material3 获取最新组件、表现性 API、自适应脚手架和 Styles API 集成。Android Views 可能在现有应用程序中仍有必要,但不应该被视为新的 Material 3 实现的默认路径。
- 表现性布局系统:使用表现性布局脚手架来适配移动设备、桌面、折叠屏、手表、XR 和其他空间形态的屏幕。从自适应脚手架/窗口大小类开始,而不是固定的手机优先布局。
- 8dp 间距系统:应用间距令牌表示外边距、内边距和间距,使布局和组件能够根据设备类型和密度进行程序化适配。
- 新的/更新的表现性组件:列表、菜单、搜索和搜索应用栏已更新表现性指南,Jetpack Compose 是主要实现目标。
- 手表和 XR:手表强调基于物理的动效、弧形文字和边缘拥抱容器。XR 强调空间面板和基于深度的仰角。
与 MD2 的关键区别:
- 色调表面取代仰角阴影作为主要深度提示
- 动态颜色从单个种子颜色生成完整的配色方案
- 默认完全圆角(而非轻微圆角)
- 基于弹簧的动效物理取代了组件的固定缓动曲线
- 3 级用户可控制的对比度(标准/中等/高)
与前端设计技能的关系: 当两个技能都启用时,MD3 提供设计系统(令牌、组件、布局规则),而前端设计在这些约束内提供创意方向。对于组件结构和令牌使用,MD3 规则优先。注意:Roboto/Roboto Flex 是 MD3 中正确的默认字体 —— 前端设计指南中避免使用 Roboto 的建议不适用于实现 MD3 时。
决策树
你在构建什么?
完整应用脚手架 → 参见“常见模式:应用外壳” + 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()
Web(原生 JS) → @material/web(有限;维护模式)+ CSS 自定义属性
Web(React/Vue/Svelte) → CSS 自定义属性 + 包装组件(无官方 React 库)
Web(仅 CSS) → MD3 令牌值作为 CSS 自定义属性(无 <md-*> 元素)
设计令牌系统
所有 MD3 令牌使用 md.sys 命名空间。Jetpack Compose 将角色映射到 MaterialTheme.colorScheme、MaterialTheme.typography 和 MaterialTheme.shapes(与规范相同的语义角色)。在 Web 上,这些映射到 CSS 自定义属性 (--md-sys-*):
颜色令牌 (--md-sys-color-*)
| 令牌 | 用途 |
|---|---|
primary | 高强调填充、文本、图标(相对于表面) |
on-primary | 主色上的文本/图标 |
primary-container | 关键组件(FAB 等)的突出填充 |
on-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% 主色 | 凸起卡片、模式工作表 |
| 2 | 3dp | +8% 主色 | 菜单、导航栏、滚动应用栏 |
| 3 | 6dp | +11% 主色 | FAB、对话框、搜索、日期/时间选择器 |
| 4 | 8dp | +12% 主色 | (仅悬停/聚焦增加) |
| 5 | 12dp | +14% 主色 | (仅悬停/聚焦增加) |
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 | 实心、轮廓、文本、凸起、色调;5 种尺寸(XS–XL);开关 | 操作 |
| 按钮组 | md-button-group | 标准、连接 | 操作 |
| 扩展 FAB | md-extended-fab | 表面、主色、次要、强调 | 操作 |
| FAB | md-fab | 小、中、大 | 操作 |
| FAB 菜单 | — | — | 操作 |
| 图标按钮 | md-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-button | 标准、实心、实心色调、轮廓 | 操作 |
| 分段按钮 | — | 单选、多选 | 操作 |
| 拆分按钮 | — | — | 操作 |
| 徽章 | — | 小(圆点)、大(计数) | 通信 |
| 加载指示器 | — | 线性、圆形 | 通信 |
| 进度指示器 | md-linear-progress, md-circular-progress | 线性、圆形;确定/不确定 | 通信 |
| Snackbar | — | 单行、两行、操作 | 通信 |
| 工具提示 | — | 纯文本、富文本 | 通信 |
| 卡片 | — | 实心、轮廓、凸起 | 容器 |
| 轮播 | — | 多浏览、非容器、英雄 | 容器 |
| 对话框 | md-dialog | 基本、全屏 | 容器 |
| 底部工作表 | — | 标准、模式 | 工作表 |
| 侧边工作表 | — | 标准、模式 | 工作表 |
| 分隔线 | md-divider | 全宽、内嵌 | 容器 |
| 复选框 | md-checkbox | — | 输入 |
| 筹码 | md-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chip | 辅助、过滤、输入、建议 | 输入 |
| 日期选择器 | — | 停靠、模式、范围 | 输入 |
| 菜单 | md-menu, md-menu-item | — | 输入 |
| 单选按钮 | md-radio | — | 输入 |
| 滑块 | md-slider | 连续、离散、范围 | 输入 |
| 开关 | md-switch | 带/不带图标 | 输入 |
| 文本字段 | md-filled-text-field, md-outlined-text-field | 实心、轮廓 | 输入 |
| 时间选择器 | — | 停靠、模式 | 输入 |
| 应用栏(顶部) | — | 居中、小、中、大 | 导航 |
| 导航栏 | md-navigation-bar | — | 导航 |
| 导航抽屉 | md-navigation-drawer | 标准、模式 | 导航 |
| 导航导轨 | — | — | 导航 |
| 搜索 | — | 搜索栏、搜索视图 | 导航 |
| 标签页 | md-tabs, md-primary-tab, md-secondary-tab | 主要、次要 | 导航 |
| 工具栏 | — | — | 导航 |
| 列表 | 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/ 脚手架内边距布局内容,以使状态栏、导航栏和输入法窗口行为正确 —— 参见references/layout-and-responsive.md。 - 实验性 API:某些 Material 3 API 需要
@OptIn(ExperimentalMaterial3Api::class)或表现性 API 的显式选择加入;请匹配你的 BOM 和编译器。
MaterialTheme(
colorScheme = colorScheme, // 来自 dynamicLightColorScheme / lightColorScheme 等
typography = Typography(),
shapes = Shapes(),
) {
// M3 内容 — 请参考 references 获取 Scaffold、导航、文本字段等
}
Web(有限支持):@material/web
重要提示: 根据 Material Design 3 for Web,Material Web 组件处于维护模式,M3 Expressive 未在 Web 上实现。在适当时,使用 @material/web 提供基于令牌的 Web UI,但不要将其视为与 Compose 在当前的 Expressive 特性上等效。
安装
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="zh-CN">
<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>