表單文字元件 (v1) form-text-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-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-form-field aem-GridColumn aem-GridColumn--default--12">
   <div class="form-group">
       <label for="form-text-978484744">How many pieces of toast would you like?</label>
          <input type="number" id="form-text-978484744" name="pieces">
   </div>
  </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": {
                "text": {
                  "columnClassNames": "aem-GridColumn aem-GridColumn--default--12",
                  ":type": "weretail/components/form/text",
                  "name": "piecesOfToast",
                  "jcr:title": "How many pieces of toast would you like?",
                  "type": "number",
                  "rows": "2"
                }
              },
              ":itemsOrder": [
                "text"
              ],
              ":type": "weretail/components/form/container"
            }

NOTE

從核心元件匯出 JSON 需要核心元件 1.1.0 版。如需詳細資訊，請參閱核心元件 v1 的相容性資訊。