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):无障碍

图标按钮:概述

图标按钮:规格

图标按钮:指南

图标按钮:无障碍

分段按钮:概览

分段按钮:规格

分段按钮:指南

分段按钮:无障碍

拆分按钮:概览

拆分按钮:规格

拆分按钮:指南

拆分按钮:无障碍

卡片:概览

卡片:规格

卡片:指南

卡片:无障碍

轮播:概览

轮播:规格

轮播:指南

轮播:无障碍

复选框:概览

复选框:规格

复选框:指南

复选框:无障碍

芯片:概览

芯片:规格

芯片:指南

芯片:无障碍

日期和时间选择器

日期选择器:概览

日期选择器:规格

日期选择器:指南

日期选择器:无障碍

时间选择器:概览

时间选择器:规格

时间选择器:指南

时间选择器:无障碍

对话框:概览

对话框:规格

对话框:指南

对话框:无障碍

分隔线:概览

分隔线:规格

分隔线:指南

分隔线:无障碍

列表:概览

列表:规格

列表:指南

列表:无障碍

加载和进度

加载指示器:概览

加载指示器:规格

加载指示器:指南

加载指示器:无障碍

进度指示器:概览

进度指示器:规格

进度指示器:指南

进度指示器:无障碍

菜单:概览

菜单:规格

菜单:指南

菜单:无障碍

导航

导航栏:概述

导航栏:规格

导航栏:指南

导航栏:无障碍

导航抽屉:概览

导航抽屉:规格

导航抽屉:指南

导航抽屉:无障碍

导航轨道:概览

导航轨道:规格

导航轨道:指南

导航轨道:无障碍

单选按钮:概述

单选按钮:规格

单选按钮:指南

单选按钮:无障碍

搜索:概览

搜索:规格

搜索:指南

搜索:无障碍

工作表

底部工作表:概览

底部工作表:规格

底部工作表:指南

底部工作表:无障碍

侧边工作表:概览

侧边工作表:规格

侧边工作表:指南

侧边工作表:无障碍

滑块:概览

滑块:规格

滑块:指南

滑块:无障碍

提示条:概览

提示条:规格

提示条:指南

提示条:无障碍

开关:概览

开关:规格

开关:指南

开关:无障碍

标签页:概览

标签页:规格

标签页:指南

标签页:无障碍

文本框:概览

文本框:规格

文本框:指南

文本框:无障碍

工具栏:概览

工具栏:规格

工具栏:指南

工具栏:无障碍

工具提示:概览

工具提示:规格

工具提示:指南

工具提示:无障碍

页面导航

列表:无障碍 ​

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

用例 ​

用户应能使用辅助技术执行以下操作:

  • 导航到列表项
  • 选择列表项

除颜色外,使用视觉提示指示选中状态 ​

为确保所有人都能清晰识别已选中的列表项,请不要仅依赖颜色作为唯一视觉提示。

使用额外指示器来表明列表项已选中,例如:

  • 单选按钮单选按钮让用户从一组选项中选择一项。更多关于单选按钮 或 复选框复选框让用户从列表中选择一个或多个列表项,或开启/关闭某个列表项。更多关于复选框
  • 前置或尾部图标
  • 不依赖颜色的视觉样式,例如带下划线的文本
已选中的列表项,带有填充色,并以对勾作为前导图标。
使用两种视觉提示来表明列表项已选中,例如前置对勾和填充色

交互与样式 ​

触摸

当用户点按列表项时,会出现触摸水波纹,作为交互反馈。

当用户点按列表项将其选中时,会出现水波纹效果

指针

指针悬停时,悬停悬停状态表示用户将指针置于交互式元素上方。更多关于悬停状态状态会提供视觉提示,表明该列表项可交互。

一个列表,其中第二个列表项在悬停时外观发生变化,显示指针和更深的填充色。
指针:悬停
已选中的列表项,带有指针、填充色和已勾选复选框。
指针:已选中

键盘与切换控制

当用户按 Tab 键将焦点移至单操作列表时,会出现焦点指示器,以视觉方式提示第一个列表项已聚焦聚焦状态表示用户使用键盘或语音等输入方法高亮了一个元素。更多关于聚焦状态,并可以执行操作。

当用户在已聚焦的列表项上按 Space 键或 Enter 键时,将执行相应操作。

Tab 键导航到列表。Space 键或 Enter 键激活列表项。

滑动

可滑动的列表项应提供替代方式,用于访问隐藏操作,例如 更多图标。

可替代滑动手势的操作包括:

  • 单次点按
  • 两次点按
  • 长按
  • 其他单点触控操作
列表项中有一个已选中的“更多”按钮,用于显示其他操作。
列表项可通过滑动或使用无障碍的次要操作(例如两次点按)来显示更多操作

