自適應表單切換元件 switch-adaptive-forms-core-component

使用者互動：使用者可以透過按一下或點選與交換元件互動。

狀態：切換元件有兩個狀態：開啟和關閉。切換元件的初始狀態取決於其控制之功能的預設設定或目前狀態。

視覺化呈現：切換元件會透過變更顏色或位置，以視覺化方式反映其目前狀態。

控制功能：切換元件是用來啟用或停用 AEM 表單中的特定功能。例如，它可讓使用者開啟或關閉某個功能。

名稱 - 在表單和規則編輯器中，您可以使用其唯一名稱輕鬆識別表單元件，但該名稱不得包含空格或特殊字元。

標題 - 您可以使用其標題輕鬆識別表單中的元件，預設情況下，標題會顯示在元件旁邊。若未新增標題，則不會顯示元件。

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

隱藏標題 - 選取該選項，以隱藏元件標題。

保留取消勾選狀態值 - 選取此選項可指定未選取切換元件時要傳回的值。

選項 - 指定資料值，並顯示每個選項的文字。

• 開啟時的資料值 - 指定在自適應表單中啟用切換時要提交的值。
• 開啟時的顯示文字 - 指定在自適應表單中啟用切換時，要顯示為標籤的文字。
• 關閉時的資料值 - 指定在自適應表單中未啟用切換時要提交的值。只有在啟用​ 保留取消勾選狀態值 ​切換開關時，才能看到此選項。
• 關閉時的顯示文字 - 指定在自適應表單中未啟用切換時，要顯示為標籤的文字。只有在啟用​ 保留取消勾選狀態值 ​切換開關時，才能看到此選項。

您也可以使用​ 允許選項使用 RTF 文字 ​來格式化切換元件的選項。

選取​ 允許選項使用 RTF 文字 ​的核取方塊後，即可看到格式選項，以設定元件選項的樣式。若要存取所有可用的格式選項，您可以按一下 Fullscreen 索引標籤。

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

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

提交值的資料類型：此選項於選取任何選項後會指定其傳送值的資料類型。如果​ 提交值的資料類型 ​設定為 Number，且您將字串資料新增至​ 選項 ​索引標籤上的​ 資料值，則畫面會顯示 Value type mismatch 錯誤訊息。

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

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

預設值：此選項可讓您在表單欄位中新增預設值。如果選取​ 已停用的元件 ​或​ 唯讀元件，則畫面會顯示預設值。如果使用者在表單欄位中未輸入值，此值會在表單提交時提交。

必要 - 若要在自適應表單中顯示該元件，請選取此選項。選取該選項後，必須先進行選取，才能繼續提交表單。選取此選項後，您無法在​ 基本 ​索引標籤中選取​ 隱藏元件 ​或​ 停用元件。

錯誤訊息 - 此選項可讓您輸入訊息，在已勾選​ 必要 ​核取方塊且表單欄位留空時顯示。

指令碼驗證訊息 - 此選項可讓您輸入訊息，以在指令碼驗證失敗時顯示。

簡短說明 - 簡短說明指的是簡短文字說明，提供特定表單欄位用途的其他資訊或說明。這有助於使用者了解應在該欄位中輸入的資料類型，並可提供指引或範例，以協助確保輸入的資訊有效並符合所需條件。預設情況下，簡短說明會保持隱藏。啟用​ 永遠顯示簡短說明 ​選項，使其顯示於元件下方。

永遠顯示簡短說明 - 啟用該選項，使簡短說明顯示於元件下方。

說明文字 - 說明文字指的是為使用者提供的其他資訊或指引，協助其正確填寫表單欄位。當使用者按一下放置於元件旁的說明圖示 (i) 時，就會出現此選項。說明文字提供的資訊比表單欄位的標籤或預留位置文字更加詳細，旨在協助使用者了解該欄位的要求或限制。還能夠提供建議或範例，使表單填寫更輕鬆、更準確。

螢幕助讀程式文字 - 螢幕助讀程式文字指的是供視障人士所使用的輔助技術 (如螢幕助讀程式) 讀取的額外文字。此文字提供表單欄位用途的音訊說明，並可包含有關欄位標題、說明、名稱和任何相關訊息 (自訂文字) 的資訊。螢幕助讀程式文字協助確保表單可供所有使用者存取，包括視障人士，使他們能夠充分理解表單欄位及其要求。

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

隱藏標籤 - 選取此選項可隱藏切換元件的標籤。

顯示標籤 - 選取此選項可顯示切換元件的標籤。

預設 CSS 類別：您可以為自適應表單切換核心元件提供預設 CSS 類別。

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

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

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

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

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

摺疊面板

自適應表單片段

自適應表單 reCAPTCHA

按鈕

核取方塊群組

核取方塊

日期和時間

日期挑選器

下拉式清單

電子郵件

表單容器

表單標題

檔案附件

頁尾

頁首

影像

數值方塊

面板

電話

水平索引標籤

垂直索引標籤

選項按鈕

重設按鈕

檢閱

手寫簽名

提交按鈕

文字方塊

文字

條款與條件索引標籤

精靈