Skip to content
Material Design 3
Main Navigation
v3
v2
v1

简体中文

English
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

简体中文

English
繁體中文
Español
Français
Русский
Português – Brasil
Deutsch
日本語
한국어
Italiano
Polski
Türkçe
čeština
magyar

主题

Sidebar Navigation

基础

无障碍

概述:原则

概述:辅助技术

设计:概述

设计:颜色对比度

设计:结构

设计:流程

设计:元素

写作与文本:最佳实践

写作与文本:文本截断

写作与文本:文本大小调整

为所有人构建:用户需求

为所有人构建:协同设计

内容设计

概览

替代文本

全球化写作:概述

面向全球的写作:用词选择

通知

风格指南:UX 文案最佳实践

风格指南:用词

风格指南:语法和标点

自定义 Material

设备

为手表设计:概览

手表设计:基础

手表设计:样式

手表设计:布局

XR

沉浸式 XR 设计:概述

面向沉浸式 XR 的设计:交互

沉浸式 XR 设计:布局

沉浸式 XR 设计:无障碍

XR 组件:概述

XR 组件:应用栏

XR 组件:对话框

XR 组件:导航栏

XR 组件:导航轨道

XR 组件:工具栏

设计令牌:概述

设计令牌:如何使用令牌

交互

手势

输入:基础

选择:概述

状态:概览

状态:状态层

状态:应用状态

布局

布局概览:概述

布局概览:布局的组成部分

布局概览:自适应设计

Scaffold:概览

Scaffold:栏

Scaffold: 轨道

Scaffold:窗格

网格与间距:概述

网格与间距:网格

网格与间距:间距

网格与间距:密度

断点:概览

断点:紧凑

断点:中等

断点:扩展型

断点:大尺寸与超大尺寸

双向性与 RTL

规范布局示例:概览

规范布局示例:信息流

规范布局示例:列表-详情

规范布局示例:辅助窗格

可用性:概览

可用性:应用 M3 表现力设计

Material 术语 A-Z

样式

颜色

色彩系统:概览

色彩系统:工作原理

颜色角色

配色方案

选择配色方案

静态配色方案:Baseline

静态配色方案:自定义品牌

动态配色方案:选择来源

动态配色方案:用户生成源色

动态配色方案:基于内容的取色源

高级自定义:概览

高级自定义:应用颜色

高级自定义:定义新颜色

高级自定义:调整现有颜色

颜色资源

海拔:概览

海拔:应用海拔

海拔:令牌

图标:概览

图标:设计图标

图标:图标的运用

动效

动效物理系统:工作原理

动效物理系统:规格

缓动和时长:应用缓动与时长

缓动和时长:令牌与规格

过渡:过渡模式

过渡:应用过渡

形状:概览与原则

形状:圆角半径刻度

形状:形状变形

间距:概览

间距:应用间距

间距:令牌

字体排印:概述

字体排印:字体

字体排印:字阶与令牌

字体排印:应用字体样式

字体排印:编辑式处理

组件

应用栏:概览

应用栏:规格

应用栏:指南

应用栏:无障碍

徽标:概览

徽标:规格

徽标:指南

徽标:无障碍

按钮

所有按钮

按钮组:概览

按钮组:规格

按钮组:指南

按钮组:无障碍

按钮:概览

按钮:规格

按钮:指南

按钮:无障碍

扩展 FAB:概览

扩展 FAB:规格

扩展 FAB:指南

扩展浮动操作按钮:无障碍

FAB 菜单:概述

FAB 菜单:规格

FAB 菜单:指南

FAB 菜单:无障碍

浮动操作按钮(FABs):概览

浮动操作按钮(FAB):规格

浮动操作按钮 (FAB):指南

浮动操作按钮 (FAB):无障碍

图标按钮:概述

图标按钮:规格

图标按钮:指南

图标按钮:无障碍

分段按钮:概览

分段按钮:规格

分段按钮:指南

分段按钮:无障碍

拆分按钮:概览

拆分按钮:规格

拆分按钮:指南

拆分按钮:无障碍

卡片:概览

卡片:规格

卡片:指南

卡片:无障碍

轮播:概览

轮播:规格

轮播:指南

轮播:无障碍

复选框:概览

复选框:规格

复选框:指南

复选框:无障碍

芯片:概览

芯片:规格

芯片:指南

芯片:无障碍

日期和时间选择器

日期选择器:概览

日期选择器:规格

日期选择器:指南