焦点 ​

单操作列表

列表中的第一个元素应始终获得焦点,除非列表中已有选中项。此时,焦点应移至已选中的列表项。

元素聚焦聚焦状态表示用户使用键盘或语音等输入方法高亮了一个元素。更多关于聚焦状态后,用户应能使用方向键在列表中导航。

第一个列表项自动获得焦点。
Tab 键会将焦点移至第一个列表项或已选中的列表项
使用方向键将焦点移至第二个列表项。
方向键在列表项之间上下导航

所有列表项都必须能够通过 Space 键或 Enter 键激活。

更多关于单操作列表

带有焦点指示器和已勾选复选框的列表项,使用 Space 键或 Enter 键选中。
Space 键或 Enter 键可激活列表中的元素

多操作列表

多操作列表项包含一个主操作和至少一个辅助操作。

整个列表项不可选,只有各个操作可选。

用户应能使用键盘:

  • 使用 Tab 键定位到列表项,此时焦点会移至第一个元素
  • 使用 Up、Down、Left 和 Right 方向键,在列表中的所有可聚焦元素之间移动
  • 使用 Space 键或 Enter 键激活当前聚焦的元素

更多关于多操作列表

多操作列表中的第一个元素自动获得焦点。
Tab 键将焦点移至第一个操作
列表操作(书签)通过 Down 或 Right 方向键获得焦点。
Down 和 Right 方向键将焦点移至列表项的下一个操作,或移至下一个列表项中的第一个操作
第二个列表项中的后置书签图标已聚焦。
Up 和 Left 方向键将焦点移至列表项的上一个操作
第二个列表项的标签文本和辅助文本通过 Up 或 Left 方向键获得焦点。
如果焦点位于列表项的第一个操作上,Up 和 Left 方向键会将焦点移回上一个列表项的最后一个操作
Space 或 Enter 键激活列表项上的溢出菜单。
Space 键或 Enter 键激活列表中已选中的操作

键盘导航 ​

按键操作
Tab将焦点移至第一个列表项、最后一个列表项或列表组件外部
Down 和 Right 方向键移至列表中的下一个元素;如果焦点元素是列表中的最后一个,则循环回到列表顶部
Up 和 Left 方向键移至列表中的上一个元素;如果焦点元素是列表中的第一个,则循环回到列表底部
Space 或 Enter 键选择尚未选中的列表项

为元素添加标签 ​

无障碍无障碍设计使产品能够为具备各种能力的人所用。更多关于无障碍标签与屏幕阅读器等辅助设备配合使用。

列表项的无障碍标签通常与 标签文本 和 辅助文本 一致。

某些标签、角色和状态取决于平台。

已选中的列表项显示标签“面包、酸面包或小麦”。
列表项的 标签文本 和 辅助文本 用作其无障碍标签

特定于平台的标签 ​

单选列表 ​

属性WebAndroid Views (MDC-Android)Jetpack Compose
ARIA 标签

容器标签:应说明选择类型

列表项:应与可见的标签文本一致

列表项:应与可见的标签文本一致列表项:应与可见的标签文本一致
角色容器:列表框 列表项:选项列表项:单选按钮列表项:单选按钮
状态已选择或未选择已勾选或未勾选已勾选或未勾选

多选列表 ​

属性WebAndroid Views (MDC-Android)Jetpack Compose
ARIA 标签

容器标签:应说明选择类型

列表项:应与可见的标签文本一致

列表项:应与可见的标签文本一致列表项:应与可见的标签文本一致
角色容器:列表框 列表项:选项列表项:复选框列表项:复选框
状态已选择或未选择已勾选或未勾选已勾选或未勾选

在 Web 上,列表容器的无障碍标签描述可以进行的选择类型,角色为 列表框。

已选中的列表容器显示标签“选择面包、皮塔饼或米饭”,角色为“列表框”。
在 Web 上,列表容器的角色为 列表框

在 Jetpack Compose 上,角色应用于整个列表项。

如果列表不可选择,则只读出标签文本,不读出角色。

已选中的列表项显示标签“面包、酸面包或小麦”和角色“复选框”。
当可选择时,角色 复选框 应用于 Jetpack Compose 上的整个列表项

在 Android Views (MDC-Android) 上,列表中的组件应按照该组件的特定准则进行标注:

  • 复选框
  • 单选按钮
已选中的列表项的复选框显示标签“面包、酸面包或小麦”和角色“复选框”。
在 Android Views (MDC-Android) 上,无障碍标签和角色默认应用于交互式组件
Pager
上一页列表:指南
下一页加载指示器:概览

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

Copyright © 2018-Present Google

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

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

Copyright © 2018-Present Google