Cascade Select 控制項介紹

Cascade Select 沿階層選項逐級選擇一條路徑。它會加入所在 Form 的欄位狀態、驗證與提交範圍。

1. 適用情境

常見用途：

• 國家、縣市與區域
• 產品分類路徑
• 業務領域與子領域

2. 新增與設定

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

3. 主要屬性

屬性	作用
Options	定義可選資料的來源與對應方式。
Model Relation Data Source	定義可選資料的來源與對應方式。
Enable Search	啟用或關閉此行為。
Parent Selectable	啟用或關閉此行為。
Required	啟用或關閉此行為。

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

4. 表單值與後端契約

提交值： 從根節點到所選葉節點的選項值陣列。

["canada", "ontario", "toronto"]

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

5. 驗證、條件與互動

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

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

6. 使用建議

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

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