Validform使用入門(mén)

看見(jiàn)就非常 2014-09-23

展開(kāi)全文

1、引入css

請(qǐng)查看下載文件中的style.css，把里面Validform必須部分復(fù)制到你的css中（文件里這個(gè)注釋 "/*==========以下部分是Validform必須的===========*/" 之后的部分是必須的）。之前發(fā)現(xiàn)有部分網(wǎng)友把整個(gè)style.css都引用在了頁(yè)面里，然后發(fā)現(xiàn)樣式?jīng)_突了。

2、引入js （jquery 1.4.3 以上版本都可以）

1
2

<script type="text/javascript" src="http://validform./wp-content/themes/validform/js/jquery-1.6.2.min.js"></script>
<script type="text/javascript" src="http://validform./Validform/v5.1/Validform_v5.1_min.js"></script>

3、給需要驗(yàn)證的表單元素綁定附加屬性

1
2
3

<form class="demoform">
<input type="text" value="" name="name" datatype="s5-16" errormsg="昵稱至少5個(gè)字符,最多16個(gè)字符！" />
</form>

4、初始化，就這么簡(jiǎn)單

1	$(".demoform").Validform();

注：
1、Validform有非壓縮、壓縮和NCR三個(gè)版本提供下載，NCR是通用版，當(dāng)你頁(yè)面因編碼問(wèn)題，提示文字出現(xiàn)亂碼時(shí)可以使用這個(gè)版本；
2、Validform沒(méi)有限定必須使用table結(jié)構(gòu)，它可以適用于任何結(jié)構(gòu)，需要在tiptype中定義好位置關(guān)系。

綁定附加屬性

凡要驗(yàn)證格式的元素均需綁定datatype屬性，datatype可選值內(nèi)置有10類(lèi)，用來(lái)指定不同的驗(yàn)證格式。
如果還不能滿足您的驗(yàn)證需求，可以傳入自定義datatype，自定義datatype是一個(gè)非常強(qiáng)大的功能，通過(guò)它可以滿足你的任何需求。

可以綁定的附加屬性有：datatype、nullmsg、sucmsg、errormsg、ignore、recheck、tip、altercss、ajaxurl 和 plugin

綁定方法如下所示：

<!--ajax實(shí)時(shí)驗(yàn)證用戶名-->
<input type="text" value="" name="name" datatype="e" ajaxurl="valid.php?myparam1=value1&myparam2=value2" sucmsg="用戶名驗(yàn)證通過(guò)！" nullmsg="請(qǐng)輸入用戶名！" errormsg="請(qǐng)用郵箱或手機(jī)號(hào)碼注冊(cè)！"  />
 
<!--密碼-->
<input type="password" value="" name="userpassword" datatype="*6-15" errormsg="密碼范圍在6~15位之間！" />
<!--確認(rèn)密碼-->
<input type="password" value="" name="userpassword2" datatype="*" recheck="userpassword" errormsg="您兩次輸入的賬號(hào)密碼不一致！" />
 
<!--默認(rèn)提示文字-->
<textarea tip="請(qǐng)?jiān)谶@里輸入您的意見(jiàn)。" errormsg="很感謝您花費(fèi)寶貴時(shí)間給我們提供反饋，請(qǐng)?zhí)顚?xiě)有效內(nèi)容！"  datatype="s" altercss="gray" class="gray" name="msg" value="">請(qǐng)?jiān)谶@里輸入您的意見(jiàn)。</textarea>
 
<!--使用swfupload插件-->
<input type="text" plugin="swfupload" class="inputxt" disabled="disabled" value="">
<input type="hidden" value="" pluginhidden="swfupload">
 
<!--使用passwordStrength插件-->
<input type="password" errormsg="密碼至少6個(gè)字符,最多18個(gè)字符！" datatype="*6-18" plugin="passwordStrength" class="inputxt" name="password" value="">
<div class="passwordStrength" style="display:none;"><b>密碼強(qiáng)度：</b> <span>弱</span><span>中</span><span class="last">強(qiáng)</span></div>
 
<!--使用DatePicker插件-->
<input type="text" plugin="datepicker" class="inputxt" name="birthday" value="">

說(shuō)明：

datatype
內(nèi)置基本的datatype類(lèi)型有： * | *6-16 | n | n6-16 | s | s6-18 | p | m | e | url
*：檢測(cè)是否有輸入，可以輸入任何字符，不留空即可通過(guò)驗(yàn)證；
*6-16：檢測(cè)是否為6到16位任意字符；
n：數(shù)字類(lèi)型；
n6-16：6到16位數(shù)字；
s：字符串類(lèi)型；
s6-18：6到18位字符串；
p：驗(yàn)證是否為郵政編碼；
m：手機(jī)號(hào)碼格式；
e：email格式；
url：驗(yàn)證字符串是否為網(wǎng)址。
自定義datatype的名稱，可以由字母、數(shù)字、下劃線、中劃線和*號(hào)組成。

