選項按鈕元件 radio-button-adaptive-forms-core-component
最適化表單中的選項按鈕是一種輸入元素,可讓使用者從一組相關選項中選取一個選項。 它由一個小的圓形按鈕表示,該按鈕已填滿或空白,以指示是否選取該選項。 當使用者選取一個選項按鈕時,群組中的其他按鈕會變為取消選取。 當有多個互斥選項且一次只能選取一個選項時,通常會使用選項按鈕。
範例
屬性對話方塊
在此範例中,Options元素用於將選項按鈕群組在一起。 此 顯示文字 元素可用來提供專案的標籤,以及 資料值 用於指定在提交表單時傳送至伺服器的值。
每個選項按鈕選項都有唯一的「資料」值和「顯示文字」屬性。 如果使用者選取「1-10」,則表單提交時會將對應的資料值傳送到伺服器。 接著,伺服器端指令碼可處理此資料,以判斷使用者選取的選項,且可用於執行各種動作,例如更新表單中的其他欄位,或將表單資料提交至伺服器端指令碼以供進一步處理。
此外,每個選項按鈕都可設定為每個選項提供不同的處理值,並可使用最適化Forms規則編輯器進行設定
使用情況 reasons-to-use-radio-button
在表單中使用選項按鈕有幾個理由,包括:
-
有限的選擇:單選按鈕可用來提供預先定義的選項清單,供使用者選擇,一次只能選取一個選項。 當選項的數量有限且互斥時,此選項會很有用。
-
清除表示方式:選項按鈕清晰易懂,可讓使用者輕鬆瞭解所要選取的內容。
-
一致性:使用選項按鈕可確保向使用者呈現選項的方式一致且標準化,讓他們更輕鬆地瞭解表單並與之互動。
-
更易於使用:單選按鈕簡單易用,尤其是對於不熟悉技術或行動能力有限的使用者。
版本和相容性 version-and-compatibility
最適化Forms摺疊式功能表核心元件於2023年2月發行,屬於AEM 6.5.16.0 Forms或更新版本適用的Cloud Service核心元件2.0.4和核心元件1.1.12的一部分。 下表顯示所有支援版本、AEM相容性以及對應檔案的連結:
如需核心元件版本的詳細資訊,請參閱 核心元件版本 檔案。
技術細節 technical-details
在的技術檔案中取得最適化Forms選項按鈕核心元件的最新資訊: GitHub. 如需開發核心元件的詳細資訊,請參閱 核心元件開發人員檔案.
設定對話方塊 configure-dialog
您可以透過「設定」對話方塊輕鬆自訂訪客的單選按鈕體驗。 您也可以輕鬆定義選項按鈕選項,以提供順暢的使用者體驗。
-
名稱 — 在表單和規則編輯器中,您可以使用表單元件的唯一名稱輕鬆識別表單元件,但名稱不得包含空格或特殊字元。
-
標題 — 您可以使用其Title輕鬆識別表單中的元件,預設情況下,標題會顯示在元件上方。 如果您未新增標題,則會顯示元件的名稱而非標題文字。
-
允許標題使用RTF文字 — 此功能可讓使用者格式化純文字標題,並整合如粗體、斜體、底線文字、各種字型、字型大小、顏色,以及其他可增強視覺呈現和自訂的選項。 它提供更大的彈性和創意控制,讓標題在檔案、網站或應用程式中脫穎而出。
選取「 」的核取方塊時 允許標題使用RTF文字 ,可顯示格式選項以設定元件標題的樣式。 若要存取所有可用的格式選項,您可以按一下 標籤。 -
隱藏標題 — 選取可隱藏元件標題的選項。
-
選項 — 您可以新增資料值並顯示文字配對,使用 新增 按鈕。
新增選項後,可以執行下列動作:- 資料值 — 此選項可讓您輸入在選取選項時要提交的內容。
- 顯示文字 — 此選項可讓您輸入要在最適化表單中顯示的內容。
- 刪除 — 點選或按一下以刪除選項按鈕的選項。
- 重新排列 — 點選或按一下並拖曳以重新排列選項。
您也可以使用來格式化選項按鈕群組的選項 允許選項使用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
索引標籤可用來定義和管理元件的CSS樣式。 最適化Forms選項按鈕核心元件支援AEM 樣式系統.
-
預設CSS類別:您可以為最適化Forms選項按鈕核心元件提供預設CSS類別。
-
允許的樣式:您可以提供名稱以及代表樣式的CSS類別來定義樣式。 例如,您可以建立名為「粗體文字」的樣式,並提供CSS類別「font-weight: bold」。 您可以在最適化Forms編輯器中將這些樣式使用或套用至最適化表單。 若要套用樣式,請在最適化Forms編輯器中,選取您要套用樣式的元件,導覽至「屬性」對話方塊,然後從 樣式 下拉式清單。 如果您需要更新或修改樣式,只要返回「設計」對話方塊,更新樣式索引標籤中的樣式,然後儲存變更即可。
自訂屬性
自訂屬性可讓您使用表單範本,將自訂屬性(索引鍵/值組)與最適化表單核心元件建立關聯。 自訂屬性會反映在元件Headless轉譯的properties區段中。 它可讓您建立根據自訂屬性值調整的動態表單行為。 例如,開發人員可以為行動、桌上型電腦或Web平台設計各種無頭Forms元件的轉譯,大幅提升各種裝置的使用者體驗。
-
群組名稱:您可以提供名稱來識別自訂屬性群組。 您可以新增、刪除或重新排列多個自訂屬性群組。 新增自訂屬性群組後,您可以看到下列選項:
-
索引鍵值配對:您可以按一下「 」,新增多個自訂屬性名稱和自訂屬性值 新增 按鈕來設定每個自訂屬性群組。
-
刪除:點選或按一下以刪除自訂屬性名稱和自訂屬性值。
-
重新排列:點選或按一下並拖曳,以重新排列自訂屬性名稱和自訂屬性值的順序。
-
相關文章 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 Workflow
- 使用Forms入口網站列出AEM網站上的AEM Adaptive Forms