文件AEM核心元件指南

文字元件 text-adaptive-forms-core-component

Last update: Tue Jun 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

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

在最適化表單中，文字是指顯示在表單上以供使用者閱讀的內容。 這可以包括用來標示一組表單元素（例如文字欄位）的文字，以及提供給使用者的任何其他指示或資訊。

這也可以協助將表單的結構分割成邏輯區段，讓使用者更容易理解並完成表單。 此外，它可用於協助工具，以簡短說明與其關聯的元素。 此類文字欄位通常會顯示在表單元件附近，例如顯示於其之前或之後。

TIP
您是否考慮過適用於 AEM 的 Edge Delivery Services？
現有的專案可以繼續使用本文件中所述的方法。然而，針對新專案，Adobe 建議採用 Edge Delivery Services。

範例

文字範例

使用情況 reasons-to-use-text-label

在表單中使用文字有幾個原因：

  • 提供指示：文字可用於提供如何填寫表單或需要哪些資訊的指示。

  • 提供內容：文字可用來提供表單的內容，例如說明表單的目的或收集資訊的組織。

  • 將表單分割為邏輯區段：文字可用來將表單分割為邏輯區段，讓使用者更容易理解並完成表單。

  • 品牌和身分：文字可用於品牌和身分目的，例如在表單中包含組織的名稱。

版本和相容性 version-and-compatibility

最適化Forms文字核心元件於2023年2月發行，屬於Cloud Service核心元件2.0.4以及AEM 6.5.16.0 Forms或更新版本的核心元件1.1.12的一部分。 下表顯示所有支援版本、AEM相容性以及對應檔案的連結：

元件版本
AEM as a Cloud Service
AEM 6.5.16.0 Forms或更新版本
v1
與
版本2.0.4和更新版本相容
與
版本1.1.12及更新版本相容，但小於2.0.0。

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

技術細節 technical-details

在GitHub上的技術檔案中取得最適化Forms文字核心元件的最新資訊。 如需開發核心元件的詳細資訊，請參閱核心元件開發人員檔案。

設定對話方塊 configure-dialog

您可以透過「設定」對話方塊輕鬆自訂訪客的文字型驗。 您也可以輕鬆定義文字選項，提供順暢的使用者體驗。

基本索引標籤

基本索引標籤

  • 名稱 — 您可以在表單和規則編輯器中輕鬆識別具有唯一名稱的表單元件，但名稱不得包含空格或特殊字元。

  • 繫結參考 — 繫結參考是儲存在外部資料來源中並在表單中使用的資料元素的參考。 繫結參考可讓您將資料動態繫結至表單欄位，讓表單可顯示資料來源的最新資料。 例如，繫結參考可用於根據在表單中輸入的客戶ID在表單中顯示客戶名稱和地址。 繫結參考也可用來使用輸入到表單中的資料更新資料來源。 透過這種方式，AEM Forms可讓您建立與外部資料來源互動的表單，提供順暢的使用者體驗來收集和管理資料。

  • 標籤為未繫結的表單元素：選取選項以設定未連結至任何結構描述的表單欄位。 此選項可讓您儲存資料而不更新資料來源。 它也可讓您以自訂方式處理資料，與標準資料庫整合不同。

  • 隱藏元件 — 選取選項，以隱藏表單中的元件。 元件仍可於其他用途存取，例如將其用於規則編輯器中的計算。 當您需要儲存不需要由使用者看到或直接變更的資訊時，這將很有用。

設計對話方塊 design-dialog

「設計」對話方塊可用來定義和管理文字元件的CSS樣式。

樣式索引標籤 styles-tab

索引標籤可用來定義和管理元件的CSS樣式。 最適化Forms文字核心元件支援AEM 樣式系統。

設計對話方塊

  • 預設CSS類別：您可以為最適化Forms文字核心元件提供預設CSS類別。

  • 允許的樣式：您可以提供名稱以及代表樣式的CSS類別來定義樣式。 例如，您可以建立名為「粗體文字」的樣式，並提供CSS類別「font-weight： bold」。 您可以在最適化Forms編輯器中將這些樣式使用或套用至最適化表單。 若要套用樣式，請在最適化Forms編輯器中，選取您要套用樣式的元件，導覽至屬性對話方塊，然後從​ 樣式 ​下拉式清單中選取所需的樣式。 如果您需要更新或修改樣式，只要返回「設計」對話方塊，更新樣式索引標籤中的樣式，然後儲存變更即可。

自訂屬性

自訂屬性對話方塊

自訂屬性可讓您使用表單範本，將自訂屬性（索引鍵/值組）與最適化表單核心元件建立關聯。 自訂屬性會反映在元件Headless轉譯的properties區段中。 它可讓您建立根據自訂屬性值調整的動態表單行為。 例如，開發人員可以為行動、桌上型電腦或Web平台設計各種無頭Forms元件的轉譯，大幅提升各種裝置的使用者體驗。

  • 群組名稱：您可以提供一個名稱來識別自訂屬性群組。 您可以新增、刪除或重新排列多個自訂屬性群組。 新增自訂屬性群組後，您可以看到下列選項：

    • 索引鍵 — 值配對：您可以按一下每個自訂屬性群組的​ 新增 ​按鈕，以新增多個自訂屬性名稱和自訂屬性值。

    • 刪除：點選或按一下以刪除自訂屬性名稱和自訂屬性值。

    • 重新排列：點選或按一下並拖曳以重新排列自訂屬性名稱和自訂屬性值。

另請參閱 see-also

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