凡要驗證格式的元素均需綁定datatype屬性,datatype可選值內置有10類,用來指定不同的驗證格式。
如果還不能滿足您的驗證需求,可以傳入自定義datatype,自定義datatype是一個非常強大的功能,通過它可以滿足你的任何需求。
可以綁定的附加屬性有:datatype、nullmsg、sucmsg、errormsg、ignore、recheck、tip、altercss、ajaxurl 和 plugin等.
說明:
內置基本的datatype類型有: * | *6-16 | n | n6-16 | s | s6-18 | p | m | e | url
*:檢測是否有輸入,可以輸入任何字符,不留空即可通過驗證;
*6-16:檢測是否為6到16位任意字符;
n:數字類型;
n6-16:6到16位數字;
s:字符串類型;
s6-18:6到18位字符串;
p:驗證是否為郵政編碼;
m:手機號碼格式;
e:email格式;
url:驗證字符串是否為網址。
自定義datatype的名稱,可以由字母、數字、下划線、中划線和*號組成。
形如"6-16"的datatype,Validform會自動擴展,可以指定任意的數值范圍。如內置基本類型有"6-16",那么你綁定datatype="*4-12"就表示4到12位任意字符。如果你自定義了一個datatype="zh2-4",表示2到4位中文字符,那么datatype="zh2-6"就表示2到6位中文字符。
5.2版本之后,datatype支持規則累加或單選。用","分隔表示規則累加;用"|"分隔表示規則多選一,即只要符合其中一個規則就可以通過驗證,綁定的規則會依次驗證,只要驗證通過,后面的規則就會忽略不再比較。如綁定datatype="m|e",表示既可以填寫手機號碼,也能填寫郵箱地址,如果知道填入的是手機號碼,那么就不會再檢測他是不是郵箱地址;datatype="zh,s2-4",表示要符合自定義類型"zh",也要符合規則"s2-4"。
注:
5.2.1版本之后,datatype支持:
直接綁定正則:如可用這樣寫datatype="/\w{3,6}/i",要求是3到6位的字母,不區分大小寫;
支持簡單的邏輯運算:如datatype="m | e, *4-18 | /\w{3,6}/i | /^validform.rjboy.cn$/",
這個表達式的意思是:可以是手機號碼;或者是郵箱地址,但字符長度必須在4到18位;或者是3到6位的字母,不區分大小寫;或者輸入validform.rjboy.cn,區分大小寫。這里","分隔相當於邏輯運算里的"&&"; "|"分隔相當於邏輯運算里的"||";不支持括號運算。
nullmsg
當表單元素值為空時的提示信息,不綁定,默認提示"請填入信息!"。
如:nullmsg="請填寫用戶名!"
5.3版開始,對於沒有綁定nullmsg的對象,會自動查找class為Validform_label下的文字作為提示文字:
如這樣的html結構:
<span class="Validform_label">*用戶名:</span><inputtype="text" val="" datatype="s" />
當這個文本框里沒有輸入時的出錯信息就會是:"請輸入用戶名!"
這里Validform_label跟input之間的位置關系,不一定是要同級關系,同級里沒有找到的話,它還會在同級的子級、父級的同級、父級的同級的子級里查找。
sucmsg 5.3+
當表單元素通過驗證時的提示信息,不綁定,默認提示"通過信息驗證!"。
如:sucmsg="用戶名還未被使用,可以注冊!"
5.3版開始,也可以在實時驗證返回的json數據里返回成功的提示文字,請查看附加屬性ajaxurl的介紹。
errormsg
輸入內容不能通過驗證時的提示信息,默認提示"請輸入正確信息!"。
如:errormsg="用戶名必須是2到4位中文字符!"
5.3版開始,Validform可以根據你綁定的datatype智能的輸出相應出錯信息,具體介紹請查看tipmsg
ignore
綁定了ignore="ignore"的表單元素,在有輸入時,會驗證所填數據是否符合datatype所指定數據類型,
沒有填寫內容時則會忽略對它的驗證;
recheck
表單里面經常需要檢查兩次密碼輸入是否一致,recheck就是用來指定需要比較的另外一個表單元素。
如:recheck="password1",那么它就會拿當前元素的值跟該表單下,name為"password1"的元素比較。
tip
表單里經常有些文本框需要默認就顯示一個灰色的提示文字,當獲得焦點時提示文字消失,失去焦點時提示文字顯示。tip屬性就是用來實現這個效果。它通常和altercss搭配使用。
如<input type="text"value="默認提示文字" class="gray intxt"tip="默認提示文字" altercss="gray" />
altercss
它需要和tip屬性配合使用,altercss指定的樣式名,會在文本框獲得焦點時被刪除,沒有輸入內容而失去焦點時重新加上。
ajaxurl
指定ajax實時驗證的后台文件的地址。
后台頁面如valid.php文件中可以用 $_POST["param"] 接收到值,Ajax中會POST過來變量param和name。param是文本框的值,name是文本框的name屬性。
5.2版本開始,可以在ajaxurl指定的url后綁定參數,如:
ajaxurl="valid.php?myparam1=value1&myparam2=value2";
5.3之前的版本中,該文件輸出的字符會作為錯誤信息顯示在頁面上,如果驗證通過需輸出小寫字母"y"。
在5.3版中,實時驗證的返回數據做了調整,須是含有status值的json數據!跟callback里的ajax返回數據格式統一,建議不再返回字符串"y"或"n"。目前這兩種格式的數據都兼容。
注:
如果ajax校驗通過,會在該元素上綁定validform_valid值為true。可以通過設置該值來控制驗證能不能通過,如驗證碼的驗證,第一次驗證通過后,不小心右點擊了下驗證碼圖片,驗證碼換了,但是仍然指示這個對象已經通過了驗證,這時可以手動調整該值:$("#name")[0].validform_valid="false"。
怎樣設置ajax的參數,具體可以查看Validform對象的config方法。
參考資料:
作者:Yumazhiyao
鏈接:https://www.jianshu.com/p/75caa9c46fdd
來源:簡書
著作權歸作者所有。商業轉載請聯系作者獲得授權,非商業轉載請注明出處。