形如"*6-16"的datatype，Validform會(huì)自動(dòng)擴(kuò)展，可以指定任意的數(shù)值范圍。如內(nèi)置基本類(lèi)型有"*6-16"，那么你綁定datatype="*4-12"就表示4到12位任意字符。如果你自定義了一個(gè)datatype="zh2-4"，表示2到4位中文字符，那么datatype="zh2-6"就表示2到6位中文字符。

5.2版本之后，datatype支持規(guī)則累加或單選。用","分隔表示規(guī)則累加；用"|"分隔表示規(guī)則多選一，即只要符合其中一個(gè)規(guī)則就可以通過(guò)驗(yàn)證，綁定的規(guī)則會(huì)依次驗(yàn)證，只要驗(yàn)證通過(guò)，后面的規(guī)則就會(huì)忽略不再比較。如綁定datatype="m|e"，表示既可以填寫(xiě)手機(jī)號(hào)碼，也能填寫(xiě)郵箱地址，如果知道填入的是手機(jī)號(hào)碼，那么就不會(huì)再檢測(cè)他是不是郵箱地址；datatype="zh,s2-4"，表示要符合自定義類(lèi)型"zh"，也要符合規(guī)則"s2-4"。

注：
5.2.1版本之后，datatype支持：
直接綁定正則：如可用這樣寫(xiě)datatype="/\w{3,6}/i"，要求是3到6位的字母，不區(qū)分大小寫(xiě)；
支持簡(jiǎn)單的邏輯運(yùn)算：如datatype="m | e, *4-18 | /\w{3,6}/i | /^validform\.rjboy\.cn$/"，
這個(gè)表達(dá)式的意思是：可以是手機(jī)號(hào)碼；或者是郵箱地址，但字符長(zhǎng)度必須在4到18位；或者是3到6位的字母，不區(qū)分大小寫(xiě)；或者輸入validform.，區(qū)分大小寫(xiě)。這里","分隔相當(dāng)于邏輯運(yùn)算里的"&&"； "|"分隔相當(dāng)于邏輯運(yùn)算里的"||"；不支持括號(hào)運(yùn)算。
nullmsg
當(dāng)表單元素值為空時(shí)的提示信息，不綁定，默認(rèn)提示"請(qǐng)?zhí)钊胄畔ⅲ?。
如：nullmsg="請(qǐng)?zhí)顚?xiě)用戶名！"
5.3版開(kāi)始，對(duì)于沒(méi)有綁定nullmsg的對(duì)象，會(huì)自動(dòng)查找class為Validform_label下的文字作為提示文字:
如這樣的html結(jié)構(gòu)：
<span class="Validform_label">*用戶名：</span><input type="text" val="" datatype="s" />
當(dāng)這個(gè)文本框里沒(méi)有輸入時(shí)的出錯(cuò)信息就會(huì)是："請(qǐng)輸入用戶名！"
這里Validform_label跟input之間的位置關(guān)系，不一定是要同級(jí)關(guān)系，同級(jí)里沒(méi)有找到的話，它還會(huì)在同級(jí)的子級(jí)、父級(jí)的同級(jí)、父級(jí)的同級(jí)的子級(jí)里查找。
sucmsg ^5.3+
當(dāng)表單元素通過(guò)驗(yàn)證時(shí)的提示信息，不綁定，默認(rèn)提示"通過(guò)信息驗(yàn)證！"。
如：sucmsg="用戶名還未被使用，可以注冊(cè)！"
5.3版開(kāi)始，也可以在實(shí)時(shí)驗(yàn)證返回的json數(shù)據(jù)里返回成功的提示文字，請(qǐng)查看附加屬性ajaxurl的介紹。
errormsg
輸入內(nèi)容不能通過(guò)驗(yàn)證時(shí)的提示信息，默認(rèn)提示"請(qǐng)輸入正確信息！"。
如：errormsg="用戶名必須是2到4位中文字符！"
5.3版開(kāi)始，Validform可以根據(jù)你綁定的datatype智能的輸出相應(yīng)出錯(cuò)信息，具體介紹請(qǐng)查看tipmsg
ignore
綁定了ignore="ignore"的表單元素，在有輸入時(shí)，會(huì)驗(yàn)證所填數(shù)據(jù)是否符合datatype所指定數(shù)據(jù)類(lèi)型，
沒(méi)有填寫(xiě)內(nèi)容時(shí)則會(huì)忽略對(duì)它的驗(yàn)證；
recheck
表單里面經(jīng)常需要檢查兩次密碼輸入是否一致，recheck就是用來(lái)指定需要比較的另外一個(gè)表單元素。
如：recheck="password1"，那么它就會(huì)拿當(dāng)前元素的值跟該表單下，name為"password1"的元素比較。
tip
表單里經(jīng)常有些文本框需要默認(rèn)就顯示一個(gè)灰色的提示文字，當(dāng)獲得焦點(diǎn)時(shí)提示文字消失，失去焦點(diǎn)時(shí)提示文字顯示。tip屬性就是用來(lái)實(shí)現(xiàn)這個(gè)效果。它通常和altercss搭配使用。
如<input type="text" value="默認(rèn)提示文字" class="gray intxt" tip="默認(rèn)提示文字" altercss="gray" />
altercss
它需要和tip屬性配合使用，altercss指定的樣式名，會(huì)在文本框獲得焦點(diǎn)時(shí)被刪除，沒(méi)有輸入內(nèi)容而失去焦點(diǎn)時(shí)重新加上。
ajaxurl
指定ajax實(shí)時(shí)驗(yàn)證的后臺(tái)文件的地址。
后臺(tái)頁(yè)面如valid.php文件中可以用 $_POST["param"] 接收到值，Ajax中會(huì)POST過(guò)來(lái)變量param和name。param是文本框的值，name是文本框的name屬性。
5.2版本開(kāi)始，可以在ajaxurl指定的url后綁定參數(shù)，如：ajaxurl="valid.php?myparam1=value1&myparam2=value2"； 5.3.1開(kāi)始，地址后面附帶的參數(shù)內(nèi)部不再做另外解析，仍附帶在地址后面，所以需要用GET方式去獲取地址后面帶的參數(shù)。
5.3之前的版本中，該文件輸出的字符會(huì)作為錯(cuò)誤信息顯示在頁(yè)面上，如果驗(yàn)證通過(guò)需輸出小寫(xiě)字母"y"。
在5.3版中，實(shí)時(shí)驗(yàn)證的返回?cái)?shù)據(jù)做了調(diào)整，須是含有status值的json數(shù)據(jù)！跟callback里的ajax返回?cái)?shù)據(jù)格式統(tǒng)一，建議不再返回字符串"y"或"n"。目前這兩種格式的數(shù)據(jù)都兼容。
注：
如果ajax校驗(yàn)通過(guò)，會(huì)在該元素上綁定validform_valid值為true?？梢酝ㄟ^(guò)設(shè)置該值來(lái)控制驗(yàn)證能不能通過(guò)，如驗(yàn)證碼的驗(yàn)證，第一次驗(yàn)證通過(guò)后，不小心右點(diǎn)擊了下驗(yàn)證碼圖片，驗(yàn)證碼換了，但是仍然指示這個(gè)對(duì)象已經(jīng)通過(guò)了驗(yàn)證，這時(shí)可以手動(dòng)調(diào)整該值：$("#name")[0].validform_valid="false"。
怎樣設(shè)置ajax的參數(shù)，具體可以查看Validform對(duì)象的config方法。
plugin
指定需要使用的插件。
5.3版開(kāi)始，對(duì)于日期、swfupload和密碼強(qiáng)度檢測(cè)這三個(gè)插件，綁定了plugin屬性即可以初始化對(duì)應(yīng)的插件，可以不用在validform初始化時(shí)傳入空的usePlugin了。
如，你要使用日期插件，5.3之前版本需要這樣初始化：
```
$(".demoform").Validform({
    usePlugin:{
    	datepicker:{}
    }
});
5.3版開(kāi)始，不需要傳入這些空對(duì)象了，只需在表單元素上綁定plugin="datepicker"就可以，初始化直接這樣：
$(".demoform").Validform();
```

