文本框:规格
文本框允许用户在 UI 中输入文本。
令牌与规格
查看组件元素、属性、令牌及其取值。了解设计令牌
文本框:填充式
文本框:描边式
填充式文本框

- 容器
- 前导图标(可选)
- 空字段中的标签文本
- 有内容字段中的标签文本
- 尾部图标(可选)
- 聚焦状态下的激活指示器
- 文本光标
- 输入文本
- 辅助文本(可选)
- 启用状态下的激活指示器
填充式文本框颜色
颜色值通过 设计令牌 实现:在设计稿中使用与令牌对应的颜色值,在代码中使用引用具体值的令牌。详细了解设计令牌

浅色和深色方案下填充式文本框的颜色角色:
- 最高级表面容器
- 表面变体之上
- 表面变体之上
- 主色
- 表面变体之上
- 主色
- 主色
- 表面之上
- 表面变体之上
- 表面之上
填充式文本框状态
状态以视觉方式表示组件或交互元素的当前状况。详细了解交互状态

- 已启用(空置)
- 已聚焦(空置)
- 悬停(空置)
- 已禁用(空置)
- 已启用(有内容)
- 已聚焦(有内容)
- 悬停(有内容)
- 已禁用(有内容)
填充式文本框错误状态
错误状态以视觉方式表示组件或交互元素的出错状况。错误消息用于说明如何修复错误;在错误修复前,错误消息作为辅助文本显示在文本框下方。

- 已启用(空置)
- 已聚焦(空置)
- 悬停(空置)
- 已启用(有内容)
- 已聚焦(有内容)
- 悬停(有内容)
填充式文本框测量值



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

填充式文本框在空置和有内容状态下支持以下配置:
- 辅助文本
- 尾部图标
- 前导图标
- 前置和尾部图标
- 前缀
- 后缀
- 多行文本框
描边式文本框

- 启用状态下的容器描边
- 前导图标(可选)
- 空字段中的标签文本
- 有内容字段中的标签文本
- 尾部图标(可选)
- 聚焦状态下的容器描边
- 文本光标
- 输入文本
- 辅助文本(可选)
描边式文本框颜色
颜色值通过 设计令牌 实现:在设计稿中使用与令牌对应的颜色值,在代码中使用引用具体值的令牌。详细了解设计令牌

浅色和深色方案下描边式文本框的颜色角色:
- 描边色
- 表面变体之上
- 表面变体之上
- 主色
- 表面变体之上
- 主色
- 主色
- 表面之上
- 表面变体之上
描边式文本框状态
状态以视觉方式表示组件或交互元素的当前状况。详细了解交互状态

- 已启用(空置)
- 已聚焦(空置)
- 悬停(空置)
- 已禁用(空置)
- 已启用(有内容)
- 已聚焦(有内容)
- 悬停(有内容)
- 已禁用(有内容)
描边式文本框错误状态
错误状态以视觉方式表示组件或交互元素的出错状况。错误消息用于说明如何修复错误;在错误修复前,错误消息作为辅助文本显示在文本框下方。

- 已启用(空置)
- 已聚焦(空置)
- 悬停(空置)
- 已启用(有内容)
- 已聚焦(有内容)
- 悬停(有内容)
描边式文本框测量值



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

描边式文本框在空置和有内容状态下支持以下配置:
- 辅助文本
- 尾部图标
- 前导图标
- 前置和尾部图标
- 前缀
- 后缀
- 多行文本框