Address 控制項介紹

Address 用於輸入可自由編輯的地址文字。它會加入所在 Form 的欄位狀態、驗證與提交範圍。

1. 適用情境

常見用途：

• 郵寄地址
• 辦公地點
• 不需要拆分縣市區的地址說明

2. 新增與設定

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

3. 主要屬性

屬性	作用
Required	啟用或關閉此行為。
Help Text	控制欄位在 Design Preview 與 Runtime 中的顯示方式。
Full row	控制欄位在 Design Preview 與 Runtime 中的顯示方式。
Visible When	定義表單繫結、提交或回應的資料形狀。
Disabled When	定義表單繫結、提交或回應的資料形狀。
Clear When Hidden	啟用或關閉此行為。

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

4. 表單值與後端契約

提交值： 一個字串。

"123 Market Street, Toronto"

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

5. 驗證、條件與互動

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

元件能力： 欄位值會進入 Form 狀態；只有屬性面板實際顯示的事件可用於 Interaction。

6. 使用建議

設定建議： 為業務欄位設定明確長度限制；密碼不可寫入預設值、日誌或 Page Context。

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