表單選項元件(v1)

核心元件表單選項元件允許從各種格式的預定義選項中進行選擇。

使用狀況

核心元件表單選項元件允許以多種不同方式提交不同類型的選項，並打算與表單容器元件一起使用。

選項、標籤和個別選項的呈現方式可由configure dialog的內容編輯器定義。

版本和相容性

本檔案說明Form Options元件的v1，最初是隨AEM 6.3核心元件的1.0.0版一起推出。

下表列出表單選項元件v1的相容性。

元件版本 AEM 6.3 AEM 6.4
v2 相容 相容
v1 相容 相容
注意

本檔案說明表單選項元件的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"
            }
注意

從核心元件匯出JSON需要1.1.0版的核心元件。 如需詳細資訊，請參閱核心元件v1](/docs/experience-manager-core-components/versions.html?lang=zh-Hant)的[相容性資訊。

配置對話框

「設定」對話方塊可讓內容作者定義應顯示的選項類型、標籤，以及哪些選項可用。

  • 類
    型選項的呈現方式

    • 核取方塊
    • 選項按鈕
    • 下拉式清單
    • 複選下拉式清單

  • Title —— 將顯示為選項標籤的標題

  • 名稱 -隨表單資料提交的欄位名稱

  • 來源 -選項的定義位置

    • Local —— 在元件中定義
      • 點選或按一下「新增​​」按鈕以新增值，「刪除​​」以移除值
      • Value —— 在提交表單時選擇該選項時保存的值
      • Text —— 表單上顯示的選項標籤
      • 活動 -當表單載入時，選項會標示為已選取
      • 停用 -選項無法選取，但仍顯示
      • List —— 選項會使用AEM中其他位置定義的靜態清單
        • List - AEM中靜態清單的路徑
          • 使用「瀏覽」按鈕查找清單資源
      • 資料來源 -使用資料來源來選擇
        • 資料源 -資料源的資源類型

  • 說明訊息 -使用者在欄位中可輸入內容的提示

設計對話框

「表單選項」元件沒有設計對話框。

技術詳細資訊

有關表單選項元件的最新技術文檔可在GitHub上找到。

您可從GitHub下載整個核心元件專案。

有關開發核心元件的詳細資訊，請參閱核心元件開發人員檔案。

本頁內容