初始化參數(shù)說(shuō)明

所有可用參數(shù)如下：

$(".demoform").Validform({
	btnSubmit:"#btn_sub", 
	btnReset:".btn_reset",
	tiptype:1, 
	ignoreHidden:false,
	dragonfly:false,
	tipSweep:true,
	label:".label",
	showAllError:false,
	postonce:true,
	ajaxPost:true,
	datatype:{
		"*6-20": /^[^\s]{6,20}$/,
		"z2-4" : /^[\u4E00-\u9FA5\uf900-\ufa2d]{2,4}$/,
		"username":function(gets,obj,curform,regxp){
			//參數(shù)gets是獲取到的表單元素值，obj為當(dāng)前表單元素，curform為當(dāng)前驗(yàn)證的表單，regxp為內(nèi)置的一些正則表達(dá)式的引用;
			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;
 
			//注意return可以返回true 或 false 或 字符串文字，true表示驗(yàn)證通過(guò)，返回字符串表示驗(yàn)證失敗，字符串作為錯(cuò)誤提示顯示，返回false則用errmsg或默認(rèn)的錯(cuò)誤提示;
		},
		"phone":function(){
			// 5.0 版本之后，要實(shí)現(xiàn)二選一的驗(yàn)證效果，datatype 的名稱 不 需要以 "option_" 開(kāi)頭;	
		}
	},
	usePlugin:{
		swfupload:{},
		datepicker:{},
		passwordstrength:{},
		jqtransform:{
			selector:"select,input"
		}
	},
	beforeCheck:function(curform){
		//在表單提交執(zhí)行驗(yàn)證之前執(zhí)行的函數(shù)，curform參數(shù)是當(dāng)前表單對(duì)象。
		//這里明確return false的話將不會(huì)繼續(xù)執(zhí)行驗(yàn)證操作;	
	},
	beforeSubmit:function(curform){
		//在驗(yàn)證成功后，表單提交前執(zhí)行的函數(shù)，curform參數(shù)是當(dāng)前表單對(duì)象。
		//這里明確return false的話表單將不會(huì)提交;	
	},
	callback:function(data){
		//返回?cái)?shù)據(jù)data是json對(duì)象，{"info":"demo info","status":"y"}
		//info: 輸出提示信息;
		//status: 返回提交數(shù)據(jù)的狀態(tài),是否提交成功。如可以用"y"表示提交成功，"n"表示提交失敗，在ajax_post.php文件返回?cái)?shù)據(jù)里自定字符，主要用在callback函數(shù)里根據(jù)該值執(zhí)行相應(yīng)的回調(diào)操作;
		//你也可以在ajax_post.php文件返回更多信息在這里獲取，進(jìn)行相應(yīng)操作；
		//ajax遇到服務(wù)端錯(cuò)誤時(shí)也會(huì)執(zhí)行回調(diào)，這時(shí)的data是{ status:**, statusText:**, readyState:**, responseText:** }；
 
		//這里執(zhí)行回調(diào)操作;
		//注意：如果不是ajax方式提交表單，傳入callback，這時(shí)data參數(shù)是當(dāng)前表單對(duì)象，回調(diào)函數(shù)會(huì)在表單驗(yàn)證全部通過(guò)后執(zhí)行，然后判斷是否提交表單，如果callback里明確return false，則表單不會(huì)提交，如果return true或沒(méi)有return，則會(huì)提交表單。
	}
});

