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 中输入文本。

令牌与规格 ​

查看组件元素、属性、令牌及其取值。了解设计令牌

文本框:填充式 ​

主题
对比度

文本框:描边式 ​

主题
对比度

填充式文本框 ​

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

填充式文本框颜色 ​

颜色值通过 设计令牌设计令牌是所有 UI 元素的基本构建块。设计、工具和代码使用同一套令牌。详细了解设计令牌 实现:在设计稿中使用与令牌对应的颜色值,在代码中使用引用具体值的令牌。详细了解设计令牌

填充式文本框示意图,标注颜色映射。

浅色和深色方案下填充式文本框的颜色角色:

  1. 最高级表面容器
  2. 表面变体之上
  3. 表面变体之上
  4. 主色
  5. 表面变体之上
  6. 主色
  7. 主色
  8. 表面之上
  9. 表面变体之上
  10. 表面之上

填充式文本框状态 ​

状态以视觉方式表示组件或交互元素的当前状况。详细了解交互状态

空置和有内容的填充式文本框在不同状态下的并排视图,对比已启用、已聚焦、悬停和已禁用状态。
  1. 已启用(空置)
  2. 已聚焦(空置)
  3. 悬停(空置)
  4. 已禁用(空置)
  5. 已启用(有内容)
  6. 已聚焦(有内容)
  7. 悬停(有内容)
  8. 已禁用(有内容)

填充式文本框错误状态 ​

错误状态状态表示组件或 UI 元素的交互状态。详细了解状态以视觉方式表示组件或交互元素的出错状况。错误消息用于说明如何修复错误;在错误修复前,错误消息作为辅助文本显示在文本框下方。

空置和有内容的填充式文本框在不同错误状态下的并排视图,对比已启用、已聚焦和悬停状态。
  1. 已启用(空置)
  2. 已聚焦(空置)
  3. 悬停(空置)
  4. 已启用(有内容)
  5. 已聚焦(有内容)
  6. 悬停(有内容)

填充式文本框测量值 ​


显示无图标填充式文本框的布局值和内边距的示意图。
无图标时的内边距与尺寸

显示带有前置和尾部图标的填充式文本框的布局值和内边距的示意图。
有图标时的内边距与尺寸

显示辅助文本,以及辅助文本与字符计数组合的布局值和内边距的示意图。
有辅助文本和字符计数时的内边距与尺寸

属性值
默认容器高度56dp
标签对齐(无输入内容时)垂直居中
上下内边距8dp
无图标时的左右内边距16dp
有图标时的左右内边距12dp
图标对齐垂直居中
图标与文本之间的内边距16dp
辅助文本和字符计数器的顶部内边距4dp
辅助文本与字符计数器之间的内边距16dp
触控目标尺寸56dp

填充式文本框配置 ​


不同配置下填充式文本框的并排视图。

填充式文本框在空置和有内容状态下支持以下配置:

  1. 辅助文本
  2. 尾部图标
  3. 前导图标
  4. 前置和尾部图标
  5. 前缀
  6. 后缀
  7. 多行文本框

描边式文本框 ​

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

描边式文本框颜色 ​

颜色值通过 设计令牌设计令牌是所有 UI 元素的基本构建块。设计、工具和代码使用同一套令牌。详细了解设计令牌 实现:在设计稿中使用与令牌对应的颜色值,在代码中使用引用具体值的令牌。详细了解设计令牌

描边式文本框示意图,标注颜色映射。

浅色和深色方案下描边式文本框的颜色角色:

  1. 描边色
  2. 表面变体之上
  3. 表面变体之上
  4. 主色
  5. 表面变体之上
  6. 主色
  7. 主色
  8. 表面之上
  9. 表面变体之上

描边式文本框状态 ​

状态以视觉方式表示组件或交互元素的当前状况。详细了解交互状态

空置和有内容的描边式文本框在不同状态下的并排视图,对比已启用、已聚焦、悬停和已禁用状态。
  1. 已启用(空置)
  2. 已聚焦(空置)
  3. 悬停(空置)
  4. 已禁用(空置)
  5. 已启用(有内容)
  6. 已聚焦(有内容)
  7. 悬停(有内容)
  8. 已禁用(有内容)

描边式文本框错误状态 ​

错误状态状态表示组件或 UI 元素的交互状态。详细了解状态以视觉方式表示组件或交互元素的出错状况。错误消息用于说明如何修复错误;在错误修复前,错误消息作为辅助文本显示在文本框下方。

空置和有内容的描边式文本框在不同错误状态下的并排视图,对比已启用、已聚焦和悬停状态。
  1. 已启用(空置)
  2. 已聚焦(空置)
  3. 悬停(空置)
  4. 已启用(有内容)
  5. 已聚焦(有内容)
  6. 悬停(有内容)

描边式文本框测量值 ​


显示无图标描边式文本框的布局值和内边距的示意图。
无图标时的内边距与尺寸

显示带有前置和尾部图标的描边式文本框的布局值和内边距的示意图。
有图标时的内边距与尺寸

显示辅助文本,以及辅助文本与字符计数组合的布局值和内边距的示意图。
有辅助文本和字符计数时的内边距与尺寸

属性值
容器高度56dp
无图标时的左右内边距16dp
有图标时的左右内边距12dp
图标与文本之间的内边距16dp
图标对齐垂直居中
辅助文本和字符计数器的顶部内边距4dp
辅助文本与字符计数器之间的内边距16dp
标签对齐垂直居中
有内容时标签文本的左右内边距4dp
触控目标尺寸56dp

描边式文本框配置 ​


不同配置下描边式文本框的并排视图。

描边式文本框在空置和有内容状态下支持以下配置:

  1. 辅助文本
  2. 尾部图标
  3. 前导图标
  4. 前置和尾部图标
  5. 前缀
  6. 后缀
  7. 多行文本框
Pager
上一页文本框:概览
下一页文本框:指南

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

Copyright © 2018-Present Google

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

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

Copyright © 2018-Present Google