表單選項元件(v1) form-options-component-v

核心元件表單選項元件可讓您從各種格式的預先定義選項中進行選取。

使用狀況 usage

核心元件表單選項元件可讓您提交不同型別的選項(這些選項會以多種不同方式呈現),並且此元件旨在與 表單容器元件.

選項、標籤和個別選項的呈現可由內容編輯者在 設定對話方塊.

版本和相容性 version-and-compatibility

本檔案說明表單選項元件v1,其最初隨附於AEM 6.3的核心元件1.0.0版引入。

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

元件版本
AEM 6.3
AEM 6.4
v2
相容
相容
v1
相容
相容
CAUTION
本檔案說明表單選項元件v1。
如需目前版本的表單選項元件的詳細資訊,請參閱 表單選項元件 檔案。

範例元件輸出 sample-component-output

以下是取自下列專案的範例: We.Retail.

螢幕擷圖 screenshot

HTML 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 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"
            }
NOTE
從核心元件匯出JSON需要核心元件1.1.0版。 請參閱 核心元件v1的相容性資訊 以取得詳細資訊。

設定對話方塊 configure-dialog

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

  • 型別
    如何顯示選項

    • 核取方塊
    • 選項按鈕
    • 下拉式清單
    • 複選下拉式清單
  • 標題 — 將顯示為選項標籤的標題

  • 名稱 — 與表單資料共同提交的欄位名稱

  • 來源 — 定義選項的位置

    • 本機 — 在元件中定義

      • 點選或按一下 新增 按鈕以新增值, 刪除 以移除值
      • — 提交表單時選取該選項時儲存的值
      • 文字 — 表單上顯示之選項的標籤
      • 作用中 — 表單載入時,選項會標籤為已選取
      • 已停用 — 選項不可選取,但仍會顯示
      • 清單 - AEM中其他地方定義的靜態清單用於此選項
        • 清單 - AEM中靜態清單的路徑
          • 使用瀏覽按鈕來尋找清單資源
      • 資料來源 — 資料來源用於選項
        • 資料來源 — 資料來源的資源型別
  • 說明訊息 — 使用者可在欄位中輸入的內容的提示

設計對話方塊 design-dialog

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

技術細節 technical-details

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

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

有關開發核心元件的進一步詳細資訊,請參閱 核心元件開發人員檔案.

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c