參數(shù)說(shuō)明：【所有參數(shù)均為可選項(xiàng)】

必須是表單對(duì)象執(zhí)行Validform方法，示例中".demoform"就是綁定在form元素上的class名稱；
btnSubmit
指定當(dāng)前表單下的哪一個(gè)按鈕觸發(fā)表單提交事件，如果表單下有submit按鈕時(shí)可以省略該參數(shù)。示例中".btn_sub"是該表單下要綁定點(diǎn)擊提交表單事件的按鈕；
btnReset
".btn_reset"是該表單下要綁定點(diǎn)擊重置表單事件的按鈕;
tiptype
可用的值有：1、2、3、4和function函數(shù)，默認(rèn)tiptype為1。 3、4是5.2.1版本新增
1=> 自定義彈出框提示；
2=> 側(cè)邊提示(會(huì)在當(dāng)前元素的父級(jí)的next對(duì)象的子級(jí)查找顯示提示信息的對(duì)象，表單以ajax提交時(shí)會(huì)彈出自定義提示框顯示表單提交狀態(tài))；
3=> 側(cè)邊提示(會(huì)在當(dāng)前元素的siblings對(duì)象中查找顯示提示信息的對(duì)象，表單以ajax提交時(shí)會(huì)彈出自定義提示框顯示表單提交狀態(tài))；
4=> 側(cè)邊提示(會(huì)在當(dāng)前元素的父級(jí)的next對(duì)象下查找顯示提示信息的對(duì)象，表單以ajax提交時(shí)不顯示表單的提交狀態(tài))；
如果上面的4種提示方式不是你需要的，你可以給tiptype傳入自定義函數(shù)。通過(guò)自定義函數(shù)，可以實(shí)現(xiàn)你想要的任何提示效果：
```
tiptype:function(msg,o,cssctl){
    //msg：提示信息;
    //o:{obj:*,type:*,curform:*},
    //obj指向的是當(dāng)前驗(yàn)證的表單元素（或表單對(duì)象，驗(yàn)證全部驗(yàn)證通過(guò)，提交表單時(shí)o.obj為該表單對(duì)象），
    //type指示提示的狀態(tài)，值為1、2、3、4， 1：正在檢測(cè)/提交數(shù)據(jù)，2：通過(guò)驗(yàn)證，3：驗(yàn)證失敗，4：提示ignore狀態(tài), 
    //curform為當(dāng)前form對(duì)象;
    //cssctl:內(nèi)置的提示信息樣式控制函數(shù)，該函數(shù)需傳入兩個(gè)參數(shù)：顯示提示信息的對(duì)象 和 當(dāng)前提示的狀態(tài)（既形參o中的type）;
}
具體參見(jiàn)demo頁(yè)。
```
tiptype不為1時(shí)，Validform會(huì)查找class為"Validform_checktip"的標(biāo)簽顯示提示信息。tiptype=1時(shí)，會(huì)自動(dòng)創(chuàng)建彈出框顯示提示信息。
Validform_checktip和表單元素之間的位置關(guān)系，會(huì)根據(jù)tiptype的值有對(duì)應(yīng)的結(jié)構(gòu)，上面已經(jīng)做了說(shuō)明。
5.3版本開(kāi)始，如果頁(yè)面里沒(méi)有顯示出錯(cuò)信息的標(biāo)簽，會(huì)根據(jù)tiptype值自動(dòng)創(chuàng)建Validform_checktip對(duì)象。
ignoreHidden
可用值： true | false。
默認(rèn)為false，當(dāng)為true時(shí)對(duì):hidden的表單元素將不做驗(yàn)證;
dragonfly
可用值： true | false。
默認(rèn)false，當(dāng)為true時(shí)，值為空時(shí)不做驗(yàn)證；
tipSweep
可用值： true | false。
默認(rèn)為false， 5.3版中做了修正，在各種tiptype下，為true時(shí)提示信息將只會(huì)在表單提交時(shí)觸發(fā)顯示，各表單元素blur時(shí)不會(huì)觸發(fā)信息提示；
label ^5.3.1+
選擇符
在沒(méi)有綁定nullmsg時(shí)查找要顯示的提示文字，默認(rèn)查找".Validform_label"下的文字；
showAllError
可用值： true | false。
默認(rèn)為false，true：提交表單時(shí)所有錯(cuò)誤提示信息都會(huì)顯示；false：一碰到驗(yàn)證不通過(guò)的對(duì)象就會(huì)停止檢測(cè)后面的元素，只顯示該元素的錯(cuò)誤信息；
postonce
可用值： true | false。
默認(rèn)為false，指定是否開(kāi)啟二次提交防御，true開(kāi)啟，不指定則默認(rèn)關(guān)閉；
為true時(shí)，在數(shù)據(jù)成功提交后，表單將不能再繼續(xù)提交。
ajaxPost
可用值： true | false。
默認(rèn)為false，使用ajax方式提交表單數(shù)據(jù)，將會(huì)把數(shù)據(jù)POST到config方法或表單action屬性里設(shè)定的地址；

