列表:规格
列表是文本和图片的连续垂直索引。
变体
表现力列表
表现力列表变体可提供更灵活的样式、更醒目的选中状态和可自定义插槽。

基线列表
基线列表仍然可用,但不具备最新的视觉样式、选中样式和插槽功能。
在 Web 上,表现力列表基于基线列表构建。

| 变体 | M3 | M3 Expressive |
|---|---|---|
| 列表(表现力) | -- | 可用 |
| 列表(基线) | 可用 | 不推荐。 请改用表现力列表。 |
配置
样式
标准样式和分段样式仅影响视觉效果,不影响列表行为。

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




列表交互
列表支持:

| 类别 | 配置 | M3 | M3 Expressive |
|---|---|---|---|
| 样式 | 标准 | 可用 | 可用 |
| 分段 | -- | 可用 | |
| 选择模式 | 单操作、多操作、单选、多选 | 可用 | 可用 |
| 交互 | 展开、滑动\* | 可用 | 可用 |
* 滑动显示交互仅在 Android Views 中受支持。
令牌和规格
使用表格菜单选择令牌集。common(通用)令牌集结合了基线令牌与新的表现力形状和尺寸。expand(展开)令牌集包含用于展开交互的令牌。详细了解设计令牌
列表 - 通用
列表 - 展开
结构

容器和标签文本是必需的。所有其他元素都是可选的:
- 容器
- 顶部小标题
- 标签文本
- 后置文本
- 辅助文本
- 尾部图标
- 分隔线
- 前置头像
- 前导图标
- 前置媒体 - 图像或视频
灵活性与插槽
M3 设计套件提供带自定义插槽的列表,以便灵活设计列表项布局。可将自定义列表视为包含三个不同插槽的容器:前置、内容和后置。每个插槽可容纳不同的元素。
插槽的无障碍支持
默认情况下,插槽不提供无障碍支持。请遵循以下建议:
- 元素必须遵循列表的规则、结构和交互模式
- 使用标准列表项内边距
- 触控目标尺寸必须至少为 48x48dp
- 不要添加会让列表项难以导航的交互元素,尤其是对屏幕阅读器用户而言

- 前置插槽
- 内容插槽
- 后置插槽
WARNING
使用插槽需要自行创建并维护自定义代码实现
前置和后置插槽的宽度必须小于内容插槽的宽度。
1. 前置插槽可包含:
- 视觉元素:头像、图标、图像或视频缩略图
- 选择控件:复选框、单选按钮或开关
- 自定义元素:徽标或较大图像
2. 内容插槽必须是宽度最大的插槽,并且可以包含:
- 默认内容:标签文本、辅助文本
- 可选附加项:徽标、图标、内联标签或更多文本元素
- 避免文本行过长,以保持可读性
3. 后置插槽可以包含:
- 操作元素或文本:图标、图标按钮或后置文本
- 选择控件:复选框、单选按钮或开关

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


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

用于浅色和深色主题的列表颜色角色:
- 表面
- 表面变体前景色
- 表面前景色
- 表面变体前景色
- 表面变体前景色
- 表面变体前景色
- 轮廓变体
- 主色容器
- 主色容器前景色
- 表面变体前景色
状态
状态是用于传达组件或交互元素当前状态的视觉表示。详细了解交互状态
默认列表项

- 已启用
- 已禁用
- 悬停
- 聚焦
- 按压
- 拖动
选中的列表项

- 已启用
- 已禁用
- 悬停
- 聚焦
- 按压
- 拖动
尺寸与间距

形状变形
选中列表项时,边角形状会发生变化,以突出显示活动列表项:
- 未选中时的圆角半径:内侧 4dp,外侧 16dp
- 选中时的圆角半径:16dp


列表(基线)
基线列表变体仍然可用,并可在现有产品中继续使用。但对于新设计,推荐使用表现力列表变体。令牌和规格
基线列表 令牌位于 common 令牌集中。
TIP
该令牌集还包含部分表现力令牌。
颜色
颜色值通过设计令牌实现。对设计师而言,这意味着使用与令牌对应的颜色值;在实现中,颜色值以引用具体取值的令牌形式出现。详细了解设计令牌

用于浅色和深色主题的列表颜色角色:
- 表面
- 表面前景色
- 表面变体前景色
- 表面变体前景色
- 表面变体前景色
- 轮廓变体
- 主色容器
- 主色容器前景色
- 表面变体前景色
状态
状态是用于传达组件或交互元素当前状态的视觉表示。

- 已启用
- 已禁用
- 悬停
- 聚焦
- 按压
- 拖动
布局
单行列表


双行列表


三行列表


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

- 包含前置头像
- 包含前置头像和后置复选框
前置图片或缩略图

- 包含前置图片
- 包含前置图片和后置复选框
前置视频

- 包含前置视频
- 包含前置视频和后置复选框
前导图标

- 包含前导图标
- 包含前导图标和后置复选框
纯文本

- 仅包含文本
- 包含文本和后置复选框
前置复选框

- 包含前置复选框
- 包含前置复选框和后置文本
前置单选按钮

- 包含前置单选按钮
- 包含前置单选按钮和后置文本
后置开关

- 包含后置开关
- 包含前导图标和后置开关