Skip to content
Material Design 2
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

Material 系统

简介

Material 案例研究

关于 Material 案例研究

Basil

Crane

Fortnightly

Owl

Rally

Reply

Shrine

Material 基础

环境

表面

海拔(Elevation)

光与阴影

布局

了解布局

像素密度

响应式布局网格

间距方法

组件行为

应用密度

导航

了解导航

导航转场

搜索

颜色

色彩系统

为 UI 应用颜色

颜色的使用

文本可读性

深色主题

字体排印

字体系统

理解字体排印

语言支持

声音

关于声音

将声音应用于 UI

声音属性

声音编排

图标

产品图标

系统图标

动画图标

形状

关于形状

形状与层级

形状即表达

形状与动效

将形状应用于 UI

动效

理解动效

动效系统

速度

编排(Choreography)

自定义

交互

手势

选择

状态

沟通

确认与告知

数据格式

数据可视化

空状态

帮助与反馈

图像

启动屏幕

新手引导

离线状态

文案写作

机器学习

机器学习模式

物体检测:实时相机

对象检测:静态图片

条形码扫描

Material 指南

Material 主题化

概述

实现你的主题

可用性

无障碍

双向性

平台指南

Android 系统栏

Android 指纹

Android 触觉反馈

Android 图标

Android 应用间导航

Android 通知

Android 权限

Android 切片

Android 分屏

Android 下拉刷新

Android 文本选择工具栏

Android 小组件

跨平台适配

组件

底部应用栏

顶部应用栏

背景板

横幅

底部导航

按钮

按钮:浮动操作按钮

卡片

复选框

标签(Chips)

数据表

日期选择器

对话框

分隔线

图片列表

列表

菜单

导航抽屉

导航轨道

进度指示器

单选按钮

底部工作表

侧边工作表(Sheets: side)

滑块

提示条

开关

标签页

文本框

时间选择器

工具提示

页面导航

文本框 ​

文本框供用户输入和编辑文本。

交互式演示 ​

您可以通过此演示预览文本框组件、其变体形式以及各项配置选项。每个标签页对应一种类型的文本框。

用法 ​

文本框允许用户在界面中输入文本,通常出现在表单和对话框中。

设计原则 ​


文本框原则:易于发现

易于发现

文本框应足够醒目,让用户一眼就能看出可以在此输入信息。

文本框原则:清晰

清晰

文本框的各个状态之间应有明确的视觉区分。

文本框原则:高效

高效

文本框应让用户易于理解需要输入什么信息,并便于纠正输入错误。

类型 ​

文本框分为两种类型:

  • 填充式文本框
  • 描边式文本框

这两种类型都通过容器为交互提供清晰的视觉提示,使字段在页面布局中更易被发现。

填充式文本框和描边式文本框示意图
1. 填充式文本框
2. 描边式文本框

选择合适的文本框 ​

两种类型的文本框在功能上完全相同,因此选用哪种类型取决于样式偏好。

请选择符合以下条件的类型:

  • 与您应用的视觉风格最匹配
  • 最契合您 UI 的设计目标
  • 与其他组件(如按钮)及周围内容的视觉差异最大

使用填充式文本框的移动端表单
使用填充式文本框的移动端表单
使用描边式文本框的同一移动端表单
使用描边式文本框的同一移动端表单

在同一 UI 中使用两种类型的文本框 ​

如果需要在同一 UI 中同时使用两种类型的文本框,应在不同区域内分别保持一致,避免在同一区域内混用。例如,可以在一个区域使用描边式文本框,在另一个区域使用填充式文本框。

推荐:在 UI 中同时使用两种类型的文本框时,按区域分开使用

推荐

在 UI 中同时使用两种类型的文本框时,应按区域分开使用。
不推荐:使用两种类型的文本框时,不要将两者并排放置,或在同一表单内混用

不推荐

在使用两种类型的文本框时,不要将两者并排放置,也不要在同一表单内混用。

结构 ​

容器、前导图标、标签文本、输入文本、尾部图标、激活指示器、辅助文本示意图
1. 容器
2. 前导图标(可选)
3. 标签文本
4. 输入文本
5. 尾部图标(可选)
6. 激活指示器
7. 辅助文本(可选)

容器 ​


容器通过在文本框与周围内容之间形成对比,来提升文本框的可发现性。

填充与描边

文本框容器具有填充和描边(描边可以围绕整个容器,也可以仅位于底边)。描边的颜色和粗细会随状态变化,以表明文本框当前是否处于激活状态。

圆角

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

文本框容器
文本框容器

