Form 表單

gk-form 與 gk-form-item 負責標籤、必填星號與錯誤訊息，包住 Input、Select、InputNumber、Rate、Cascader、Upload、TreeSelect、Transfer。元件本身不會在窄螢幕自動改成上下排；寬度約 640px 以下請由應用綁定 label-placement="top"。

範例

訂單

電子郵件一開始是無效的，所以錯誤會直接出現。只有全部通過時，submit 才會帶出 { model }。驗證是同步的。

台北市新北市件最多 200 字送出重設

<gk-form label-width="7.5rem">

標籤在上

<gk-form label-placement="top">

API

label-placement 預設 left。必填星號是危險色文字，並且 aria-hidden；控制項本身帶 aria-required。錯誤時設定 aria-invalid 與 aria-describedby。

validate() 回傳 { valid, errors }。restoreValidation() 清除錯誤。重設會改同一個 model 物件。規則若回傳 Promise，會得到「尚不支援非同步驗證」。

gk-rate 沒有狀態框線，錯誤只顯示在說明文字。Upload、Transfer 也是。TreeSelect 會跟著驗證狀態改框線。feedback 會蓋過規則產生的訊息。