表单文本组件(v1)

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

使用

表单文本组件允许提交不同类型的文本,并准备与表单容器组件一起使用。

文本验证、标签和帮助消息的类型可由配置对话框中的内容编辑器定义。

版本和兼容性

本文档描述了最初随AEM 6.3的核心组件版本1.0.0引入的表单文本组件的v1。

下表列表了表单文本组件v1的兼容性。

AEM 版本 表单文本组件v1
6.3 兼容
6.4 兼容
注意

本文档描述表单文本组件的v1。

有关表单文本组件的当前版本的详细信息,请参阅表单文本组件文档。

示例组件输出

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

屏幕快照

HTML

<div class="cmp cmp-form aem-GridColumn aem-GridColumn--default--12">
 <form method="POST" action="/content/we-retail/us/en/experience.html" id="new_form" name="new_form" enctype="multipart/form-data" class="aem-Grid aem-Grid--12 aem-Grid--default--12 ">
     <input type="hidden" name=":formstart" value="/content/we-retail/us/en/experience/jcr:content/root/responsivegrid/container">
     <div class="cmp cmp-form-field aem-GridColumn aem-GridColumn--default--12">
   <div class="form-group">
       <label for="form-text-978484744">How many pieces of toast would you like?</label>
          <input type="number" id="form-text-978484744" name="pieces">
   </div>
  </div>
 </form>
</div>

JSON

"container": {
              "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
              "columnCount": 12,
              "gridClassNames": "aem-Grid aem-Grid--12 aem-Grid--default--12",
              ":items": {
                "text": {
                  "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
                  ":type": "weretail/components/form/text",
                  "name": "piecesOfToast",
                  "jcr:title": "How many pieces of toast would you like?",
                  "type": "number",
                  "rows": "2"
                }
              },
              ":itemsOrder": [
                "text"
              ],
              ":type": "weretail/components/form/container"
            }
注意

从核心组件导出JSON时,需要1.1.0版的核心组件。 有关详细信息,请参阅核心组件v1](/docs/experience-manager-core-components/versions.html?lang=zh-Hans)的[兼容性信息。

配置对话框

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

主要

  • 约束 -要输入并将验证的文本类型

    • 文本
    • 文本区域
    • 电子邮件
    • 电话
    • 日期
    • 数字
    • 密码
  • 文本行 -要在文本区域中显示的行数(仅当“约束”设置 ​为“文本区域 ”时显示)

  • 标签 -将为字段显示的标签

  • 隐藏标签以免显示 -如果标签仅用于辅助功能目的而是必需的,并且不会传递有关该字段的任何其他可视信息,则需要

  • 元素名称 -随表单数据提交的字段的名称

  • -字段中预填充的默认值

关于

  • 帮助消息 -提示用户可在字段中输入的内容
  • 将帮助消息显示为占位符 -在表单输入中显示帮助消息时,请在其为空且未聚焦

约束

  • 约束消息

    • 如果该值对于所选的类型无效,则在提交表单时,将以工具提示形式显示消息
    • 未针对​文本​和​文本区域​约束类型显示
  • 必需 -如果选中,则用户必须在提交表单之前填写值

  • 设为只读 -如果选中,用户无法修改字段的值

设计对话框

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

技术详细信息

有关表单文本组件的最新技术文档可在GitHub上找到。

整个核心组件项目可从GitHub下载。

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

在此页面上