Show Menu
主题×

表单文本组件

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

使用情况

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

版本和兼容性

表单文本组件的当前版本为v2,该版本在2018年1月随核心组件的2.0.0版一起推出,本文档对此进行了说明。
下表详细列出了组件的所有受支持版本、与组件版本兼容的AEM版本,以及指向先前版本的文档的链接。
组件版本
AEM 6.3
AEM 6.4
AEM 6.5
v2
兼容
兼容
兼容
兼容
兼容
兼容
For more information about Core Component versions and releases, see the document Core Components Versions .

示例组件输出

以下是从 We.Retail获取的示例

屏幕快照

HTML

<div class="text aem-GridColumn aem-GridColumn--default--12"> <div class="cmp-form-text"> <label for="form-text-2146967">How many pieces of toast would you like? </label> <input class="cmp-form-text__text" type="number" id="form-text-2146967" name="pieces"> </div> </div>

JSON

"text":{ "columnClassNames":"aem-GridColumn aem-GridColumn--default--12", "id":"form-text-2146967", "title":"How many pieces of toast would you like?", "name":"pieces", "value":"", "helpMessage":"", "type":"number", "readOnly":false, "required":false, "requiredMessage":"", "constraintMessage":"", "rows":2, "defaultValue":"", ":type":"core/wcm/components/form/text/v2/text" }

Technical Details

有关表单文本组件的最新技 术文档可在GitHub上找到
Further details about developing Core Components can be found in the Core Components developer documentation. 开发核心组件

Configure Dialog

The configure dialog allows the content author to define the type of text to be input as well as default values and labels.

Main Tab

  • Constraint The type of text to be input and will be validated against
    • 文本
    • 文本区域
    • 电子邮件
    • 电话
    • 日期
    • 数字
    • 密码
  • Text lines Number of lines to be displayed in the text area (only displayed when Constraint is set to Text Area)
  • 标签
    ​将为字段显示的标签
  • 如果标签仅用于辅助功能
    ,并且不会传递有关该字段的任何其他可视信息,则隐藏标签,使其不显示
  • 元素名
    ​称随表单数据一起提交的字段的名称
  • ​字段中预填充的默认值

About Tab

  • 帮助消
    ​息提示用户可在字段中输入的内容
  • Display help message as placeholder
    To display the help message inside the form input when it is empty and not focused

约束选项卡

  • 约束消息
    • 如果该值对于所选的类型无效,则在提交表单时,将以工具提示形式显示消息
    • 不显示文本和
      文本区域约束类型
  • Required
    If selected the user must fill in a value before submitting the form
  • 设为只读
    ​如果选中此选项,则用户无法修改字段的值

设计对话框

表单文本组件没有设计对话框。