日期选择器:无障碍

时间选择器:概览

时间选择器:规格

时间选择器:指南

时间选择器:无障碍

对话框:概览

对话框:规格

对话框:指南

对话框:无障碍

分隔线:概览

分隔线:规格

分隔线:指南

分隔线:无障碍

列表:概览

列表:规格

列表:指南

列表:无障碍

加载和进度

加载指示器:概览

加载指示器:规格

加载指示器:指南

加载指示器:无障碍

进度指示器:概览

进度指示器:规格

进度指示器:指南

进度指示器:无障碍

菜单:概览

菜单:规格

菜单:指南

菜单:无障碍

导航

导航栏:概述

导航栏:规格

导航栏:指南

导航栏:无障碍

导航抽屉:概览

导航抽屉:规格

导航抽屉:指南

导航抽屉:无障碍

导航轨道:概览

导航轨道:规格

导航轨道:指南

导航轨道:无障碍

单选按钮:概述

单选按钮:规格

单选按钮:指南

单选按钮:无障碍

搜索:概览

搜索:规格

搜索:指南

搜索:无障碍

工作表

底部工作表:概览

底部工作表:规格

底部工作表:指南

底部工作表:无障碍

侧边工作表:概览

侧边工作表:规格

侧边工作表:指南

侧边工作表:无障碍

滑块:概览

滑块:规格

滑块:指南

滑块:无障碍

提示条:概览

提示条:规格

提示条:指南

提示条:无障碍

开关:概览

开关:规格

开关:指南

开关:无障碍

标签页:概览

标签页:规格

标签页:指南

标签页:无障碍

文本框:概览

文本框:规格

文本框:指南

文本框:无障碍

工具栏:概览

工具栏:规格

工具栏:指南

工具栏:无障碍

工具提示:概览

工具提示:规格

工具提示:指南

工具提示:无障碍

页面导航

列表:规格 ​

列表是文本和图片的连续垂直索引。

变体 ​

表现力列表 ​

表现力列表变体可提供更灵活的样式、更醒目的选中状态和可自定义插槽。


2 个表现力列表:平板电脑上的照片列表,以及手机上的歌曲列表。
表现力列表采用分段样式和圆角

基线列表 ​


基线基线变体是 M3 的原始组件设计,可能不包含 M3 Expressive 引入的最新功能,例如更新的动效、形状、字体排印和样式。详细了解 M3 Expressive列表仍然可用,但不具备最新的视觉样式、选中样式和插槽功能。

在 Web 上,表现力列表基于基线列表构建。

查看基线列表规格


3 个采用直角的基线列表项。
基线列表项采用直角和标准颜色

变体M3M3 Expressive
列表(表现力)--可用
列表(基线)可用不推荐。
请改用表现力列表。

配置 ​

样式 ​

标准样式和分段样式仅影响视觉效果,不影响列表行为。

深色模式下的标准列表和分段列表。
  1. 标准
  2. 分段

列表选择 ​

同一列表一次只能使用一种选择模式。例如,单操作列表可以切换为多选列表,但不能同时兼具两种模式。

一个包含 4 个列表项且无附加操作的单操作列表。
在单操作列表中,每个列表项都是可点按区域
一个包含 4 个列表项的列表。每个列表项有 2 个尾部图标用于附加操作。
多操作列表的列表项包含一个主要操作和一个或多个次要操作
一个选中了 1 个列表项的列表。
一个单选列表
一个选中了 2 个列表项的列表。
一个多选列表

列表交互 ​

列表支持:

  • 展开和折叠
  • 滑动显示*

详细了解列表交互的无障碍支持

列表展开后可包含多个列表项
一个列表项被滑动,显示另外 3 个操作。
可通过滑动列表项来显示更多操作
类别配置M3M3 Expressive
样式标准可用可用
分段--可用
选择模式单操作、多操作、单选、多选可用可用
交互展开、滑动\*可用可用

* 滑动显示交互仅在 Android Views 中受支持。

令牌和规格 ​

使用表格菜单选择令牌集。common(通用)令牌集结合了基线令牌与新的表现力形状和尺寸。expand(展开)令牌集包含用于展开交互的令牌。详细了解设计令牌

列表 - 通用 ​

主题
对比度

列表 - 展开 ​

主题
对比度

结构 ​

展示可纳入列表的 10 个元素的图表。

