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

图标按钮:概述

图标按钮:规格

图标按钮:指南

图标按钮:无障碍

分段按钮:概览

分段按钮:规格

分段按钮:指南

分段按钮:无障碍

拆分按钮:概览

拆分按钮:规格

拆分按钮:指南

拆分按钮:无障碍

卡片:概览

卡片:规格

卡片:指南

卡片:无障碍

轮播:概览

轮播:规格

轮播:指南

轮播:无障碍

复选框:概览

复选框:规格

复选框:指南

复选框:无障碍

芯片:概览

芯片:规格

芯片:指南

芯片:无障碍

日期和时间选择器

日期选择器:概览

日期选择器:规格

日期选择器:指南

日期选择器:无障碍

时间选择器:概览

时间选择器:规格

时间选择器:指南

时间选择器:无障碍

对话框:概览

对话框:规格

对话框:指南

对话框:无障碍

分隔线:概览

分隔线:规格

分隔线:指南

分隔线:无障碍

列表:概览

列表:规格

列表:指南

列表:无障碍

加载和进度

加载指示器:概览

加载指示器:规格

加载指示器:指南

加载指示器:无障碍

进度指示器:概览

进度指示器:规格

进度指示器:指南

进度指示器:无障碍

菜单:概览

菜单:规格

菜单:指南

菜单:无障碍

导航

导航栏:概述

导航栏:规格

导航栏:指南

导航栏:无障碍

导航抽屉:概览

导航抽屉:规格

导航抽屉:指南

导航抽屉:无障碍

导航轨道:概览

导航轨道:规格

导航轨道:指南

导航轨道:无障碍

单选按钮:概述

单选按钮:规格

单选按钮:指南

单选按钮:无障碍

搜索:概览

搜索:规格

搜索:指南

搜索:无障碍

工作表

底部工作表:概览

底部工作表:规格

底部工作表:指南

底部工作表:无障碍

侧边工作表:概览

侧边工作表:规格

侧边工作表:指南

侧边工作表:无障碍

滑块:概览

滑块:规格

滑块:指南

滑块:无障碍

提示条:概览

提示条:规格

提示条:指南

提示条:无障碍

开关:概览

开关:规格

开关:指南

开关:无障碍

标签页:概览

标签页:规格

标签页:指南

标签页:无障碍

文本框:概览

文本框:规格

文本框:指南

文本框:无障碍

工具栏:概览

工具栏:规格

工具栏:指南

工具栏:无障碍

工具提示:概览

工具提示:规格

工具提示:指南

工具提示:无障碍

页面导航

文本框:指南 ​

文本框让用户可以在 UI 中输入文本。


填充式和描边式文本框的并排视图。
填充式和描边式文本框

用法 ​

当用户需要在 UI 中输入文本时(例如填写联系信息或支付信息),请使用文本框。

包含多个文本框的联系表单的移动端 UI。
使用描边式文本框的联系表单

文本框有两种变体:

  1. 填充式文本框
  2. 描边式文本框

两种变体都通过容器提供交互的视觉提示,并具备相同的功能。

已输入内容和空白内容的填充式文本框并排视图。
填充式文本框
已输入内容和空白内容的描边式文本框并排视图。
描边式文本框

描边式文本框

描边式文本框的视觉突出程度低于填充式文本框填充式文本框的视觉突出程度高于描边式文本框,通常用于对话框和短表单,其样式更易吸引注意力。。当多个文本框一起出现在表单等位置时,较低的视觉突出度有助于简化布局布局指屏幕上元素的视觉排列。有关布局的更多信息。

包含 1 个聚焦和 1 个未聚焦描边式文本框的应用屏幕。
使用描边式文本框的登录屏幕

选择文本框 ​

选择文本框

两种文本框变体功能相同,选择哪种可仅依据样式决定。

选择符合以下条件的变体:

  • 与应用的视觉风格最契合
  • 最能满足 UI 的设计目标
  • 与其他组件(如按钮按钮让用户通过一次点击执行操作或做出选择。有关按钮的更多信息)及周围内容区分最明显
包含多个填充式文本框的联系表单的移动端 UI。
使用填充式文本框的移动端表单
包含多个描边式文本框的联系表单的移动端 UI。
同一个使用描边式文本框的移动端表单

在同一屏幕上使用两种文本框变体

如果 UI 中同时使用两种文本框变体,应在不同区域分别保持一致使用,不要在同一区域内混用。

例如,在一个区域使用描边式文本框描边式文本框的视觉突出程度低于填充式文本框,通常用于长表单,较弱的视觉突出效果有助于简化布局。,在另一个区域使用填充式文本框填充式文本框的视觉突出程度高于描边式文本框,通常用于对话框和短表单,其样式更易吸引注意力。。