datatype
傳入自定義datatype類(lèi)型，可以是正則，也可以是函數(shù)。

datatyp:{
    "zh2-4":/^[\u4E00-\u9FA5\uf900-\ufa2d]{2,4}$/,
    "phone":function(gets,obj,curform,regxp){
        //參數(shù)gets是獲取到的表單元素值，
        //obj為當(dāng)前表單元素，
        //curform為當(dāng)前驗(yàn)證的表單，
        //regxp為內(nèi)置的一些正則表達(dá)式的引用。
        
        //return false表示驗(yàn)證出錯(cuò)，沒(méi)有return或者return true表示驗(yàn)證通過(guò)。
    }
}

具體示例請(qǐng)參考demo頁(yè)；

usePlugin
目前已整合swfupload、datepicker、passwordstrength和jqtransform四個(gè)插件，在這里傳入這些插件使用時(shí)需要傳入的參數(shù)。datepicker在Validform內(nèi)調(diào)用時(shí)另外擴(kuò)展了幾個(gè)比較實(shí)用的參數(shù)，具體請(qǐng)參考demo頁(yè)；
beforeCheck(curform)
在表單提交執(zhí)行驗(yàn)證之前執(zhí)行的函數(shù)，curform參數(shù)獲取到的是當(dāng)前表單對(duì)象。
函數(shù)return false的話將不會(huì)繼續(xù)執(zhí)行驗(yàn)證操作;
beforeSubmit(curform)
在表單驗(yàn)證通過(guò)，提交表單數(shù)據(jù)之前執(zhí)行的函數(shù)，data參數(shù)是當(dāng)前表單對(duì)象。
函數(shù)return false的話表單將不會(huì)提交;
callback
在使用ajax提交表單數(shù)據(jù)時(shí)，數(shù)據(jù)提交后的回調(diào)函數(shù)。返回?cái)?shù)據(jù)data是Json對(duì)象：
{"info":"demo info","status":"y"}
info: 輸出提示信息，
status: 返回提交數(shù)據(jù)的狀態(tài),是否提交成功，"y"表示提交成功，"n"表示提交失敗，在ajax_post.php文件返回?cái)?shù)據(jù)里自定字符，主要用在callback函數(shù)里根據(jù)該值執(zhí)行相應(yīng)的回調(diào)操作。你也可以在ajax_post.php文件返回更多信息在這里獲取，進(jìn)行相應(yīng)操作；
如果不是ajax方式提交表單，傳入callback，這時(shí)data參數(shù)是當(dāng)前表單對(duì)象，回調(diào)函數(shù)會(huì)在表單驗(yàn)證全部通過(guò)后執(zhí)行，然后判斷是否提交表單，如果callback里return false，則表單不會(huì)提交，如果return true或沒(méi)有return，則會(huì)提交表單。
5.3版開(kāi)始，ajax遇到服務(wù)端錯(cuò)誤時(shí)也會(huì)執(zhí)行回調(diào)，這時(shí)的data是{ status:**, statusText:**, readyState:**, responseText:** }

Validform對(duì)象[方法支持鏈?zhǔn)秸{(diào)用]

如示例 var demo=$(".formsub").Validform()，那么demo對(duì)象會(huì)有以下屬性和方法可以調(diào)用：

tipmsg【object】

如：demo.tipmsg.s="error! no message inputed.";

通過(guò)該對(duì)象可以修改除 tit 以外的其他提示文字，這樣可以實(shí)現(xiàn)同一個(gè)頁(yè)面的不同表單使用不同的提示文字。