标签文本 ​

标签文本用于告知用户文本框需要输入什么信息。每个文本框都应有一个标签。

标签文本应与输入行对齐,并始终保持可见。它既可以位于文本框中部,也可以位于容器顶部附近。

推荐

标签文本应始终可见;当字段获得焦点时,它会从文本框中部移动到顶部。

不推荐:标签文本不应被截断

不推荐

标签文本不应被截断,应保持简短、清晰且完全可见。
不推荐:标签文本不应占用多行

不推荐

标签文本不应占用多行。

必填项标识 ​

要表示某个字段为必填项,请在标签文本旁显示一个星号(*),并在表单附近说明星号代表必填字段。

  • 如果部分字段是必填的,则应标出所有必填字段
  • 如果大多数字段都是必填的,则在可选字段的标签文本旁用括号标注“可选”
  • 如果必填文本使用了颜色,星号也应使用相同的颜色
带星号的必填文本
带星号的必填文本

输入文本 ​


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

1. 输入文本
输入文本是用户输入的文本。

2. 光标
光标指示字段中当前的文本输入位置。

辅助元素 ​


辅助元素为文本框中输入的内容提供补充信息
辅助元素为文本框中输入的内容提供补充信息。

1. 辅助文本
辅助文本为输入字段提供额外的指导信息,例如说明该字段的用途。它应只占一行,可以持续可见,也可以仅在字段获得焦点时可见。

2. 错误消息
当输入的文本不符合要求时,错误消息可以说明修复方法。错误消息显示在输入行下方,替换辅助文本,直到问题被修复。

3. 图标
图标也可以用来传达提醒信息。将图标与错误消息搭配使用可以提供冗余提醒,这在需要兼顾色盲用户时非常有用。

4. 字符计数器
当存在字符数或字数限制时,应使用字符计数器或字数计数器。它们显示已输入字符数与总字符上限之间的比例。

错误文本 ​

对于需要验证内容的文本框(如密码),在适用时应将辅助文本替换为错误文本。这种替换方式可以避免在布局中新增文本行,从而防止内容因挤压而发生位移。

  • 如果只可能出现一种错误,错误文本应描述如何避免该错误
  • 如果可能出现多种错误,错误文本应描述如何避免其中最有可能发生的错误

推荐

将辅助文本替换为错误文本。

不推荐

不要将错误文本放置在辅助文本下方,否则会导致内容发生位移。

注意:如果没有足够的空间清晰描述错误,较长的错误信息可能会换行显示为多行

注意

如果空间不足以清晰描述错误,较长的错误信息可能会换行显示为多行。在这种情况下,应确保文本框之间有足够的间距,以免多行错误信息挤压布局中的其他内容。

图标 ​

文本框中的图标是可选的。图标可以说明允许的输入方式(如麦克风图标)、提供额外功能的入口(如清空字段内容),以及表示错误状态。

前导图标和尾部图标会根据环境是 LTR(从左到右)还是 RTL(从右到左)来调整自身位置。

图标指示符可以描述文本框所需的输入类型,并可作为嵌套组件的触控目标
1. 图标指示符
图标指示符可以描述文本框所需的输入类型,并可作为嵌套组件的触控目标。例如,点击日历图标可以显示日期选择器。

2. 有效或错误图标
图标既可以指示输入有效,也可以指示输入无效,从而让色盲用户也能清楚识别错误状态。

3. 清除图标
清除图标让用户可以一键清空整个输入字段,仅在字段含有输入文本时才会显示。

4. 语音输入图标
麦克风图标表示用户可以通过语音输入字符。

5. 下拉图标
下拉箭头表示该文本框包含嵌套的选择组件。

镜像元素

对于从右到左(RTL)阅读的语言(如阿拉伯语和希伯来语),其界面应进行镜像处理,以确保内容易于理解。

相关文章

行为 ​

缩放与自适应 ​

随着布局适配更大的屏幕和不同的设备形态,应为文本框采用灵活的容器尺寸。在布局缩放时,为边距、内边距和容器尺寸设置最小值和最大值,使字体排印随之调整,获得更好的阅读体验。

文本框在小屏幕上可以横跨屏幕的整个宽度
文本框在小屏幕上可以横跨屏幕的整个宽度,但在较大屏幕上应受灵活边距或其他容器的约束。

当文本框在流式布局中扩展时,应避免始终沿用固定的边距和字体排印属性,否则会导致文本框过长。例如,文本框不应横跨大屏幕的整个宽度。

填充式文本框 ​

用法 ​

