DIV CSS 佈局教程網

Validform 表單驗證完全整理:參數、規則、插件與 API 一次看懂
編輯:關於JavaScript     

幾乎每個後台專案都躲不掉表單驗證。自己刻一堆 if 判斷容易亂、也容易漏,因此我選擇了成熟的解法 Validform(本文以 v5.3.2 為例)。以下把初始化參數、自訂規則、常用外掛與物件方法整理成一份可查的筆記。

基本初始化結構

$(".demoform").Validform({
    btnSubmit: "#btn_sub",      // 綁定提交按鈕;如表單內已有 submit 鈕可省略
    btnReset: ".btn_reset",     // 選填,綁定重設按鈕
    tiptype: 1,                 // 提示方式,預設 1
    ignoreHidden: false,        // true 時跳過 :hidden 元素
    showAllError: false,        // true 時一次顯示所有錯誤
    postonce: true,             // 表單只能成功提交一次
    ajaxPost: true              // 以 ajax 方式提交,位置同 action
});

其中 $(".demoform") 指定要驗證的表單,這個 class 必須寫在 <form> 標籤上。

提示方式 tiptype 的四種取值

1 為彈出框(預設);2 為側邊提示,尋找 parent.next;3 為側邊提示,尋找 siblings;4 為側邊提示且不彈窗。除此之外也可以直接傳入一個 function,完全自的那一刻呈現效果。搭配 tipSweep: true 可做到只在送出時檢查、blur 不跳提示,讓表單在打字過程中保持安靜。

自訂驗證規則 datatype

Validform 允許你註冊自己的規則,值可以是正則表達式,也可以是函式。函式版本會收到「目前值、目前元素、整個表單、內建正則參照」等資訊,回傳 true 代表通過,回傳字串則會把該字串當成錯誤訊息顯示,回傳 false 就使用 errmsg 或預設文案。

datatype: {
    "*6-20": /^[^\s]{6,20}$/,
    "z2-4": /^[\u4E00-\u9FA5\uf900-\ufa2d]{2,4}$/,
    "username": function (gets, obj, curform, regxp) {
        var reg1 = /^[\w\.]{4,16}$/,
            reg2 = /^[\u4E00-\u9FA5\uf900-\ufa2d]{2,8}$/;
        if (reg1.test(gets)) { return true; }
        if (reg2.test(gets)) { return true; }
        return false;
    }
}

在 5.0 之後的版本,若要實作「二選一」這類互斥驗證,規則名稱不需要再以 option_ 開頭。

常用外掛 usePlugin

Validform 內建整合了幾個實用元件:swfupload(多檔上傳)、datepicker(日期選擇)、passwordstrength(密碼強度)、jqtransform(美化表單控件,透過 selector 指定範圍)。用起來只要宣告,不需另外初始化。

三個生命週期與回呼

beforeCheck(curform) 在驗證之前觸發,明確 return false 可中止驗證。beforeSubmit(curform) 在驗證通過、即將送出前觸發,return false 可攔下提交。callback(data) 則處理伺服器回應,data 為 JSON,例如 {"info":"demo info","status":"y"},status 用來判斷成功或失敗;若伺服器出錯,data 會帶有 status、statusText、readyState、responseText。要注意:非 ajax 提交時,callback 收到的 data 是表單物件本身。

Validform 物件的方法與屬性速查

tipmsg:自訂提示文案,可讓同頁不同表單顯示不同訊息。
dataType:取得內建正則。
eq(n):取得第 n 個元素。
ajaxPost(flag, sync, url):以 ajax 提交,flag 為 true 時跳過驗證,sync 為 true 時同步提交,傳入 url 可改提交位置。
abort():中止進行中的 ajax。
submitForm(flag, url):依參數設定提交。
resetForm()/resetStatus():重設表單,或重設提交狀態(啟用 postonce 後成功提交會變成 posted,重設後才能再次送出)。
getStatus()/setStatus(status):讀取或設定提交狀態,可為 normal、posting、posted。
ignore(selector)/unignore(selector):暫時忽略或恢復某些元素的驗證。
addRule(rule):動態為元素加上驗證規則。
check(bool, selector):驗證指定物件,通過回傳 true;bool 為 true 時只驗證不顯示提示。
config(setup):修改初始化參數、指定提交網址,或為 ajax 補上額外參數。

把這些參數與方法摸熟,表單驗證基本上就不用再手刻了。實務上我最常用的組合是:datatype 自訂規則 + tiptype: 4 側邊提示 + ajaxPost 搭配 callback,畫面乾淨、程式碼也最少。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved