文本域
用于在多行中输入任意文本、数字和符号值的组件。最常用于创建实体时的描述，或在表单和对话框中输入消息。
应用
与 TextInput 不同，它具有行高之和的高度，用于以自由形式输入任何字母、数字或符号组合的数据。
最小高度为一行，但我们建议使用两行或更多行的组件。
如果未指定行数，则高度将根据内容量自动计算。
✅ 何时使用
- 当需要多行文本时。
- 当文本必须是长描述或包含大量字符的消息时。
- 当它被添加到必须填写的字段的表单中时。
🚫 何时不使用
- 当需要过滤器、授权表单字段或搜索字符串时。
- 当需要少量字符时（少于 5 个单词）。为此，我们建议使用 TextInput，这是一个用于单行文本输入的组件。
类型
TextInput 有两种类型：Normal 和 Clear，它们具有相同的功能集，但外观和使用方式因上下文而异。
Normal
- 最常用的类型。
- 此组件的一个显著特征是其内部填充和圆角。这些参数由元素的大小决定，并由特定的圆角变量（更多信息 此处）以及 1px 的描边定义。
- 在表单中使用，当组件之间需要自由空间时，例如表单元素之间的填充。
Clear
- 此组件的定义特征是缺少边框，元素位于输入字段的边距内。
- 当 Normal 类型产生视觉干扰时使用。
- 使用此类型时，请确保此组件的目的对用户来说是清晰的。
结构
1. 值
- 是必需元素。
- 可用作提示（占位符）和已输入文本。
- 输入的文本将替换提示。
2. 清除按钮
- 是可选组件。
- 当需要清除字段内容时使用。
- 当字段中至少输入一个字符时显示。
- 即使焦点不在字段上也会显示。
- 是一个 Flat-secondary 类型的 Button 组件，继承了其所有属性。例如，鼠标悬停时，十字的背景会填充。
- 单击清除按钮时，焦点会移至字段，并且输入的值会被清除。 3. 附加内容
- 是可选元素，嵌入在右下角。
- 当需要在外部添加附加文本时使用。
- 文本右对齐。
- 例如，可用作计数器（字符输入计数器）。
4. 错误图标
- 仅在 Inline Error 状态下显示。
- 与 Tooltip 配合使用，在鼠标悬停在图标上时提供错误描述，以实现更紧凑的表单布局。
5. 错误消息
- 仅在 Outline Error 状态下显示。
- 嵌入在左下角。
状态
具有以下状态：Suggest, Default, Hover, Active, Disabled, Inline Error, 和 Outline Error。
- Suggest。 当没有直接与组件交互且未输入数据时的非活动状态。在此状态下，值可以作为提示，指示用户应将何种信息输入字段。
- Default。 当没有直接与组件交互且已输入数据时的非活动状态。在此状态下，提示值会根据用户的输入而变化。
- Hover。 当光标悬停在组件区域上时的活动状态。
- Active。 通过从上一个组件过渡或单击鼠标触发的活动状态。当过渡到其他组件或单击空白区域时，状态会重置。
- Disabled。 组件的非活动状态，此时无法与之交互。
- Outline error。 当验证过程中发生错误时的组件活动状态，并在字段底部显示错误及说明。
- Inline error。 当字段验证发生错误时的组件活动状态，但错误未显示。相反，错误由一个特殊图标表示，鼠标悬停在该图标上时会显示错误 Tooltip。
尺寸
该组件有四种尺寸：S, M, L, 和 XL。
字段的高度和圆角，以及字段内的填充和文本大小，会根据组件的大小而变化。
圆角取决于大小，并通过 变量 设置。
- S (-g-border-radius-s: 5px;) – 当标准输入过大时使用（例如，表格、小卡片）。
- M (-g-border-radius-m: 6px;) – 基本尺寸，在大多数表单和过滤器中使用。
- L (-g-border-radius-l: 8px;) – 用于搜索（例如，服务搜索）。
- XL (-g-border-radius-xl: 10px;) – 在通信环境中使用（例如，网站和登陆页面）。
用户指南
1. 使用字段
- 字段的高度可能会有所不同。TextInput 可用于单行输入。
- 我们不建议在字段中包含 提示，因为输入值后字段名称将不可见，除非空间有限或字段的目的对用户来说很清楚。
- 对表单的所有补充组件使用 相同尺寸。如果您选择了 M 尺寸，所有其他组件也应为相同尺寸。
2. 外部字段标题
- 简短的字段名称，最好限制在一行内。
- 组件应与字段值保持在同一行，除非上下文是移动设备或 Dialog 尺寸为 S，在这种情况下，组件的标题显示在组件上方。
3. 带工具提示的提示
- 鼠标悬停在带问号的图标上时，用于填写字段的说明。
- 当标题和含义需要澄清时使用。
- 不应包含超过两段文本。
4. 附加描述
- 可位于字段的底部或右侧。
- 在极少数情况下使用，当不清楚如何填写字段而没有附加描述时，或当需要对先前输入的值进行解释时。