填充式文本框比描边式文本框具有更强的视觉强调效果,能在周围内容和组件的映衬下更加突出。

填充式文本框

避免:不要将文本框设计得与按钮相似,以免被误认为是按钮

不推荐

不要将文本框设计得与按钮相似,以免被误认为是按钮。

紧凑型文本框 ​

紧凑型文本框便于用户浏览大量信息并快速执行操作。

包含紧凑型文本框的表单
包含紧凑型文本框的表单

带标签的紧凑型文本框、不带标签的紧凑型文本框示意图
1. 带标签的紧凑型文本框
2. 不带标签的紧凑型文本框

无标签的文本框 ​

如果字段的用途已由旁边单独的标签标明,则文本框可以不带标签。

带有相邻标签的文本框
带有相邻标签的文本框

前缀和后缀文本 ​


带有货币符号前缀的文本框
带有货币符号前缀的文本框。
带有质量单位后缀的文本框
带有质量单位后缀的文本框。

以评分等级作为后缀的文本框
以评分等级作为后缀的文本框。
带有电子邮箱域名后缀的文本框
带有电子邮箱域名后缀的文本框。

状态 ​

填充式文本框(基准) ​


填充式文本框可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用
填充式文本框可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用。

无标签的填充式文本框 ​


填充式文本框(无标签)可以显示以下状态:未激活
填充式文本框(无标签)可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用。

带前缀文本的填充式文本框 ​


填充式文本框(带前缀文本)可以显示以下状态:未激活
填充式文本框(带前缀文本)可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用。

带后缀文本的填充式文本框 ​


填充式文本框(带后缀文本)可以显示以下状态:未激活
填充式文本框(带后缀文本)可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用。

描边式文本框 ​

用法 ​

描边式文本框比填充式文本框的视觉强调效果更弱。当多个文本框集中出现在表单等场景中时,较弱的视觉强调有助于简化页面布局。

描边式文本框

紧凑型文本框 ​

紧凑型文本框便于用户浏览大量信息并快速执行操作。

包含紧凑型文本框的表单
包含紧凑型文本框的表单

紧凑型文本框,高度为 40dp
紧凑型文本框,高度为 40dp

无标签的文本框 ​

如果字段的用途已由旁边单独的标签标明,则文本框可以不带标签。

带有独立但清晰的标签的文本框可以表明字段的用途(标题、价格和地点)
带有独立且清晰的标签的文本框可以表明字段的用途(标题、价格和地点)。

前缀和后缀文本 ​


带有货币符号前缀的文本框
带有货币符号前缀的文本框
带有质量单位后缀的文本框
带有质量单位后缀的文本框

以评分等级作为后缀的文本框
以评分等级作为后缀的文本框
带有电子邮箱域名后缀的文本框
带有电子邮箱域名后缀的文本框

状态 ​

描边式文本框(基准) ​


描边式文本框可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用
描边式文本框可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用。

无标签的描边式文本框 ​


描边式文本框可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用
描边式文本框可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用。

带前缀文本的描边式文本框 ​


描边式文本框可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用
描边式文本框可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用。

带后缀文本的描边式文本框 ​


描边式文本框可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用
描边式文本框可以显示以下状态:未激活、已激活、聚焦、悬停、错误和禁用。

输入类型 ​

文本框可以通过以下几种方式呈现用户输入:

  • 单行文本框 仅显示一行文本
  • 多行文本框 会自动扩展以容纳多行文本
  • 文本区域 是高度固定的字段
单行字段
在单行字段中,当光标到达字段右边缘时,超出输入行长度的文本会自动向左滚动。

单行字段不适合收集较长的回复内容。对于这类内容,请改用多行文本框或文本区域。

多行字段
多行文本框会同时显示用户输入的所有文本。溢出的文本会使字段向下扩展(并推动下方元素),文本随之自动换行。

这类字段最初显示为单行,因此非常适合需要容纳大量文本的紧凑布局。
文本区域
文本区域比文本框更高,会将溢出的文本换行显示。其高度固定,当光标到达字段底部时,内容会垂直滚动。

较大的初始尺寸表明该字段支持并鼓励输入较长的回复内容。

在网页端应使用文本区域,而不是多行字段。请确保文本区域的高度适合移动端屏幕尺寸。

只读字段 ​

只读文本框显示用户无法编辑的预填充文本。其样式与普通文本框相同,但会明确标注为只读。

填充式只读文本框
填充式只读文本框。
轮廓式只读文本框
轮廓式只读文本框。

研究 ​

