Select 控制項介紹

Select 從靜態選項、Custom URL 或 Model 資料來源選擇一個或多個值。它會加入所在 Form 的欄位狀態、驗證與提交範圍。

1. 適用情境

常見用途：

• 狀態、類型與列舉值
• 可搜尋的長選項清單
• 由後端動態回傳的選項

2. 新增與設定

1. 把 Select 加入 Form Section 的 Fields 區域。
2. 設定穩定且唯一的 Field Key / Name，並與後端 DTO 屬性一致。
3. 設定下列元件屬性，再視需要加入 Required、Help Text、Full row 與條件運算式。
4. 在 Design Preview 檢查初始值與版面，並使用 Form Validate / Submit 驗證完整資料流程。

3. 主要屬性

屬性	作用
Options	定義可選資料的來源與對應方式。
Data Source	定義可選資料的來源與對應方式。
Multiple	啟用或關閉此行為。
Selectable Count	限制允許的數量、長度或取值範圍。
Enable Search Box Input	啟用或關閉此行為。
Disabled	啟用或關閉此行為。

Field Key、Required、Help Text、Full row、Visible When 等通用屬性由 Form 欄位契約提供；本表列出使用 Select 時最需要注意的設定。

4. 表單值與後端契約

提交值： 單選時為穩定選項值，多選時為選項值陣列。

"engineering"

["engineering", "product"]

範例只說明資料形狀；API 仍應依業務 DTO 驗證型別、範圍與權限。

5. 驗證、條件與互動

所有欄位都可使用 Required、Visible When、Disabled When、Required When、Dependencies 與 Clear When Hidden。條件運算式只控制互動，不取代後端權限與驗證。

元件能力： 支援 onChange；選擇變更後可繼續執行 Page Interaction。

6. 使用建議

設定建議： 選項值應穩定並作為後端列舉或識別碼；顯示文案可國際化，但不可作為業務主鍵。

返回 Form 總覽，瞭解版面、驗證、提交、草稿與後端協定。