包含多个填充式文本框的联系表单移动端 UI,上方有一个使用描边式文本框的已打开对话框。
应 在 UI 中同时使用两种文本框变体时,应按区域分隔
包含描边式和填充式文本框混用的联系表单移动端 UI。
不应 不要将两种变体相邻放置,也不要在同一表单中混用

结构 ​

填充式文本框 ​


填充式文本框的结构图,标示其 10 个组成部分。
  1. 容器
  2. 前导图标(可选)
  3. 字段为空时的标签文本
  4. 字段已输入内容时的标签文本
  5. 尾部图标(可选)
  6. 聚焦状态的活动指示器
  7. 光标
  8. 输入文本
  9. 辅助文本(可选)
  10. 启用状态的活动指示器

描边式文本框 ​


描边式文本框的结构图,标示其 9 个组成部分。
  1. 启用状态的容器轮廓
  2. 字段为空时的标签文本
  3. 前导图标(可选)
  4. 字段已输入内容时的标签文本
  5. 尾部图标(可选)
  6. 聚焦状态的容器轮廓
  7. 光标
  8. 输入文本
  9. 辅助文本(可选)

容器

容器通过形成文本框与周围内容的对比,让文本框更容易被识别。

填充和描边
文本框容器带有填充和描边,描边可环绕整个容器,也可仅位于底部边缘。描边的颜色和粗细会变化,以表示文本框是否处于活动状态。

圆角
描边式文本框的容器为圆角,而填充式文本框的容器顶部为圆角、底部为直角。

填充式和描边式文本框容器的并排视图。
文本框容器

标签文本

标签文本说明用户需要提供什么信息。每个文本框都应有标签。

标签文本应与输入文本对齐并始终可见,可位于文本框中部或靠近容器顶部。

标签文本应简短、清晰且完整可见,不应被截断,也不应占据多行。

标签文本应始终可见。当字段获得焦点时,标签文本会从文本框中部上移到顶部。
标签文本非常长的文本框,长到无法在文本框容器内完整显示。
不应 不要截断标签文本;标签文本应简短、清晰且完整可见。
标签文本被分成 2 行的超长文本框。
不应 标签文本不应占据多行

相邻标签

如果已有独立的相邻标签说明字段用途,文本框内可不再显示标签。

相邻标签应与文本框容器的前置边对齐。

联系表单移动端 UI,其标签文本放置在文本框外部和上方。
带有相邻标签的文本框

必填文本指示器

如需表明字段为必填项,请在标签文本旁显示星号(*),并通过以下任一方式说明星号表示必填字段:

  • 辅助文本
  • 表单开头的一条说明

其他最佳实践包括:

  • 标出所有必填字段
  • 若必填项文本使用特定颜色,星号也应使用相同颜色
联系表单移动端 UI,显示文本框下方的辅助文本,表明某项输入为必填项。
星号及说明必填项的辅助文本

输入文本

输入文本即用户在文本框中输入的文本。

文本框可通过以下方式显示输入文本:

  • 单行文本框仅显示一行文本
  • 多行文本框会扩展以容纳多行文本
  • 文本区域是高度固定的字段
包含已输入文本的文本框。
填充式文本框中的输入文本
在单行字段中,当光标到达字段右侧边缘时,超出单行长度的文本会自动向左滚动。单行字段不适合输入较长回复;请改用多行文本框或文本区域。
在多行字段中,溢出文本会使字段扩展、屏幕元素下移并自动换行。此类字段初始显示为单行,适合需要在紧凑布局中容纳大量文本的场景。
文本区域比文本框更高,并会对溢出文本换行。其高度固定,当光标到达字段底部时会垂直滚动。较大的初始尺寸可提示并鼓励用户输入较长内容。在 Web 上应使用文本区域而非多行文本框,并确保文本区域的高度适合移动屏幕尺寸。

前缀文本

文本框可包含前缀文本,例如货币符号。

输入文本前带有货币符号文本前缀的文本框。
带有货币符号文本前缀的文本框

后缀文本

文本框可包含后缀文本,例如计量单位或电子邮件域名。

输入文本后带有后缀的文本框,表明最大输入值为 100。
带有评分量表后缀的文本框
输入文本后带有后缀的文本框,表明电子邮件地址。
带有电子邮件域名后缀的文本框

辅助文本与字符计数器

辅助文本用于传达与输入字段相关的附加信息,例如它将如何使用。理想情况下为一行,必要时可换行显示。辅助文本可以始终可见,也可仅在聚焦时可见。

如果存在字符数或单词数限制,请提供字符计数器或单词计数器。计数器显示已用字符数(或单词数)与上限的比值。