Material Design 开展了两项研究,共有约 600 名参与者,旨在了解文本框可用性的关键特征以及用户对文本框设计的偏好。这些研究测量了用户快速浏览并定位文本框的能力,以及识别文本框类型的能力。

研究表明,以下最佳实践有助于提升文本框的可用性:

  • 使用带矩形边框的包围式文本框,而不是仅用一条下划线来表示文本框
  • 文本框框可以采用半透明填充加底边线,或全透明填充加不透明描边
  • 将标签文本放置在文本框边界之内
  • 确保文本框的轮廓或描边与背景之间的颜色对比度不低于 3:1

文本框的演进

用户研究如何重塑了 Google 开源文本框的设计。

相关链接

主题定制 ​

Rally Material 主题 ​

这款个人理财应用的填充式文本框已通过 Material Theming 进行了自定义,涵盖颜色和字体排印两个方面。

Rally 自定义的填充式文本框
Rally 自定义的填充式文本框

Rally

Rally 是一款个人理财应用,展示了如何将 Material Design 应用于金融领域。

相关文章

颜色 ​

Rally 的填充式文本框在五个元素上使用了自定义颜色:标签文本、输入文本、尾部图标、激活指示器和容器。

Rally Material 主题:颜色
元素类别属性值
标签文本Primary颜色
不透明度
#FFFFFF
100%
输入文本On Surface颜色
不透明度
#FFFFFF
100%
尾部图标On Surface颜色
不透明度
#FFFFFF
100%
激活指示器Primary颜色
不透明度
#FFFFFF
100%
容器On Surface颜色
不透明度
#FFFFFF
4%

色彩系统

创建能够体现您的品牌或风格的颜色主题

相关文章

将颜色应用于 UI

在 UI 中,颜色扮演着多种角色:从传达含义,到表达外观和观感。

相关文章

字体排印 ​

Rally 的填充式文本框对输入文本和标签文本使用了自定义字体排印。

Rally Material 主题:字体排印
元素类别属性值
输入文本Subtitle 1字体族
字体
字号
大小写
Eczar
Regular
16
标题式大小写
标签文本Caption字体族
字体
字号
大小写
Roboto Condensed
Regular
12
标题式大小写

理解字体排印

字体排印对于建立层级结构和体现品牌形象至关重要,有助于打造有效的数字体验。

相关文章

形状 ​

Rally 的填充式文本框使用了自定义的边角形状。

Rally Material 主题:形状
元素类别属性值
容器小型组件类型
尺寸
切角
0;0;0;0 dp

Crane Material 主题 ​

这款旅行应用的描边式文本框已通过 Material Theming 进行了自定义,涵盖颜色和字体排印两个方面。

Crane 自定义的描边式文本框
Crane 自定义的描边式文本框

Crane

一款旅行应用,使用 Material Design 组件和 Material Theming 打造个性化且符合品牌调性的体验。

相关链接

颜色 ​

Crane 的描边式文本框在三个元素上使用了自定义颜色:输入文本、标签文本和容器。

Crane Material 主题:颜色
元素类别属性值
输入文本On Surface颜色
不透明度
#000000
87%
标签文本On Surface颜色
不透明度
#000000
60%
容器On Surface颜色
不透明度
#000000
12%

将颜色应用于 UI

在 UI 中,颜色扮演着多种角色:从传达含义,到表达外观和观感。

相关文章

色彩系统

创建能够体现您的品牌或风格的颜色主题

相关文章

字体排印 ​

Crane 的描边式文本框对输入文本和标签文本使用了自定义字体排印。

Crane Material 主题:字体排印
元素类别属性值
输入文本Subtitle 1字体族
字体
字号
大小写
Raleway
Medium
16
标题式大小写
标签文本Caption字体族
字体
字号
大小写
Raleway
SemiBold
14
标题式大小写

理解字体排印

字体排印对于建立层级结构和体现品牌形象至关重要,有助于打造有效的数字体验。

相关文章

形状 ​

Crane 的描边式文本框使用了自定义的边角形状。

Crane Material 主题:形状
元素类别属性值
容器小型组件类型
尺寸
切角
4;4;4;4 dp

规格说明 ​

填充式文本框 ​


填充式文本框规格

填充式文本框规格

填充式文本框规格

描边式文本框 ​


描边式文本框规格

描边式文本框规格

描边式文本框规格
Pager
上一页标签页
下一页时间选择器

基于 Apache-2.0 许可证 发布。

Copyright © 2018-Present Google

https://m2.material.io/components/text-fields

基于 Apache-2.0 许可证 发布。

Copyright © 2018-Present Google