容器和标签文本是必需的。所有其他元素都是可选的:

  1. 容器
  2. 顶部小标题
  3. 标签文本
  4. 后置文本
  5. 辅助文本
  6. 尾部图标
  7. 分隔线
  8. 前置头像
  9. 前导图标
  10. 前置媒体 - 图像或视频

灵活性与插槽

M3 设计套件提供带自定义插槽的列表,以便灵活设计列表项布局。可将自定义列表视为包含三个不同插槽的容器:前置、内容和后置。每个插槽可容纳不同的元素。

插槽的无障碍支持

默认情况下,插槽不提供无障碍支持。请遵循以下建议:

  • 元素必须遵循列表的规则、结构和交互模式
  • 使用标准列表项内边距
  • 触控目标尺寸必须至少为 48x48dp
  • 不要添加会让列表项难以导航的交互元素,尤其是对屏幕阅读器用户而言

详细了解必需的无障碍指南

包含前置、内容和后置插槽的示意图。
注意 仅在能够保持列表无障碍和功能的场景中使用插槽
  1. 前置插槽
  2. 内容插槽
  3. 后置插槽

WARNING

使用插槽需要自行创建并维护自定义代码实现

前置和后置插槽的宽度必须小于内容插槽的宽度。

1. 前置插槽可包含:

  • 视觉元素:头像、图标、图像或视频缩略图
  • 选择选择功能让用户能够选取特定列表项进行操作。详细了解选择控件:复选框、单选按钮或开关
  • 自定义元素:徽标或较大图像

2. 内容插槽必须是宽度最大的插槽,并且可以包含:

  • 默认内容:标签文本、辅助文本
  • 可选附加项:徽标、图标、内联标签或更多文本元素
  • 避免文本行过长,以保持可读性

3. 后置插槽可以包含:

  • 操作元素或文本:图标、图标按钮或后置文本
  • 选择控件:复选框、单选按钮或开关
显示插槽放置在列表中间的插槽示意图。
内容插槽必须是最大的部分,并放置在列表项的中间

选择列表

对于选择列表,每个列表项仅使用一种选择交互。

一个选中的列表项,其前置插槽中有一个对勾。
正确做法 每个列表项仅使用一种选择交互
一个选中的列表项,其前置插槽中有一个对勾,后置插槽中有一个书签。
错误做法 不要在一个列表项中使用多种选择交互

颜色 ​

颜色值通过设计令牌实现。对设计师而言,这意味着使用与令牌对应的颜色值;在实现中,颜色值以引用具体取值的令牌形式出现。详细了解设计令牌

浅色模式和深色模式下的 10 个列表元素颜色角色。

用于浅色和深色主题的列表颜色角色:

  1. 表面
  2. 表面变体前景色
  3. 表面前景色
  4. 表面变体前景色
  5. 表面变体前景色
  6. 表面变体前景色
  7. 轮廓变体
  8. 主色容器
  9. 主色容器前景色
  10. 表面变体前景色

状态 ​

状态是用于传达组件或交互元素当前状态的视觉表示。详细了解交互状态

详细了解列表焦点

默认列表项 ​


浅色和深色模式下的 6 个默认列表状态。
  1. 已启用
  2. 已禁用
  3. 悬停
  4. 聚焦
  5. 按压
  6. 拖动

选中的列表项 ​


浅色和深色模式下的 6 个选中列表状态。
  1. 已启用
  2. 已禁用
  3. 悬停
  4. 聚焦
  5. 按压
  6. 拖动

尺寸与间距 ​

列表项的尺寸和内边距测量。
列表项的对齐、内边距和尺寸测量值。图标按钮采用动态高度,会自动调整以填满列表项高度。

形状变形

选中列表项时,边角形状会发生变化,以突出显示活动列表项:

  • 未选中时的圆角半径:内侧 4dp,外侧 16dp
  • 选中时的圆角半径:16dp
一个包含 3 个列表项的列表。中间列表项未选中,圆角半径为 4dp。
未选中的列表项内侧圆角半径为 4dp,外侧圆角半径为 16dp
一个包含 3 个列表项的列表。中间列表项已选中,圆角半径为 16dp。
选中的列表项四周圆角半径均为 16dp

列表(基线) ​

基线基线变体是 M3 的原始组件设计,可能不包含 M3 Expressive 引入的最新功能,例如更新的动效、形状、字体排印和样式。详细了解 M3 Expressive列表变体仍然可用,并可在现有产品中继续使用。但对于新设计,推荐使用表现力列表变体。

令牌和规格 ​

