表單容器元件 form-container-component

利用核心元件表單容器元件,可建立簡單的提交表單。

使用狀況 usage

表單容器元件可支援簡單的WCM表單,並使用巢狀結構來允許其他表單元件,讓您建立簡單的資訊提交表單和功能。

藉由使用 設定對話方塊 內容編輯者可以定義由表單提交所觸發的動作、應處理提交的URl,以及是否應觸發工作流程。 範本作者可以使用 設計對話方塊 定義允許的元件及其對映,類似於 範本編輯器中的標準版面容器.

NOTE
核心元件表單容器元件僅支援使用核心元件表單元件(按鈕、文字、隱藏等)。 使用 基礎元件 不支援核心元件表單容器中的表單元件(反之亦然)。

版本和相容性 version-and-compatibility

表單容器元件的目前版本是v2,此版本隨2018年1月的核心元件2.0.0版的發佈引入,具體說明見本文。

下表詳細說明元件的所有支援版本、與元件版本相容的AEM版本,以及舊版檔案的連結。

元件版本
AEM 6.4
AEM 6.5
AEM as a Cloud Service
v2
相容於
版本2.17.4 和先前的
相容
相容
v1
相容
相容
相容

如需核心元件版本和發行版本的詳細資訊,請參閱檔案 核心元件版本.

範例元件輸出 sample-component-output

若要體驗表單容器元件並檢視其設定選項範例以及HTML和JSON輸出,請造訪 元件資料庫.

技術細節 technical-details

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

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

設定對話方塊 configure-dialog

設定對話方塊可讓內容作者定義在提交元件時所採取的動作。

根據選取的專案 動作型別,容器內的可用選項將會變更。 可用的動作型別為:

無論型別為何,都有 一般設定 適用於每個動作。

張貼表單資料 post-data

提交表單時,發佈表單資料動作型別會將提交的資料以JSON的格式傳遞給第三方以進行處理。

表單容器元件的「編輯」對話方塊中的「發佈表單資料」選項

  • 端點 — 將處理資料的完整HTTPS服務
  • 錯誤訊息 — 提交失敗時顯示的訊息
TIP
系統管理員可以調整其他逾時選項,以處理轉送的表單資料。 如需詳細資訊,請參閱GitHub上的技術檔案。

郵件 mail

提交表單時,郵件動作型別會傳送電子郵件給指定的收件者。

表單容器元件的「編輯」對話方塊中的郵件選項

  • 主旨 — 在提交表單時將傳送的電子郵件主題

  • — 表單提交時將傳送之電子郵件的寄件者電子郵件地址

  • — 在提交表單時將收到電子郵件的收件者地址

    • 點選或按一下 新增 按鈕以新增其他地址
    • 點選或按一下 刪除 按鈕以移除電子郵件地址
  • CC — 將接收在提交表單時傳送之電子郵件副本的收件者地址

    • 點選或按一下 新增 按鈕以新增其他地址
    • 點選或按一下 刪除 按鈕以移除電子郵件地址

存放區內容 store-content

提交表單時,表單內容會儲存在指定的存放庫位置。

在表單容器的編輯對話方塊中儲存內容選項

  • 內容路徑 — 儲存所提交內容的內容存放庫路徑
  • 檢視資料 — 點選或按一下以檢視以JSON格式儲存的提交資料
  • 開始工作流程 — 設定為在提交表單時啟動工作流程,並將儲存的內容作為裝載
NOTE
為了更輕鬆管理使用者資料並強制進行關注點分離,通常不建議將使用者產生的內容儲存在存放庫中。
請改用 張貼表單資料 將使用者內容傳遞至專用服務提供者的動作型別。

一般設定 general-settings

無論選取的動作型別為何,您一律可以定義感謝頁面。

表單容器元件的「編輯」對話方塊中的一般選項

  • 感謝頁面 — 完成表單提交後,會將使用者重新導向至指定的頁面。

    • 使用「選取」對話方塊來選取AEM中的資源。
    • 如果感謝頁面不在AEM中,請指定絕對URL。 非絕對URL將會解釋為相對於AEM。
    • 留空可在提交後重新顯示表單。
  • ID — 此選項可讓您控制HTML和中的元件唯一識別碼 資料層.

    • 如果保留為空白,系統會自動為您產生唯一ID,並可透過檢查結果頁面找到該ID。
    • 若指定ID,作者應負責確認該ID是唯一的。
    • 變更ID會對CSS、JS和資料層追蹤造成影響。

設計對話方塊 design-dialog

「設計」對話方塊可讓範本作者為容器定義允許的元件及其對應,類似於「設計」對話方塊的 範本編輯器中的標準版面容器.

樣式索引標籤 styles-tab

表單容器元件支援AEM 樣式系統.

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