1# 文本框
2
3文本框是支持用户输入文本、数字或者混合数据，同时也支持用户选择文本的控件。
4
5
6![116](figures/116.png)
7
8
9## 如何使用
10
11- 输入小文本块使用单行文本框，支持显示带图标、带单位、带号标记必填项、带自动推荐、带帮助文本、带错误信息、字符计数器、格式化输入功能等样式。
12
13- 当文本输入光标到达输入区域最右边，框中内容会自动向左推挤。
14
15- 当文本长度超过文本框宽度时，可在输入框横滑文本，不出现光标。
16
17- 进行有默认推荐文本的操作时（新建文件夹、另存、重命名等），初始状态文本全选，方便删除。若直接保存导致名称重复，使用错误提示。
18
19![标题typing.png](figures/标题typing.png)
20
21- 用户输入错误时，系统给出实时提示，帮助用户修正错误。
22
23| ![输出错误提示1.png](figures/输出错误提示1.png) | ![输出错误提示2.png](figures/输出错误提示2.png) |
24|  --------  |  --------  |
25|密码错误  |密码超长     |
26
27
28错误出现后，禁止提交输入的内容。若系统无法实时给出提示，则在内容提交后给出。输入存在错误时，可在输入框下方显示错误信息，说明如何修复。
29
30
31## 资源
32
33文本框相关的开发者文档详见基础组件[“TextInput”](https://gitee.com/openharmony/docs/blob/6e831661fb6f714a9492084baa552a4af4617c65/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textinput.md)和[“TextArea”](https://gitee.com/openharmony/docs/blob/6e831661fb6f714a9492084baa552a4af4617c65/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textarea.md)。
34