表单选项组件 (v1)

利用核心组件表单选项组件可从各种格式的预定义选项中进行选择。

用途

利用核心组件表单选项组件可提交不同类型的选项（这些选项通过多种不同方式提供），并且此组件旨在与表单容器组件结合使用。

多个选项、标签和单个选项的呈现可由内容编辑者在“配置”对话框中定义。

版本和兼容性

本文档介绍了表单选项组件 (v1)，它最初随带 AEM 6.3 的核心组件 1.0.0 版引入。

下表列出了表单选项组件 (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-options aem-GridColumn aem-GridColumn--default--12">

    <fieldset class="form-group checkbox">
        <legend>What is your favorite type of toast?</legend>

        <div class="checkbox-item">
            <label>
              <input type="checkbox" name="toasttypes" value="dry">
              Plain dry toast
            </label>
        </div>
<div class="checkbox-item">
            <label>
              <input type="checkbox" name="toasttypes" value="french">
              French toast
            </label>
        </div>
<div class="checkbox-item">
            <label>
              <input type="checkbox" name="toasttypes" value="texas">
              Texas toast
            </label>
        </div>

    </fieldset>

</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": {
                "options": {
                  "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
                  ":type": "weretail/components/form/options",
                  "name": "toastTypes",
                  "jcr:title": "What is your favorite type of toast?",
                  "source": "local",
                  "type": "checkbox"
                }
              },
              ":itemsOrder": [
                "options"
              ],
              ":type": "weretail/components/form/container"
            }

“配置”对话框

利用“配置”对话框，内容作者可以定义应显示的选项类型、标签以及可用的选项。

• 类型
  如何显示选项

  • 复选框
  • 单选按钮
  • 下拉面板
  • 多选下拉面板

• 标题 - 将显示为选项标签的标题

• 名称 - 随表单数据一起提交的字段的名称

• 来源 - 在其中定义选项的位置

  • 本地 - 已在组件中定义
    • 点击或单击​添加​按钮可添加值，点击或单击​删除​可删除值
    • 值 - 提交表单期间选择该选项时保存的值
    • 文本 - 表单上显示的选项的标签
    • 活动 - 加载表单时标记为选定的选项
    • 已禁用 - 该选项不可选，但仍会显示
    • 列表 - AEM 中的其他位置定义的静态列表用于此选项
      • 列表 - AEM 中的静态列表的路径
        • 使用“浏览”按钮可找到列表资源
    • 数据源 - 数据源用于选项
      • 数据源 - 数据源的资源类型

• 帮助消息 - 关于用户可在字段中输入的内容的提示

“设计”对话框

表单选项组件没有“设计”对话框。

技术详细信息

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

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

在核心组件开发人员文档中可找到有关开发核心组件的其他详细信息。