Text Area 控制項介紹
Text Area 用於輸入可換行的長文字。它會加入所在 Form 的欄位狀態、驗證與提交範圍。
1. 適用情境
常見用途：
- 說明、備註與理由
- 地址或問題描述
- 需要調整初始高度的長文字
2. 新增與設定
- 把 Text Area 加入 Form Section 的 Fields 區域。
- 設定穩定且唯一的 Field Key / Name，並與後端 DTO 屬性一致。
- 設定下列元件屬性，再視需要加入 Required、Help Text、Full row 與條件運算式。
- 在 Design Preview 檢查初始值與版面，並使用 Form Validate / Submit 驗證完整資料流程。
3. 主要屬性
| 屬性 | 作用 |
|---|---|
| Default Text | 設定欄位使用的初始值、內容或格式。 |
| Initial Height (Rows) | 控制欄位在 Design Preview 與 Runtime 中的顯示方式。 |
| Maximum Height (Rows) | 限制允許的數量、長度或取值範圍。 |
| Hint | 控制欄位在 Design Preview 與 Runtime 中的顯示方式。 |
| Read Only | 啟用或關閉此行為。 |
| Validator | 定義表單繫結、提交或回應的資料形狀。 |
Field Key、Required、Help Text、Full row、Visible When 等通用屬性由 Form 欄位契約提供；本表列出使用 Text Area 時最需要注意的設定。
4. 表單值與後端契約
提交值： 一個字串。
"Please prepare access before the start date."
範例只說明資料形狀；API 仍應依業務 DTO 驗證型別、範圍與權限。
5. 驗證、條件與互動
所有欄位都可使用 Required、Visible When、Disabled When、Required When、Dependencies 與 Clear When Hidden。條件運算式只控制互動，不取代後端權限與驗證。
元件能力： 支援 onChange、onFocus 與 setValue，可把值變更接到後續動作。
6. 使用建議
設定建議： 為業務欄位設定明確長度限制；密碼不可寫入預設值、日誌或 Page Context。
返回 Form 總覽，瞭解版面、驗證、提交、草稿與後端協定。