表单文本组件

核心组件表单文本组件允许输入表单文本以供提交。

使用

表单文本组件允许提交不同类型的文本，并准备与表单容器组件一起使用。 文本验证、标签和帮助消息的类型可由配置对话框中的内容编辑器定义。

版本和兼容性

表单文本组件的当前版本为v2，该版本在2018年1月核心组件版本2.0.0中引入，在本文档中进行了描述。

下表详细列出了组件的所有受支持版本、组件版本与之兼容的AEM版本，以及指向以前版本文档的链接。

有关核心组件版本和版本的更多信息，请参阅文档核心组件版本。

组件输出示例

要体验表单文本组件并查看其配置选项以及HTML和JSON输出的示例，请访问组件库。

技术详细信息

有关表单文本组件的最新技术文档，请参阅GitHub。

有关开发核心组件的更多详细信息，请参阅核心组件开发人员文档。

配置对话框

配置对话框允许内容作者定义要输入的文本类型以及默认值和标签。

“属性”选项卡

• 约束 — 要输入并将针对其进行验证的文本类型
  • 文本
  • 文本区域
  • 电子邮件
  • 电话
  • 日期
  • 数字
  • 密码
• 文本行 — 要在文本区域中显示的行数(仅当“约束”设置为“文 ​​本区域” 时显示)
• 标签 — 将为字段显示的标签
• 隐藏标签以防显示 — 如果仅出于辅助功能目的而需要标签，并且不会传递有关该字段的任何其他可视化信息，则需要此标签
• 元素名称 — 随表单数据一起提交的字段的名称
• 值 — 在字段中预填充的默认值
• ID — 利用此选项，可控制HTML和数据层中组件的唯一标识符 的唯一标识符。
  • 如果留为空白，则会自动为您生成唯一ID，并且可以通过检查生成的页面找到该ID。
  • 如果指定了ID，则作者有责任确保该ID是唯一的。
  • 更改ID可能会影响CSS、JS和数据层跟踪。

关于选项卡

• 帮助消息 — 向用户提示可在字段中输入的内容
• 将帮助消息显示为占位符 — 在表单输入中显示帮助消息，当该消息为空且未集中

约束选项卡

• 约束消息
  • 如果该值对于所选的类型无效，则在提交表单时，将以工具提示形式显示消息
  • 未显示​Text​和​Text Area​约束类型
• 必需 — 如果选中此项，则用户必须在提交表单之前填写值
  • 必需消息 — 如果字段留空，则消息将显示为工具提示
• 设为只读 — 如果选中，则用户无法修改字段的值

“设计”对话框

“样式”选项卡

表单文本组件支持AEM 样式系统。