具體可修改的提示文字
$.Tipmsg={//默認(rèn)提示文字;
tit:"提示信息",
w:{
    "*":"不能為空！",
    "*6-16":"請(qǐng)?zhí)顚?xiě)6到16位任意字符！",
    "n":"請(qǐng)?zhí)顚?xiě)數(shù)字！",
    "n6-16":"請(qǐng)?zhí)顚?xiě)6到16位數(shù)字！",
    "s":"不能輸入特殊字符！",
    "s6-18":"請(qǐng)?zhí)顚?xiě)6到18位字符！",
    "p":"請(qǐng)?zhí)顚?xiě)郵政編碼！",
    "m":"請(qǐng)?zhí)顚?xiě)手機(jī)號(hào)碼！",
    "e":"郵箱地址格式不對(duì)！",
    "url":"請(qǐng)?zhí)顚?xiě)網(wǎng)址！"
},
def:"請(qǐng)?zhí)顚?xiě)正確信息！",
undef:"datatype未定義！",
reck:"兩次輸入的內(nèi)容不一致！",
r:"通過(guò)信息驗(yàn)證！",
c:"正在檢測(cè)信息…",
s:"請(qǐng){填寫(xiě)|選擇}{0|信息}！",
v:"所填信息沒(méi)有經(jīng)過(guò)驗(yàn)證，請(qǐng)稍后…",
p:"正在提交數(shù)據(jù)…"
};

要修改tit（彈出框的標(biāo)題文字）的話，可以這樣：$.Tipmsg.tit="Message Box"，則彈出框的標(biāo)題文字會(huì)換成"Message Box"

注：^5.3.2+
$.Tipmsg.w里，形如"*6-16"的提示文字，里面的數(shù)字是會(huì)被替換的。如綁定datatype="*2-18"，那它默認(rèn)的出錯(cuò)信息就會(huì)是"請(qǐng)?zhí)顚?xiě)2到18位任意字符！"，可以通過(guò)$.Tipmsg.w或Validform對(duì)象的tipmsg屬性修改和擴(kuò)展默認(rèn)錯(cuò)誤信息，如果你已經(jīng)設(shè)置了"zh2-4"的提示信息是"2-4位中文",那么"zh2-8"出錯(cuò)的信息就自動(dòng)會(huì)是："2-8位中文"。對(duì)于自定義的datatype，在擴(kuò)展默認(rèn)信息時(shí)，注意錯(cuò)誤信息的名字要跟datatype名字一樣，如上面示例是：$.Tipmsg.w["zh2-4"]="2-4位中文"。對(duì)于多頁(yè)面或一個(gè)頁(yè)面多表單有相同datatype來(lái)說(shuō)，在$.Tipmsg.w或Validform對(duì)象的tipmsg屬性中擴(kuò)展默認(rèn)提示信息是個(gè)很好的選擇。
5.3.1+
$.Tipmsg.s是用來(lái)指定在沒(méi)有綁定nullmsg時(shí)的默認(rèn)提示信息。"{0}"是會(huì)被找到的label參數(shù)指定的對(duì)象或Validform_label里的文字替換掉的，"{填寫(xiě)|選擇}"里的文字在綁定了"recheck"屬性的表單元素上檢測(cè)時(shí)是會(huì)不顯示的，當(dāng)前驗(yàn)證對(duì)象是radio、checkbox或select時(shí)，會(huì)輸出"選擇"，是其他類(lèi)型的元素時(shí)會(huì)輸出"填寫(xiě)"和后面的"信息"。

具體示例請(qǐng)參見(jiàn)demo頁(yè)。

dataType【object】

獲取內(nèi)置的一些正則：

