核取方塊群組元件 button-component-adaptive-forms-core-component
自適應表單中的核取方塊群組是一組相關的核取方塊,可讓使用者從清單中選取一或多個選項。每個核取方塊由資料值 (用於處理核取方塊群組項目的值) 和顯示值 (說明其用途的每個核取方塊項目的索引標籤) 表示
範例
屬性對話框
在此範例中,「選項」元素用於將核取方塊分組。顯示文字 元素用於為項目提供標籤,資料值 則是用於指定提交表單時傳送至伺服器的值。
每個核取方塊選項/項目都有唯一的資料值和顯示文字屬性。如果使用者選取「兒子」和「女兒」核取方塊,則表單提交時會將對應的資料值傳送到伺服器。接著,此資料可由伺服器端指令碼處理,以判斷使用者所選取的選項,並可用於執行各種動作,例如更新表單中的其他欄位,或將表單資料提交至伺服器端指令碼以便進一步處理。
此外,核取方塊群組可設定為讓每個選項都具有不同的處理值,並可使用自適應表單規則編輯器進行設定。
用途 reasons-to-use-check-box-group
在自適應表單中加入核取方塊群組有多項好處,包括:
-
多重選取:核取方塊群組可讓使用者從清單中選取多個選項,這在允許或需要多重選擇的情況下很有用。
-
使用者體驗:透過核取方塊群組,可讓使用者以清晰直觀的方式選取多個選項,使表單更加易於使用。
-
資料分析:核取方塊群組可用於收集各種來源的資料,並加以分析,或用來作為進一步處理的輸入。
-
問卷調查:可在問卷調查中使用核取方塊群組來選取單一問題的多個選項。
-
使用者偏好設定:核取方塊群組可用來收集不同選項的使用者偏好設定。
-
資料值:核取方塊群組也可以用來處理核取方塊群組的項目。
版本和相容性 version-and-compatibility
自適應表單核取方塊群組核心元件於 2023 年 2 月發行,屬於 Cloud Service 核心元件 2.0.4 和 AEM 6.5.16.0 Forms 或更新版本的核心元件 1.1.12 的一部分。下表顯示所有支援版本、AEM 相容性以及對應文件的連結:
如需「核心元件」版本和發行版本的詳細資訊,請參閱核心元件版本文件。
技術詳細資訊 technical-details
GitHub 的技術文件中可找到自適應表單核取方塊群組核心元件的最新資訊。如需開發核心元件的更多資訊,請參閱核心元件開發人員文件。
設定對話框 configure-dialog
透過設定對話框,您可以輕鬆自訂訪客的核取方塊體驗。同樣能夠輕鬆定義核取方塊選項,以提供順暢無礙的使用者體驗。
基本索引標籤 basic-tab
-
名稱 - 此名稱可唯一識別規則編輯器中的元件。名稱字串中不允許特殊字元和空格。
-
標題 - 您可以使用其標題輕鬆識別表單中的元件,預設情況下,標題會顯示在元件上方。若未新增標題,則會顯示該元件的名稱而非標題文字。
-
允許標題使用 RTF 文字 - 此功能可讓使用者格式化純文字標題,整合粗體、斜體、底線文字、各種字型、字體大小、顏色等功能,以及可增強視覺呈現和自訂的其他選項。提供更大的靈活性和創意控制,讓標題在文件、網站或應用程式中脫穎而出。
選取 允許標題使用 RTF 文字 核取方塊後,即可看到格式選項,以設定元件標題的樣式。若要存取所有可用的格式選項,您可以按一下Fullscreen
-
隱藏標題 - 選取該選項,以隱藏元件標題。
-
選項 - 您可以使用 新增 按鈕來新增資料值和顯示文字組。
新增新的選項後,可以執行以下動作:- 資料值 - 此選項可讓您在選取選項時,輸入要提交的內容。
- 顯示文字 - 此選項可讓您輸入要在自適應表單中顯示的內容。
- 刪除 - 點選或按一下,以刪除核取方塊的選項。
- 重新排列 - 點選或按一下並拖曳,以重新排列面板的順序。
您也可以使用 允許選項使用 RTF 文字 來格式化核取方塊群組的選項。
選取 允許選項使用 RTF 文字 的核取方塊後,即可看到格式選項,以設定元件選項的樣式。若要存取所有可用的格式選項,您可以按一下
Fullscreen
-
繫結參考 - 繫結參考是指儲存在外部資料來源,並在表單中使用的資料元素的參考。繫結參考可讓您將資料動態繫結至表單欄位,讓表單可以顯示資料來源的最新資料。例如,繫結參考可用於根據輸入至表單的客戶 ID,在表單中顯示客戶的姓名和地址。繫結參考也可用於使用已輸入至表單中的資料更新資料來源。透過此方式,AEM Forms 可讓您建立與外部資料來源互動的表單,提供順暢無礙的使用者體驗,以收集和管理資料。
-
標示為未繫結的表單元素:選取該選項,以設定未連結至任何結構描述的表單欄位。此選項可讓您儲存資料,且無需更新資料來源。還可讓您以自訂方式處理資料,不同於標準資料庫整合。
-
提交值的資料類型 - 此選項會指定選取任何選項時傳送值的資料類型。如果 提交值的資料類型 設定為
Number
,且您將字串資料新增至 選項 索引標籤上的 資料值,則畫面會顯示Value type mismatch
錯誤訊息。 -
顯示選項 - 此選項是用來設定自適應表單中核取方塊的視覺對齊方式。支援的兩個選項為:
- 水平 - 選取此選項時,核取方塊會在自適應表單中由左至右顯示。
- 垂直 - 選取此選項時,核取方塊會在自適應表單中由上到下顯示。
-
預設選項 - 此選項可讓您在表單載入時新增預先選取的預設值。使用刪除圖示,即可移除已新增的選項。如果 提交值的資料類型 設定為
Number
,且您將字串資料新增至 預設選項,則畫面會顯示Value type mismatch
錯誤訊息。 -
隱藏元件 - 選取該選項,以隱藏表單中的元件。元件仍可供其他用途存取,例如將其用於規則編輯器中的計算。這在您需要儲存使用者不需看到或直接變更的資訊時十分有用。
-
停用元件 - 選取該選項以停用元件。一般使用者無法啟動或編輯已停用的元件。使用者可以看到該欄位的值,但無法修改。元件仍可供其他用途存取,例如將其用於規則編輯器中的計算。
-
唯讀 - 選取該選項,使元件無法編輯。使用者可以看到該欄位的值,但無法修改。元件仍可供其他用途存取,例如將其用於規則編輯器中的計算。
驗證索引標籤 validation-tab
-
必要 - 若要在自適應表單中顯示該元件,請選取此選項。選取該選項後,必須先進行選取,才能繼續提交表單。選取此選項後,您無法在 基本 索引標籤中選取 隱藏元件 或 停用元件。
-
錯誤訊息 - 此選項可讓您輸入訊息,在已勾選 必要 核取方塊且表單欄位留空時顯示。
-
指令碼驗證訊息 - 此選項可讓您輸入訊息,以在指令碼驗證失敗時顯示。
說明內容索引標籤 helpcontent-tab
-
簡短說明 - 簡短說明指的是簡短文字說明,提供特定表單欄位用途的其他資訊或說明。這有助於使用者了解應在該欄位中輸入的資料類型,並可提供指引或範例,以協助確保輸入的資訊有效並符合所需條件。預設情況下,簡短說明會保持隱藏。啟用 永遠顯示簡短說明 選項,使其顯示於元件下方。
-
永遠顯示簡短說明 - 啟用該選項,使簡短說明顯示於元件下方。
-
說明文字 - 說明文字指的是為使用者提供的其他資訊或指引,協助其正確填寫表單欄位。當使用者按一下放置於元件旁的說明圖示 (i) 時,就會出現此選項。說明文字提供的資訊比表單欄位的標籤或預留位置文字更加詳細,旨在協助使用者了解該欄位的要求或限制。還能夠提供建議或範例,使表單填寫更輕鬆、更準確。
協助工具索引標籤 accessibility-tab
-
螢幕助讀程式文字 - 螢幕助讀程式文字指的是專門供視障人士所使用的輔助技術 (如螢幕助讀程式) 朗讀的額外文字。此文字提供表單欄位用途的音訊說明,並可包含有關欄位標題、說明、名稱和任何相關訊息 (自訂文字) 的資訊。螢幕助讀程式文字協助確保表單可供所有使用者存取,包括視障人士,使他們能夠充分理解表單欄位及其要求。
- 自訂文字:選取此選項,以使用 ARIA 協助工具標籤的自訂文字。選取此選項會顯示自訂文字對話框。您可以在自訂文字對話框中新增相關資訊。
- 說明:選取此選項,以使用 ARIA 協助工具標籤的說明。
- 標題:選取此選項,以使用 ARIA 協助工具標籤的標題。
- 名稱:選取此選項,以使用 ARIA 協助工具標籤的名稱。
- 無:如果您不想新增 ARIA 協助工具標籤,請選取此選項。
設計對話框 design-dialog
設計對話框可用於定義和管理核取方塊群組元件的 CSS 樣式。
樣式索引標籤 styles-tab
自適應表單核取方塊群組核心元件支援 AEM 樣式系統。
-
預設 CSS 類別:您可以為自適應表單核取方塊群組核心元件提供預設 CSS 類別。
-
允許的樣式:您可以透過提供名稱以及代表該樣式的 CSS 類別,以定義樣式。例如,您可以建立名為「粗體文字」的樣式,並提供 CSS 類別「font-weight: bold」。您可以在自適應表單編輯器中,使用或套用這些樣式至自適應表單。若要套用樣式,請在自適應表單編輯器中選取您要套用樣式的元件,導覽至屬性對話框,然後從 樣式 下拉式清單中選取所需的樣式。如果需要更新或修改樣式,只需返回至設計對話框,更新樣式索引標籤中的樣式,然後儲存變更即可。
自訂屬性
自訂屬性可讓您使用表單範本,將自訂屬性 (鍵值對) 與自適應表單核心元件建立關聯。自訂屬性會反映在元件的無周邊轉譯屬性區段中。可讓您建立根據自訂屬性值調整的動態表單行為。例如,開發人員可以為行動裝置、桌上型電腦或網頁平台設計各種無周邊表單元件的轉譯,大幅提升各種裝置的使用者體驗。
-
群組名稱:您可以提供名稱,以識別自訂屬性群組。還可以新增、刪除或重新排列多個自訂屬性群組。新增自訂屬性群組後,您可以看到下列選項:
-
鍵值對:按一下每個自訂屬性群組的 新增 按鈕,即可新增多個自訂屬性名稱和自訂屬性值。
-
刪除:點選或按一下以刪除自訂屬性名稱和自訂屬性值。
-
重新排列:點選或按一下並拖曳,以重新排列自訂屬性名稱和自訂屬性值的順序。
-
相關文章 related-articles
)
另請參閱 see-also
- 建立 AEM 自適應表單
- 新增 AEM 自適應表單至 AEM Sites 頁面
- 將主題套用到 AEM 自適應表單
- 將元件新增至 AEM 自適應表單
- 在 AEM 自適應表單中使用 reCAPTCHA
- 產生 AEM 自適應表單的 PDF 版本 (DoR)
- 翻譯 AEM 自適應表單
- 為自適應表單啟用 Adobe Analytics 以追蹤表單使用情況
- 將自適應表單連接至 Microsoft SharePoint
- 將自適應表單連接至 Microsoft Power Automate
- 將自適應表單連接至 Microsoft OneDrive
- 將自適應表單連接至 Microsoft® Azure Blob 儲存體
- 將自適應表單連接至 Salesforce
- 在 AEM 自適應表單中使用 Adobe Sign
- 為自適應表單新增地區設定
- 將自適應表單資料傳送到資料庫
- 將自適應表單資料傳送到 REST 端點
- 將自適應表單資料傳送到 AEM 工作流程
- 使用表單入口列出 AEM 網站上的 AEM 自適應表單