文件AEM核心元件指南

下拉式清單元件 drop-down-list-adaptive-forms-core-component

Last update: Mon Oct 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

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

透過「自適應表單」中的下拉式清單，使用者可從預先定義的選項清單中選取一個或多個選項。選項類型可以是字串、數字或布林值。此外，下拉式清單元件可以設定為具有不同的驗證和預設值。

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

範例

範例

用途 reasons-to-use-drop-down-list

在「自適應表單」中加入下拉式清單有多項好處，包括：

  • 大量選項：下拉式清單適用於某個欄位具備大量可用選項的情況。與選項按鈕或核取方塊清單相比，在表單上佔用的空間較少，對使用者也不會造成太多負擔。

  • 一致性：下拉式清單可為表單的設計和版面提供一致性，讓使用者可以更輕鬆直覺地瀏覽。

  • 簡潔性：下拉式清單可提供清晰簡潔的選項清單，讓表單更加清楚易懂。

  • 使用者體驗：透過下拉式清單，可讓使用者以清晰直觀的方式選取選項，使表單更加易於使用。

  • 資料分析：下拉式清單可用於收集各種來源的資料，並加以分析，或用來作為進一步處理的輸入。

屬性對話框

屬性對話框

在此範例中，「選項」元素用於定義清單項目。顯示文字 ​元素用於提供清單項目標籤，而​ 資料值 ​則是用於指定提交表單時傳送至伺服器的值。

每個下拉式清單選項都具備唯一資料值和顯示文字屬性。如果使用者選取「紅色」選項，則對應的資料值會在提交表單時傳送至伺服器。接著，此資料可由伺服器端指令碼處理，以判斷使用者所選取的選項，並可用於執行各種動作，例如更新表單中的其他欄位，或將表單資料提交至伺服器端指令碼以便進一步處理。

此外，下拉式清單可設定為讓每個選項都具有不同的處理值，並可使用「自適應表單規則編輯器」進行設定。

版本和相容性 version-and-compatibility

「自適應表單下拉式清單核心元件」於 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 的技術文件中可找到「自適應表單下拉式清單核心元件」的最新資訊。如需開發核心元件的更多資訊，請參閱核心元件開發人員文件。

設定對話框 configure-dialog

透過「設定對話框」，您可以輕鬆自訂訪客的下拉式清單體驗。同樣能夠輕鬆定義下拉式清單選項，以提供順暢無礙的使用者體驗。

基本索引標籤

基本索引標籤

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

  • 標題 - 您可以使用其「標題」輕鬆識別表單中的元件，預設情況下，標題會顯示在元件上方。若未新增標題，則會顯示該元件的名稱而非標題文字。

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

    RTF 文字支援

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

  • 允許多重選取 - 選取此選項，從下拉式清單中選取多個選項。

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

    在​ 選項 ​索引標籤中，您可以使用​ 新增 ​按鈕來新增資料值和顯示文字組。新增新的選項後，會執行以下動作：

    • 資料值 - 此選項可讓您在選取選項時，輸入要提交的內容。
    • 顯示文字 - 此選項可讓您輸入要在「自適應表單」中顯示的內容。
    • 刪除 - 點選或按一下，以刪除下拉式選單的選項。
    • 重新排列 - 點選或按一下並拖曳，以重新排列下拉式選單的選項順序。

  • 預設選項 - 此選項可讓您新增預設值。若要移除已新增的選項，請使用刪除圖示。如果​ 將值另存為 ​設定為 Number，且您將字串資料新增至​ 預設選項，則畫面會顯示 Value type mismatch 錯誤訊息。

  • 預留位置文字 - 表單元件中的預留位置文字是指在輸入欄位中顯示的簡短標籤或提示，用於提示使用者在該欄位中預期輸入的資訊類型。當使用者開始在該欄位中輸入時，預留位置文字會消失，如果欄位留空，則會重新出現。這為使用者提供視覺提示，但不會作為該欄位的永久標籤或值。

  • 選項 - 您可以使用​ 新增 ​按鈕來新增資料值和顯示文字組。新增新的選項後，可以執行以下動作：

    • 資料值 - 此選項可讓您在選取選項時，輸入要提交的內容。
    • 顯示文字 - 此選項可讓您輸入要在自適應表單中顯示的內容。
    • 刪除 - 點選或按一下，以刪除核取方塊的選項。
    • 重新排列 - 點選或按一下並拖曳，以重新排列面板的順序。

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

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

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

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

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

驗證索引標籤 validation-tab

驗證索引標籤

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

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

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

說明內容索引標籤 help-content-tab

說明內容索引標籤

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

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

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

協助工具索引標籤 accessibility-tab

協助工具索引標籤

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

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

設計對話框 design-dialog

「設計對話框」可用於定義和管理下拉式清單元件的 CSS 樣式。

樣式索引標籤 styles-tab

此索引標籤可用於定義和管理元件的 CSS 樣式。「自適應表單下拉式清單核心元件」支援 AEM 樣式系統。

設計對話框

  • 預設 CSS 類別：您可以為「自適應表單下拉式清單核心元件」提供預設 CSS 類別。

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

自訂屬性

自訂屬性對話框

自訂屬性可讓您使用表單範本，將自訂屬性 (鍵值對) 與自適應表單核心元件建立關聯。自訂屬性會反映在元件的無周邊轉譯屬性區段中。可讓您建立根據自訂屬性值調整的動態表單行為。例如，開發人員可以為行動裝置、桌上型電腦或網頁平台設計各種無周邊表單元件的轉譯，大幅提升各種裝置的使用者體驗。

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

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

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

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

另請參閱 see-also

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