{
    "match":/^(.+?)(\d+)-(\d+)$/,
    "*":/[\w\W]+/,
    "*6-16":/^[\w\W]{6,16}$/,
    "n":/^\d+$/,
    "n6-16":/^\d{6,16}$/,
    "s":/^[\u4E00-\u9FA5\uf900-\ufa2d\w\.\s]+$/,
    "s6-18":/^[\u4E00-\u9FA5\uf900-\ufa2d\w\.\s]{6,18}$/,
    "p":/^[0-9]{6}$/,
    "m":/^13[0-9]{9}$|14[0-9]{9}|15[0-9]{9}$|18[0-9]{9}$/,
    "e":/^\w+([-+.']\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*$/,
    "url":/^(\w+:\/\/)?\w+(\.\w+)+.*$/
}

addRule(rule)【返回值：Validform】

可以通過(guò)Validform對(duì)象的這個(gè)方法來(lái)給表單元素綁定驗(yàn)證規(guī)則，綁定驗(yàn)證類(lèi)型中列出的附加屬性都可以通過(guò)這個(gè)方法綁定。

demo.addRule([
    {
        ele:"#name",
        datatype:"s6-18",
        ajaxurl:"valid.php",
        nullmsg:"請(qǐng)輸入昵稱！",
        errormsg:"昵稱至少6個(gè)字符,最多18個(gè)字符！"
    },
    {
        ele:"#userpassword",
        datatype:"*6-16",
        nullmsg:"請(qǐng)?jiān)O(shè)置密碼！",
        errormsg:"密碼范圍在6~16位之間！"
    },
    {
        ele:"#userpassword2",
        datatype:"*",
        recheck:"userpassword",
        nullmsg:"請(qǐng)?jiān)佥斎胍淮蚊艽a！",
        errormsg:"您兩次輸入的賬號(hào)密碼不一致！"
    }
]);

其中ele是指定要綁定規(guī)則的對(duì)象，會(huì)在Validform對(duì)象下查找這些對(duì)象。

eq(n)【返回值：Validform】

獲取Validform對(duì)象的第n個(gè)元素。

如你頁(yè)面上有多個(gè)form的class都是formsub，執(zhí)行上面的驗(yàn)證綁定，得到的demo對(duì)象就可以操作所有這些表單，如果你要對(duì)其中某個(gè)表單執(zhí)行某些操作，那么就可以使用這個(gè)方法。

如demo.eq(0).resetForm()，重置第一個(gè)表單。

ajaxPost(flag,sync,url)【返回值：Validform】

以ajax方式提交表單。flag為true時(shí)，跳過(guò)驗(yàn)證直接提交，sync為true時(shí)將以同步的方式進(jìn)行ajax提交。

參數(shù)url是5.3版新增，傳入了url地址時(shí)，表單會(huì)提交到這個(gè)地址

如demo.ajaxPost(true)，不做驗(yàn)證直接ajax提交表單。

abort()【返回值：Validform】

終止ajax的提交。

如執(zhí)行上面的ajaxPost()之后，發(fā)現(xiàn)某些項(xiàng)填寫(xiě)不對(duì)，想取消表單提交，那么就可以執(zhí)行這個(gè)操作：demo.abort()

submitForm(flag,url)【返回值：Validform】

以初始化時(shí)傳入?yún)?shù)的設(shè)置方式提交表單，flag為true時(shí)，跳過(guò)驗(yàn)證直接提交。

參數(shù)url是5.3版新增，傳入了url地址時(shí)，表單會(huì)提交到這個(gè)地址

如demo.submitForm(true)，不做驗(yàn)證直接提交表單。

resetForm()【返回值：Validform】

重置表單。

如demo.resetForm()，重置表單到初始狀態(tài)。

resetStatus()【返回值：Validform】

重置表單的提交狀態(tài)。傳入了postonce參數(shù)的話，表單成功提交后狀態(tài)會(huì)設(shè)置為"posted"，重置提交狀態(tài)可以讓表單繼續(xù)可以提交。

如demo.resetStatus()

getStatus()【返回值：String】

獲取表單的提交狀態(tài)，normal：未提交，posting：正在提交，posted：已成功提交過(guò)。

如demo.getStatus()

setStatus(status)【返回值：Validform】

設(shè)置表單的提交狀態(tài)，可以設(shè)置normal，posting，posted三種狀態(tài)，不傳參則設(shè)置狀態(tài)為posting，這個(gè)狀態(tài)表單可以驗(yàn)證，但不能提交。

如demo.setStatus("posted")

ignore(selector)【返回值：Validform】

忽略對(duì)所選擇對(duì)象的驗(yàn)證，不傳入selector則忽略所有表單元素。

如demo.ignore("select,textarea,#name")，忽略Validform對(duì)象下所有select，textarea及一個(gè)id為"name"元素的驗(yàn)證。

unignore(selector)【返回值：Validform】

將ignore方法所忽略驗(yàn)證的對(duì)象重新獲取驗(yàn)證效果，不傳入selector則恢復(fù)驗(yàn)證所有表單元素。

如demo.unignore("select,textarea,#name")，恢復(fù)Validform對(duì)象下所有select，textarea及一個(gè)id為"name"元素的驗(yàn)證。

check(bool,selector)【返回值：Boolean】

bool為true時(shí)則只驗(yàn)證不顯示提示信息

對(duì)指定對(duì)象進(jìn)行驗(yàn)證(默認(rèn)驗(yàn)證當(dāng)前整個(gè)表單)，通過(guò)返回true，否則返回false（綁定實(shí)時(shí)驗(yàn)證的對(duì)象，格式符合要求時(shí)返回true，而不會(huì)等ajax的返回結(jié)果）

如demo.check()，驗(yàn)證當(dāng)前整個(gè)表單，且只驗(yàn)證但不顯示對(duì)錯(cuò)信息。

config(setup) ^5.3+ 【返回值：Validform】

setup參數(shù)是一個(gè)對(duì)象。

如:
demo.config({
    showAllError:true,
    url:"這里指定提交地址",
    ajaxpost:{
        //可以傳入$.ajax()能使用的，除dataType外的所有參數(shù);
    },
    ajaxurl:{
        //可以傳入$.ajax()能使用的，除dataType外的所有參數(shù);
    }
})

