收合式選單元件 accordion-component-adaptive-forms-core-component

摺疊式功能表核心元件可讓使用者在最適化表單中建立可展開和可收合的區段。 它通常用於組織和簡化長或複雜的表單,方法是將其分成更小、更易於管理的部分。 摺疊式功能表的每個區段通常由標題表示,使用者可以按一下標題來展開或收合對應的內容。 內容可以是任何核心元件。

範例

使用情況 usage

在最適化表單中加入摺疊式功能表有幾個好處,包括:

  • 節省空間:摺疊式功能表可讓使用者展開和摺疊表單的區段,減少一次顯示所有表單欄位所需的空間量。

  • 導覽:摺疊式功能表可用來建立階層式導覽結構,讓使用者更容易找到所需的表單欄位。

  • 使用者體驗:摺疊式功能表可讓使用者以清楚且直覺的方式存取及填寫表單欄位,讓表單更人性化。

  • 長型Forms:摺疊式功能表是處理長型表單的理想元件,因為使用者可一次專注一個區段,而不是一次處理許多資訊。

您可以使用:

  • 設定對話方塊以指定摺疊式功能表元件的屬性。

  • 選取面板彈出視窗可定義摺疊式功能表的面板順序。 這可讓作者以面板出現的順序來排列面板。

  • 表單作者在設計對話方塊中啟用或停用某些功能的選項。 例如,作者可以選擇停用表單的特定欄位或區段。 這些選項可讓作者更能掌控表單的設計和功能,讓您更輕鬆地建立符合組織特定需求的表單。

「設定」對話方塊、「選取面板」彈出視窗和「設計」對話方塊都是核心元件的一部分,這些元件的建置可讓表單的製作更容易,並提供建立複雜表單的有效方式。

版本和相容性 version-and-compatibility

最適化Forms摺疊式功能表核心元件於2023年2月發行,是核心元件2.0.4的一部分。下表顯示所有支援版本、AEM相容性以及對應檔案的連結:

元件版本
AEM as a Cloud Service
v1

版本2.0.4和更新版本相容

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

技術細節 technical-details

GitHub的技術檔案中取得摺疊式功能表元件的最新資訊。 如需開發核心元件的詳細資訊,請參閱核心元件開發人員檔案

設定對話方塊 configure-dialog

您可以透過「設定」對話方塊輕鬆自訂訪客的收合式選單體驗。 您也可以輕鬆定義摺疊式功能表專案、面板、行為和外觀,以獲得順暢的使用者體驗。

基本標籤 basic-tab

基本索引標籤

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

  • 標題 — 您可以使用其Title輕鬆識別表單中的元件,預設情況下,標題會顯示在元件上方。 如果您未新增標題,則會顯示元件的名稱而非標題文字。

  • 允許標題使用RTF格式 — 此功能可讓使用者格式化純文字標題,並整合如粗體、斜體、底線文字、各種字型、字型大小、顏色等功能以及可增強視覺呈現和自訂的其他選項。 它提供更大的彈性和創意控制,讓標題在檔案、網站或應用程式中脫穎而出。
    選取​ 允許標題為RTF格式 ​的核取方塊後,即可看到格式化選項,以設定元件標題的樣式。 若要存取所有可用的格式選項,您可以按一下 全熒幕圖示 標籤。

    RTF支援

  • 隱藏標題 — 選取隱藏元件標題的選項。

  • 在表單提交時將子元件的資料分組(將資料包裝在物件中) — 選取選項時,其子元件的資料會巢狀內嵌在父元件的JSON物件中。 但是,如果未選取選項,則提交的JSON資料會具有平坦結構,沒有父元件的物件。 例如:

    • 選取選項時,子元件(例如街道、城市和郵遞區號)的資料會巢狀內嵌於父元件(位址)中,做為JSON物件。 這樣會建立階層式結構,而資料會整理在父元件下。

      提交資料的結構:

      code language-json
      { "Address":
      
      { "Street": "123 Main Street", "City": "New York", "Zip Code": "12345" }
      
      }
      
    • 未選取選項時,提交的JSON資料會具有不含父系元件(位址)物件的平面結構。 所有資料都位於相同層級,沒有任何階層式組織。

      提交資料的結構:

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

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

  • 停用元件 — 選取選項以停用元件。 一般使用者無法啟動或編輯已停用的元件。 使用者可以看到欄位的值,但無法修改它。 元件仍可於其他用途存取,例如將其用於規則編輯器中的計算。

  • 唯讀 — 選取選項,讓元件無法編輯。 使用者可以看到欄位的值,但無法修改它。 元件仍可於其他用途存取,例如將其用於規則編輯器中的計算。

重複可摺疊面板 repeat-accordion

重複收合式選單