文本框的并排视图,其中辅助文本与后置对齐,字符计数器也与后置对齐。
  1. 辅助文本
  2. 字符计数器

错误文本

对于需要验证内容的文本框(例如密码字段),请用错误文本替换辅助文本,以避免新增文本行挤压内容或改变布局。

  • 若只可能出现一种错误,错误文本应说明如何避免该错误
  • 若可能出现多种错误,错误文本应说明如何避免最可能发生的错误
应 用错误文本替换辅助文本
不应 不要保留辅助文本的同时另加错误文本,以免错误出现时导致内容移位
注册表单移动端 UI,其中包含无效的文本框输入。错误消息换行为 2 行。
注意 如果空间不足以清楚描述错误,长错误消息可能换行显示。此时请确保文本框之间的间距足够大,以免多行错误挤压布局内容。

错误图标

强烈建议在文本框处于错误状态时显示错误图标。

这有助于视障用户发现错误,并提供额外的感知提示。

包含错误消息的 2 个文本框。处于活动状态的文本框边框更粗。两个文本框都有后置错误图标。
错误图标是表明文本框存在错误的另一重要视觉提示

图标与图像 ​

文本框中的图标为可选项。文本框图标可以:

  • 说明有效的输入输入设备用于为应用提供交互控制,常见设备包括鼠标、键盘和触摸板。方式,例如麦克风图标
  • 提供访问附加功能的交互入口,例如清除字段内容
  • 提示错误

前导图标和尾部图标会根据从左到右(LTR)或从右到左(RTL)的书写方向改变位置。

高度为 24dp 的图像可放置在文本框内部。该高度可确保字段顶部和底部内边距效果最佳,并与图标尺寸建议保持一致。

  1. 图标指示符
    图标指示符可说明文本框所需的输入类型,并可充当嵌套组件的触控目标。例如,点击日历图标可显示日期选择器日期选择器让用户选择一个日期或一个日期范围。有关日期选择器的更多信息。
  2. 有效或错误图标
    图标可指示正确和错误的输入,使色盲用户也能清楚了解错误状态。
  3. 清除图标
    清除图标让用户可清除整个输入字段,仅在存在输入文本时显示。
  4. 语音输入图标
    麦克风图标表示用户可通过语音输入字符。
  5. 下拉图标
    下拉箭头表示文本框内嵌了选择选择功能让用户选择要操作的具体条目。有关选择的更多信息组件。
  6. 图像
    图像有助于说明需要输入的文本内容,例如信用卡号。
不同文本框的并排视图,这些文本框在容器内使用不同图标和图像作为后置元素。
  1. 图标指示符
  2. 有效或错误图标
  3. 清除图标
  4. 语音输入图标
  5. 下拉图标
  6. 图像

只读字段

只读文本框显示用户无法编辑的预填充文本。

只读文本框的样式与常规文本框相同,并明确标记为只读。

只读填充式文本框。
只读填充式文本框
只读描边式文本框。
只读描边式文本框

自适应设计 ​

当布局适应更大的屏幕和不同的断点断点是预设的窗口尺寸,布局会在这些尺寸下变化,以匹配可用空间、设备惯例和人机工程学(以前称为窗口尺寸类别)。有关断点的更多信息时,应为文本框设置灵活的容器尺寸。随着布局缩放,应为边距边距是嵌套元素边缘与其父元素边缘之间的空间,例如按钮标签文本与其容器边缘之间的空间。有关边距的更多信息、内边距和容器尺寸设置最小值和最大值,使字体排印进行调整,以获得更好的阅读体验。

在移动端和平板端并排显示的创建新专辑 UI。
在紧凑断点下,文本框可占据屏幕整个宽度;在中等和扩展断点下,文本框应受灵活边距或其他容器约束。

当文本框在流式布局中扩展时,应避免使用固定边距和字体排印属性,否则可能导致文本框过长。

例如,文本框不应占据大屏幕的整个宽度。

平板端 UI,文本框占据屏幕的整个宽度。
不应 不要在大屏设备上使用固定的文本框边距;文本框不应占据大屏幕的整个宽度。

密度

密集文本框可帮助用户快速浏览大量信息并执行操作。

平板端 UI,密集文本框作为活动创建表单的一部分。
带有密集文本框的表单

避免默认应用密度 ​

不要默认对文本框应用密度,否则其触控目标会小于建议的 48×48 CSS 像素。应为用户提供选择更高密度的方式,例如选择更密集的布局或更改主题。

为确保启用该密度设置后可以轻松还原,请将所有用于切换该设置的触控目标保持在至少 48×48 CSS 像素。

Pager
上一页文本框:规格
下一页文本框:无障碍

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

Copyright © 2018-Present Google

https://m3.material.io/components/text-fields/guidelines

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

Copyright © 2018-Present Google