可用參數(shù)：
tiptype等 ^5.3.2+：可以在這里設(shè)置初始化可用的所有參數(shù)
url：指定表單的提交路徑，這里指定的路徑會(huì)覆蓋表單action屬性所指定的路徑
ajaxpost：表單以ajax提交時(shí)，可以在這里配置ajax的參數(shù)
ajaxurl：配置實(shí)時(shí)驗(yàn)證ajax的參數(shù)

①、config方法還能為已經(jīng)初始化過(guò)的表單重新配置參數(shù)了！^5.3.2+
如var demo=$(".formsub").Validform(); 
demo.config({tiptype:2});
demo下的各表單還能分別配置不同參數(shù)！
如demo.eq(0).config({tiptype:1,ajaxPost:true});
demo.eq(1).config({tiptype:1,callback:function(curform){my_method_to_submit_form(); return false;}});

②、執(zhí)行config可以動(dòng)態(tài)設(shè)置、添加參數(shù)，如：
demo.config({
    url:"http://validform."
});
$(".save").click(function(){
    demo.config({
        ajaxpost:{
            timeout:1000
        }
    });
});
那么在點(diǎn)擊save按鈕后，demo所對(duì)應(yīng)的表單的config={
    url:"http://validform.",
    ajaxpost:{
        timeout:1000
    }
}
③、參數(shù)url的優(yōu)先級(jí)：form表單的action所指定的提交地址會(huì)被config.url覆蓋，
config.url會(huì)被config.ajaxpost.url覆蓋，config.ajaxpost.url會(huì)被Validform對(duì)象的方法submitForm(flag,url)
和ajaxPost(flag,sync,url)里的url覆蓋。
如果表單里沒(méi)有指定action提交地址，那么就會(huì)提交到config.url設(shè)定的地址。
考慮到整個(gè)驗(yàn)證框架的邏輯，傳入dataType參數(shù)不會(huì)起作用，不會(huì)被覆蓋，ajax必須返回含有status值的json數(shù)據(jù)。

④、另外注意的是：傳入的success和error方法里，能多獲取到一個(gè)參數(shù)，如：
demo.config={
    ajaxpost:{
    	url:"",
        timeout:1000,
        ...,
        success:function(data,obj){
            //data是返回的json數(shù)據(jù);
            //obj是當(dāng)前表單的jquery對(duì)象;
        },
        error:function(data,obj){
            //data是{ status:**, statusText:**, readyState:**, responseText:** };
            //obj是當(dāng)前表單的jquery對(duì)象;
        }
    },
    ajaxurl:{
        success:function(data,obj){
            //data是返回的json數(shù)據(jù);
            //obj是當(dāng)前正做實(shí)時(shí)驗(yàn)證表單元素的jquery對(duì)象;
            //注意：5.3版中，實(shí)時(shí)驗(yàn)證的返回?cái)?shù)據(jù)須是含有status值的json數(shù)據(jù)！
            //跟callback里的ajax返回?cái)?shù)據(jù)格式統(tǒng)一，建議不再返回字符串"y"或"n"。目前這兩種格式的數(shù)據(jù)都兼容。
        }
    }
}

調(diào)用外部插件

$.Datatype

可以通過(guò)$.Datatype對(duì)象來(lái)擴(kuò)展datatype類(lèi)型。

如$.Datatype.zh=/^[\u4E00-\u9FA5\uf900-\ufa2d]{1,}$/

$.Tipmsg

可以通過(guò)$.Tipmsg對(duì)象來(lái)修改默認(rèn)提示文字。具體可修改的提示文字請(qǐng)查看Validform對(duì)象的tipmsg屬性。

如果Validform對(duì)象的tipmsg屬性沒(méi)有找到相關(guān)的提示信息，那么就會(huì)到$.Tipmsg中查找對(duì)應(yīng)提示文字。

如$.Tipmsg.tit="msg box"; //設(shè)置默認(rèn)彈出框的標(biāo)題文字。

$.Showmsg(msg)

調(diào)用Validform自定義的彈出框。

參數(shù)msg是要顯示的提示文字。

如$.Showmsg("這是提示文字"); //如果不傳入信息則不會(huì)有彈出框出現(xiàn)，像$.Showmsg()這樣是不會(huì)彈出提示框的。

$.Hidemsg()

關(guān)閉Validform自定義的彈出框。

如$.Hidemsg()

本站是提供個(gè)人知識(shí)管理的網(wǎng)絡(luò)存儲(chǔ)空間，所有內(nèi)容均由用戶發(fā)布，不代表本站觀點(diǎn)。請(qǐng)注意甄別內(nèi)容中的聯(lián)系方式、誘導(dǎo)購(gòu)買(mǎi)等信息，謹(jǐn)防詐騙。如發(fā)現(xiàn)有害或侵權(quán)內(nèi)容，請(qǐng)點(diǎn)擊一鍵舉報(bào)。

轉(zhuǎn)藏 分享

QQ空間 QQ好友新浪微博微信

獻(xiàn)花（0） +1

來(lái)自：看見(jiàn)就非常 > 《tip》

舉報(bào)/認(rèn)領(lǐng)