基线列表 令牌设计令牌是所有 UI 元素的基础。设计、工具和代码中使用相同的令牌。详细了解令牌位于 common 令牌集中。

TIP

该令牌集还包含部分表现力令牌。

主题
对比度

颜色 ​

颜色值通过设计令牌实现。对设计师而言,这意味着使用与令牌对应的颜色值;在实现中,颜色值以引用具体取值的令牌形式出现。详细了解设计令牌

浅色和深色模式下的 9 个基线列表元素颜色角色。

用于浅色和深色主题的列表颜色角色:

  1. 表面
  2. 表面前景色
  3. 表面变体前景色
  4. 表面变体前景色
  5. 表面变体前景色
  6. 轮廓变体
  7. 主色容器
  8. 主色容器前景色
  9. 表面变体前景色

状态 ​

状态是用于传达组件或交互元素当前状态的视觉表示。

浅色和深色模式下的 6 个基线列表状态。
  1. 已启用
  2. 已禁用
  3. 悬停
  4. 聚焦
  5. 按压
  6. 拖动

布局 ​

单行列表 ​


具有单行文本的基线列表项的对齐、内边距和尺寸规格。
基线单行列表的对齐、内边距和尺寸测量值

包含 3 个列表项、每个列表项 1 行文本的列表的测量值。
基线列表项的测量值和内边距

双行列表 ​


具有双行文本的基线列表项的对齐、内边距和尺寸规格。
基线双行列表的对齐、内边距和尺寸测量值

包含 3 个列表项、每个列表项 2 行文本的列表的测量值。
基线列表项的测量值和内边距

三行列表 ​


具有三行文本的基线列表项的对齐、内边距和尺寸规格。
基线三行列表的对齐、内边距和尺寸测量值

包含 3 个列表项、每个列表项 3 行文本的列表的测量值。
基线列表项的测量值和内边距

属性值
标签对齐居中对齐
高度为 88dp 或更高时的标签对齐顶部对齐
标签左内边距16dp
前置元素对齐(垂直)垂直居中
高度为 88dp 或更高时的前置元素对齐(垂直)顶部对齐
前置元素左内边距16dp
前导图标对齐(垂直)顶部对齐
前导图标顶部内边距8dp
高度为 88dp 或更高时的前导图标顶部内边距12dp
后置元素对齐(垂直)垂直居中
高度为 88dp 或更高时的后置元素对齐(垂直)顶部对齐
后置元素左内边距16dp
后置元素右内边距24dp
分隔线上方和下方的内边距0dp
触控目标48dp
分隔线宽度(全宽)100%
分隔线缩进左内边距16dp
分隔线缩进右内边距24dp

配置 ​

前置头像 ​


深色模式下,包含或不包含前置头像和后置复选框的单行、双行和三行列表项。
  1. 包含前置头像
  2. 包含前置头像和后置复选框

前置图片或缩略图 ​


深色模式下,包含或不包含前置图片和后置复选框的单行、双行和三行列表项。
  1. 包含前置图片
  2. 包含前置图片和后置复选框

前置视频 ​


深色模式下,包含或不包含前置视频和后置复选框的单行、双行和三行列表项。
  1. 包含前置视频
  2. 包含前置视频和后置复选框

前导图标 ​


深色模式下,包含或不包含前导图标和后置复选框的单行、双行和三行列表项。
  1. 包含前导图标
  2. 包含前导图标和后置复选框

纯文本 ​


深色模式下,包含或不包含后置复选框的单行、双行和三行纯文本列表项。
  1. 仅包含文本
  2. 包含文本和后置复选框

前置复选框 ​


深色模式下,包含或不包含前置复选框和后置文本的单行、双行和三行列表项。
  1. 包含前置复选框
  2. 包含前置复选框和后置文本

前置单选按钮 ​


深色模式下,包含或不包含前置单选按钮和后置文本的单行、双行和三行列表项。
  1. 包含前置单选按钮
  2. 包含前置单选按钮和后置文本

后置开关 ​


深色模式下,包含或不包含前导图标和后置开关的单行、双行和三行列表项。
  1. 包含后置开关
  2. 包含前导图标和后置开关
Pager
上一页列表:概览
下一页列表:指南

基于 Apache 2.0 许可证 或 CC BY 4.0 发布。

Copyright © 2018-Present Google

https://m3.material.io/components/lists/specs

基于 Apache 2.0 许可证 或 CC BY 4.0 发布。

Copyright © 2018-Present Google