EasyUI 的 validatebox 除了本機規則,還能透過 remote 把驗證工作丟給伺服器。這在處理「帳號是否已被註冊」「優惠碼是否存在」這類必須查詢資料庫的情境時特別有用。
先釐清 validType 本身的形態,它可以是:
三種形態對應的範例如下:
<input class="easyui-validatebox" data-options="required:true,validType:'url'" />
<input class="easyui-validatebox" data-options="required:true,validType:['email','length[0,20]']" />
<input class="easyui-validatebox" data-options="required:true,validType:{length:[10,30],remote:['https://.../action.do','paramName']}" />
一旦設定了 remote,元件就會送出一次 Ajax 請求,把欄位目前的值帶到後端;只有當回應內容為 true 時,驗證才算通過。
物件寫法中,陣列的第一項是請求位址,第二項則是送出時使用的參數名稱。若省略第二項,EasyUI 會預設用欄位的 name 當參數名。回應格式建議直接輸出純文字的 true 或 false,也可以回傳 JSON 字串,例如 {"valid":false,"message":"此帳號已被使用"},這樣就能自訂錯誤訊息。
後端一定要把驗證結果以明確的布林值回傳,任何多餘的 HTML 或空白都可能導致前端解析失敗。此外,遠端驗證只該當成「即時提示」,真正的資料檢核仍必須在送出表單時於伺服器端再做一次——前端驗證可以被繞過,這點永遠不例外。
若同一欄位同時掛上本機規則與 remote,建議把 remote 放在最後,讓格式檢查先攔掉明顯錯誤的輸入,減少無謂的請求。