您可以使用重複性選項來複製摺疊面板及其子元件、定義最小和最大重複計數,以及簡化表單中類似區段的複製。 與摺疊式功能表元件互動並存取其設定時,會顯示下列選項:

  • 將摺疊式功能表設為可重複:可讓使用者啟用或停用重複功能表的切換功能。
  • 最小重複次數:建立摺疊面板可重複的最小次數。 值為零表示不重複摺疊面板;預設值為零。
  • 最大重複次數:設定摺疊面板可以重複的最大次數。 預設情況下,此值為無限制。

若要有效管理摺疊式功能表內的可重複區段,請依照建立包含可重複區段的表單文章中提供的步驟操作。

專案標籤 items-tab

專案索引標籤

「新增」按鈕可讓您從元件選取視窗中選取要新增為面板的元件。 新增元件後,您會看到下列選項:

  • 圖示 — 圖示可識別清單中面板的元件。 您可以將滑鼠停留在圖示上,以工具提示的形式檢視完整的元件名稱。
  • 描述 — 用來作為面板文字的描述。 依預設,會為面板選取元件名稱。
  • 刪除 — 點選或按一下以從摺疊式功能表元件刪除面板。
  • 重新排列 — 點選或按一下並拖曳以重新排列面板。

說明內容標籤 help-content

說明內容標籤

  • 簡短說明 — 簡短說明是簡短文字說明,提供特定表單欄位用途的其他資訊或說明。 它可協助使用者瞭解應在欄位中輸入哪種資料型別,並可提供指引或範例,以協助確保輸入的資訊有效並符合所需條件。 依預設,簡短說明會維持隱藏狀態。 啟用​ 永遠顯示簡短描述 ​選項,以在元件下方顯示它。

  • 永遠顯示簡短描述 — 啟用選項以在元件下方顯示簡短描述。

  • 說明文字 — 說明文字是指提供給使用者的其他資訊或指引,以協助使用者正確填寫表單欄位。 當使用者按一下放置於元件旁的說明圖示(i)時,就會出現此選項。 說明文字提供的資訊比表單欄位的標籤或預留位置文字更詳細,其設計旨在協助使用者瞭解欄位的需求或限制。 它也可以提供建議或範例,讓填寫表單更容易、更準確。

協助工具標籤 accessibility

協助工具標籤

在​ 協助工具 ​標籤上,設定元件的ARIA協助工具標籤的值。 熒幕助讀程式的文字有多種可用選項:

  • 熒幕助讀程式文字 — 熒幕助讀程式文字是指視力不佳人士使用的輔助技術(例如熒幕助讀程式)專門用於閱讀的其他文字。 此文字提供表單欄位用途的音訊說明,並可包含欄位標題、說明、名稱和任何相關訊息(自訂文字)的相關資訊。 熒幕助讀程式文字可協助確保表單可供所有使用者存取,包括視覺障礙的使用者,並提供他們對表單欄位及其要求的完整瞭解。

    • 自訂文字:選取此選項即可使用ARIA協助工具標籤的自訂文字。 選取此選項會顯示「自訂文字」對話方塊。 您可以在「自訂文字」對話方塊中新增相關資訊。
    • 說明:選取此選項即可使用ARIA協助工具標籤的說明。
    • 標題:選取此選項即可使用ARIA協助工具標籤的標題。
    • 名稱:選取此選項即可使用ARIA協助工具標籤的名稱。
    • :如果您不想新增ARIA協助工具標籤,請選取此選項。

設計對話方塊 design-dialog

「設計」對話方塊可讓範本建立者控制物件的預設顯示方式。 針對最適化Forms摺疊式功能表元件,您可以設定下列專案:

  • 允許並設為預設的HTML標題元素型別(例如H1、H2、H3等)
  • 表單建立者可以在最適化Forms編輯器中新增到摺疊式功能表的核心元件
  • 樣式(CSS類別)的簡單名稱,可套用至最適化Forms編輯器中accordion元件的「屬性」對話方塊中。

這有助於讓建立和自訂表單的流程更直接有效。

屬性標籤 properties-tab-design

「屬性」標籤可讓範本作者為表單作者設定預設和允許的HTML標題元素:

設計對話方塊屬性索引標籤

  • 允許的標題元素:包含多個選項的下拉式清單,可讓範本作者選擇哪些標題元素可形成作者可用於收合式選單。

  • Default Heading Element:下拉式清單會設定摺疊式功能表元件的預設Heading元素。

允許的元件標籤 allowed-components-tab

設計對話方塊允許元件索引標籤

允許的元件 ​索引標籤可讓範本編輯器設定元件,這些元件可在最適化Forms編輯器的摺疊式功能表元件中新增為面板。

樣式索引標籤 styles-tab

設計對話方塊樣式索引標籤

「設計」對話方塊可用來定義和管理元件的CSS樣式。 最適化Forms摺疊式功能表核心元件支援AEM 樣式系統

  • 預設CSS類別:您可以為收合式選單元件提供預設CSS類別。

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

自訂屬性

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

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

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

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

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

相關文章 related-articles

另請參閱 see-also

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