文件AEM核心元件指南

表單按鈕元件 (v1) form-button-component-v

Last update: Mon Oct 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 開發人員
  • 管理員
  • 使用者

利用核心元件表單按鈕元件，您可在表單中包含按鈕欄位以觸發動作。

用途 usage

核心元件表單按鈕元件允許建立按鈕欄位，通常會觸發提交表單，其設計用於與表單容器元件搭配使用。

按鈕屬性可由內容編輯者在設定對話框中定義。

版本和相容性 version-and-compatibility

本文件說明表單按鈕元件 v1，最初由 AEM 6.3 搭配的核心元件 1.0.0 版導入。

下表列出表單按鈕元件 v1 的相容性。

AEM 版本
表單按鈕元件 v1
6.3
相容
6.4
相容
CAUTION
本文件說明表單按鈕元件 v1。
如需表單按鈕元件目前版本的詳細資訊，請參閱表單按鈕元件文件。

範例元件輸出 sample-component-output

以下是從 We.Retail 中取得的範例。

螢幕擷圖 screenshot

HTML html

<div class="cmp cmp-button aem-GridColumn aem-GridColumn--default--12">
    <div class="cmp cmp-button">
        <button type="BUTTON" class="btn btn-action btn-primary" name="loveToast" value="ILoveToast">
            Click here if you love toast!
        </button>
    </div>
</div>

JSON json

"container": {
              "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
              "columnCount": 12,
              "gridClassNames": "aem-Grid aem-Grid--12 aem-Grid--default--12",
              ":items": {
                "button": {
                  "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
                  ":type": "weretail/components/form/button",
                  "name": "loveToast",
                  "jcr:title": "Click here if you love toast!",
                  "type": "submit",
                  "value": "ILoveToast"
                }
              },
              ":itemsOrder": [
                "button"
              ],
              ":type": "weretail/components/form/container"
            }
NOTE
從核心元件匯出 JSON 需要核心元件 1.1.0 版。如需詳細資訊，請參閱核心元件 v1 的相容性資訊。

設定對話框 configure-dialog

設定對話框可讓內容作者定義按鈕的參數。

  • 類型

    • 按鈕
    • 提交

  • 標題 - 按鈕上顯示的文字

    • 若未提供，則預設為按鈕類型

  • 名稱 - 與表單資料共同提交的按鈕名稱

  • 值 - 與表單資料共同提交的按鈕值

設計對話框 design-dialog

「表單按鈕」元件沒有設計對話框。

技術詳細資訊 technical-details

在 GitHub 上可找到有關表單按鈕元件的最新技術文件。

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

如需開發「核心元件」的進一步詳細資訊，請參閱核心元件開發人員文件。

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