Show Menu
主題×

表單選項元件

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

使用狀況

「核心元件表單選項」元件允許以多種不同方式提交不同類型的選項,並與「表單容器」元件一起 使用
選項、標籤和個別選項的呈現方式可由內容編輯器在「設定」對話方塊中 定義

版本與相容性

目前的表單選項元件版本為v2,此版本於2018年1月隨核心元件2.0.0版推出,並在本檔案中加以說明。
下表詳細說明所有支援的元件版本、與元件版本相容的AEM版本,以及舊版檔案的連結。
元件版本
AEM 6.3
AEM 6.4
AEM 6.5
v2
相容
相容
相容
相容
相容
相容
如需核心元件版本與版本的詳細資訊,請參閱檔案核 心元件版本

元件輸出示例

以下是 We.Retail的範例

螢幕擷圖

HTML

<form method="POST" action="/content/we-retail/us/en/experience.html" id="new_form" name="new_form" enctype="multipart/form-data" class="cmp-form 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="hidden aem-GridColumn aem-GridColumn--default--12"> <input type="hidden" id="form-hidden-66464844" name="hidden"> </div> <div class="hidden aem-GridColumn aem-GridColumn--default--12"> <input type="hidden" id="form-hidden-858231075" name="hidden"> </div> <div class="hidden aem-GridColumn aem-GridColumn--default--12"> <input type="hidden" id="form-hidden-862566768" name="hidden"> </div> <div class="container responsivegrid aem-GridColumn aem-GridColumn--default--12"> <input type="hidden" name=":formstart" value="/content/we-retail/us/en/experience/jcr:content/root/responsivegrid/container/container"> <div class="options aem-GridColumn aem-GridColumn--default--12"> <fieldset class="cmp-form-options"> <legend class="cmp-form-options__legend">What is your favorite type of toast?</legend> <label class="cmp-form-options__field-label"> <input class="cmp-form-options__field cmp-form-options__field--radio" type="radio" name="favToast" value="dryToast"> Plain dry toast </label> <label class="cmp-form-options__field-label"> <input class="cmp-form-options__field cmp-form-options__field--radio" type="radio" name="favToast" value="frenchToast"> French Toast </label> <label class="cmp-form-options__field-label"> <input class="cmp-form-options__field cmp-form-options__field--radio" type="radio" name="favToast" value="texasToast"> Texas Toast </label> </fieldset> </div> </div></form>

JSON

"container":{ "columnClassNames":"aem-GridColumn aem-GridColumn--default--12", "columnCount":12, "gridClassNames":"aem-Grid aem-Grid--12 aem-Grid--default--12", ":items":{ "options_816658469":{ "columnClassNames":"aem-GridColumn aem-GridColumn--default--12", "id":"form-options-269951232", "title":"What is your favorite type of toast?", "name":"favToast", "type":"RADIO", "items":[ { "value":"dryToast", "text":"Plain dry toast", "selected":false, "disabled":false }, { "value":"frenchToast", "text":"French Toast", "selected":false, "disabled":false }, { "value":"texasToast", "text":"Texas Toast", "selected":false, "disabled":false } ], ":type":"core/wcm/sandbox/components/form/options/v2/options" } }, ":itemsOrder":[ "options_816658469" ], ":type":"core/wcm/sandbox/components/form/container/v2/container" }

技術詳細資訊

有關表單選項元件的最新技術文 件可在GitHub上找到
有關開發核心元件的詳細資訊,請參閱核心元 件開發人員檔案

配置對話框

「設定」對話方塊可讓內容作者定義應顯示的選項類型、標籤,以及哪些選項可用。
  • 類型
    -選項的呈現方式
    • 核取方塊
    • 選項按鈕
    • 下拉式清單
    • 複選下拉式清單
  • Title
    ​將顯示為選項標籤的標題
  • 名稱
    ​隨表單資料提交的欄位名稱
  • ​定義選項的位置
    • Local
      Defined within the component
      • 點選或按一下「
        新增
        」按鈕以新增值,
        「刪除
        」以移除值
      • ​當提交表單時,選取該選項時保存的值
      • Text
        ​表單上顯示的選項標籤
      • 活動
        ​當表單載入時,選項會標示為已選取
      • 停用
        ​此選項無法選取,但仍顯示
      • 清單
        AEM中其他地方定義的靜態清單會用於選項
        • 清單
          AEM中靜態清單的路徑
          • 使用「瀏覽」按鈕查找清單資源
      • 資料來源
        ​資料來源用於選項
        • 資料源
          ​資料源的資源類型
  • 說明訊息
    :使用者在欄位中可輸入內容的提示

設計對話框

樣式標籤

「表單選項」元件支援AEM Style系統