表單驗證之validform.js使用方法


Validform使用入門

1、引入css

請查看下載文件中的style.css,把里面Validform必須部分復制到你的css中(文件里這個注釋 "/*==========以下部分是Validform必須的===========*/" 之后的部分是必須的)。之前發現有部分網友把整個style.css都引用在了頁面里,然后發現樣式沖突了。

2、引入js (jquery 1.4.3 以上版本都可以)

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

3、給需要驗證的表單元素綁定附加屬性

1
2
3
<form class="demoform">
<input type="text" value="" name="name" datatype="s5-16" errormsg="昵稱至少5個字符,最多16個字符!" />
</form>

4、初始化,就這么簡單

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

注:
1、Validform有非壓縮、壓縮和NCR三個版本提供下載,NCR是通用版,當你頁面因編碼問題,提示文字出現亂碼時可以使用這個版本;
2、Validform沒有限定必須使用table結構,它可以適用於任何結構,需要在tiptype中定義好位置關系。

綁定附加屬性

凡要驗證格式的元素均需綁定datatype屬性,datatype可選值內置有10類,用來指定不同的驗證格式。
如果還不能滿足您的驗證需求,可以傳入自定義datatype,自定義datatype是一個非常強大的功能,通過它可以滿足你的任何需求。

可以綁定的附加屬性有:datatypenullmsgsucmsgerrormsgignorerechecktipaltercssajaxurlplugin

綁定方法如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
<!--ajax實時驗證用戶名-->
<input type="text" value="" name="name" datatype="e" ajaxurl="valid.php?myparam1=value1&myparam2=value2" sucmsg="用戶名驗證通過!" nullmsg="請輸入用戶名!" errormsg="請用郵箱或手機號碼注冊!"  />
 
<!--密碼-->
<input type="password" value="" name="userpassword" datatype="*6-15" errormsg="密碼范圍在6~15位之間!" />
<!--確認密碼-->
<input type="password" value="" name="userpassword2" datatype="*" recheck="userpassword" errormsg="您兩次輸入的賬號密碼不一致!" />
 
<!--默認提示文字-->
<textarea tip="請在這里輸入您的意見。" errormsg="很感謝您花費寶貴時間給我們提供反饋,請填寫有效內容!"  datatype="s" altercss="gray" class="gray" name="msg" value="">請在這里輸入您的意見。</textarea>
 
<!--使用swfupload插件-->
<input type="text" plugin="swfupload" class="inputxt" disabled="disabled" value="">
<input type="hidden" value="" pluginhidden="swfupload">
 
<!--使用passwordStrength插件-->
<input type="password" errormsg="密碼至少6個字符,最多18個字符!" datatype="*6-18" plugin="passwordStrength" class="inputxt" name="password" value="">
<div class="passwordStrength" style="display:none;"><b>密碼強度:</b> <span>弱</span><span>中</span><span class="last">強</span></div>
 
<!--使用DatePicker插件-->
<input type="text" plugin="datepicker" class="inputxt" name="birthday" value="">

說明:

  • datatype
    內置基本的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><input type="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.1開始,地址后面附帶的參數內部不再做另外解析,仍附帶在地址后面,所以需要用GET方式去獲取地址后面帶的參數。
    5.3之前的版本中,該文件輸出的字符會作為錯誤信息顯示在頁面上,如果驗證通過需輸出小寫字母"y"。
    在5.3版中,實時驗證的返回數據做了調整,須是含有status值的json數據!跟callback里的ajax返回數據格式統一,建議不再返回字符串"y"或"n"。目前這兩種格式的數據都兼容。
    注:
    如果ajax校驗通過,會在該元素上綁定validform_valid值為true。可以通過設置該值來控制驗證能不能通過,如驗證碼的驗證,第一次驗證通過后,不小心右點擊了下驗證碼圖片,驗證碼換了,但是仍然指示這個對象已經通過了驗證,這時可以手動調整該值:$("#name")[0].validform_valid="false"。
    怎樣設置ajax的參數,具體可以查看Validform對象的config方法。
  • plugin
    指定需要使用的插件。
    5.3版開始,對於日期、swfupload和密碼強度檢測這三個插件,綁定了plugin屬性即可以初始化對應的插件,可以不用在validform初始化時傳入空的usePlugin了。
    如,你要使用日期插件,5.3之前版本需要這樣初始化:
    $(".demoform").Validform({
        usePlugin:{
        	datepicker:{}
        }
    });
    5.3版開始,不需要傳入這些空對象了,只需在表單元素上綁定plugin="datepicker"就可以,初始化直接這樣:
    $(".demoform").Validform();
初始化參數說明

所有可用參數如下:

1
2

3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
$(".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){ //參數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;   //注意return可以返回true 或 false 或 字符串文字,true表示驗證通過,返回字符串表示驗證失敗,字符串作為錯誤提示顯示,返回false則用errmsg或默認的錯誤提示; }, "phone":function(){ // 5.0 版本之后,要實現二選一的驗證效果,datatype 的名稱 不 需要以 "option_" 開頭; } }, usePlugin:{ swfupload:{}, datepicker:{}, passwordstrength:{}, jqtransform:{ selector:"select,input" } }, beforeCheck:function(curform){ //在表單提交執行驗證之前執行的函數,curform參數是當前表單對象。 //這里明確return false的話將不會繼續執行驗證操作; }, beforeSubmit:function(curform){ //在驗證成功后,表單提交前執行的函數,curform參數是當前表單對象。 //這里明確return false的話表單將不會提交; }, callback:function(data){ //返回數據data是json對象,{"info":"demo info","status":"y"} //info: 輸出提示信息; //status: 返回提交數據的狀態,是否提交成功。如可以用"y"表示提交成功,"n"表示提交失敗,在ajax_post.php文件返回數據里自定字符,主要用在callback函數里根據該值執行相應的回調操作; //你也可以在ajax_post.php文件返回更多信息在這里獲取,進行相應操作; //ajax遇到服務端錯誤時也會執行回調,這時的data是{ status:**, statusText:**, readyState:**, responseText:** };   //這里執行回調操作; //注意:如果不是ajax方式提交表單,傳入callback,這時data參數是當前表單對象,回調函數會在表單驗證全部通過后執行,然后判斷是否提交表單,如果callback里明確return false,則表單不會提交,如果return true或沒有return,則會提交表單。 } }); 

參數說明:【所有參數均為可選項】

  • 必須是表單對象執行Validform方法,示例中".demoform"就是綁定在form元素上的class名稱;
  • btnSubmit
    指定當前表單下的哪一個按鈕觸發表單提交事件,如果表單下有submit按鈕時可以省略該參數。示例中".btn_sub"是該表單下要綁定點擊提交表單事件的按鈕;
  • btnReset
    ".btn_reset"是該表單下要綁定點擊重置表單事件的按鈕;
  • tiptype
    可用的值有:1、2、3、4和function函數,默認tiptype為1。 3、4是5.2.1版本新增
    1=> 自定義彈出框提示;
    2=> 側邊提示(會在當前元素的父級的next對象的子級查找顯示提示信息的對象,表單以ajax提交時會彈出自定義提示框顯示表單提交狀態);
    3=> 側邊提示(會在當前元素的siblings對象中查找顯示提示信息的對象,表單以ajax提交時會彈出自定義提示框顯示表單提交狀態);
    4=> 側邊提示(會在當前元素的父級的next對象下查找顯示提示信息的對象,表單以ajax提交時不顯示表單的提交狀態);
    如果上面的4種提示方式不是你需要的,你可以給tiptype傳入自定義函數。通過自定義函數,可以實現你想要的任何提示效果:
    tiptype:function(msg,o,cssctl){
        //msg:提示信息;
        //o:{obj:*,type:*,curform:*},
        //obj指向的是當前驗證的表單元素(或表單對象,驗證全部驗證通過,提交表單時o.obj為該表單對象),
        //type指示提示的狀態,值為1、2、3、4, 1:正在檢測/提交數據,2:通過驗證,3:驗證失敗,4:提示ignore狀態, 
        //curform為當前form對象;
        //cssctl:內置的提示信息樣式控制函數,該函數需傳入兩個參數:顯示提示信息的對象 和 當前提示的狀態(既形參o中的type);
    }
    具體參見demo頁。
    tiptype不為1時,Validform會查找class為"Validform_checktip"的標簽顯示提示信息。tiptype=1時,會自動創建彈出框顯示提示信息。
    Validform_checktip和表單元素之間的位置關系,會根據tiptype的值有對應的結構,上面已經做了說明。
    5.3版本開始,如果頁面里沒有顯示出錯信息的標簽,會根據tiptype值自動創建Validform_checktip對象。
  • ignoreHidden
    可用值: true | false。
    默認為false,當為true時對:hidden的表單元素將不做驗證;
  • dragonfly
    可用值: true | false。
    默認false,當為true時,值為空時不做驗證;
  • tipSweep
    可用值: true | false。
    默認為false, 5.3版中做了修正,在各種tiptype下, 為true時提示信息將只會在表單提交時觸發顯示,各表單元素blur時不會觸發信息提示;
  • label 5.3.1+
    選擇符
    在沒有綁定nullmsg時查找要顯示的提示文字,默認查找".Validform_label"下的文字;
  • showAllError
    可用值: true | false。
    默認為false,true:提交表單時所有錯誤提示信息都會顯示;false:一碰到驗證不通過的對象就會停止檢測后面的元素,只顯示該元素的錯誤信息;
  • postonce
    可用值: true | false。
    默認為false,指定是否開啟二次提交防御,true開啟,不指定則默認關閉;
    為true時,在數據成功提交后,表單將不能再繼續提交。
  • ajaxPost
    可用值: true | false。
    默認為false,使用ajax方式提交表單數據,將會把數據POST到config方法或表單action屬性里設定的地址;
  • datatype
    傳入自定義datatype類型,可以是正則,也可以是函數。
    datatyp:{
        "zh2-4":/^[\u4E00-\u9FA5\uf900-\ufa2d]{2,4}$/,
        "phone":function(gets,obj,curform,regxp){
            //參數gets是獲取到的表單元素值,
            //obj為當前表單元素,
            //curform為當前驗證的表單,
            //regxp為內置的一些正則表達式的引用。
            
            //return false表示驗證出錯,沒有return或者return true表示驗證通過。
        }
    }
    具體示例請參考demo頁;
  • usePlugin
    目前已整合swfupload、datepicker、passwordstrength和jqtransform四個插件,在這里傳入這些插件使用時需要傳入的參數。datepicker在Validform內調用時另外擴展了幾個比較實用的參數,具體請參考demo頁;
  • beforeCheck(curform)
    在表單提交執行驗證之前執行的函數,curform參數獲取到的是當前表單對象。
    函數return false的話將不會繼續執行驗證操作;
  • beforeSubmit(curform)
    在表單驗證通過,提交表單數據之前執行的函數,data參數是當前表單對象。
    函數return false的話表單將不會提交;
  • callback
    在使用ajax提交表單數據時,數據提交后的回調函數。返回數據data是Json對象:
    {"info":"demo info","status":"y"}
    info: 輸出提示信息,
    status: 返回提交數據的狀態,是否提交成功,"y"表示提交成功,"n"表示提交失敗,在ajax_post.php文件返回數據里自定字符,主要用在callback函數里根據該值執行相應的回調操作。你也可以在ajax_post.php文件返回更多信息在這里獲取,進行相應操作;
    如果不是ajax方式提交表單,傳入callback,這時data參數是當前表單對象,回調函數會在表單驗證全部通過后執行,然后判斷是否提交表單,如果callback里return false,則表單不會提交,如果return true或沒有return,則會提交表單。
    5.3版開始,ajax遇到服務端錯誤時也會執行回調,這時的data是{ status:**, statusText:**, readyState:**, responseText:** }
Validform對象 [方法支持鏈式調用]

如示例 var demo=$(".formsub").Validform(),那么demo對象會有以下屬性和方法可以調用:

tipmsg【object】

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

通過該對象可以修改除 tit 以外的其他提示文字,這樣可以實現同一個頁面的不同表單使用不同的提示文字。

具體可修改的提示文字
$.Tipmsg={//默認提示文字;
tit:"提示信息",
w:{
    "*":"不能為空!",
    "*6-16":"請填寫6到16位任意字符!",
    "n":"請填寫數字!",
    "n6-16":"請填寫6到16位數字!",
    "s":"不能輸入特殊字符!",
    "s6-18":"請填寫6到18位字符!",
    "p":"請填寫郵政編碼!",
    "m":"請填寫手機號碼!",
    "e":"郵箱地址格式不對!",
    "url":"請填寫網址!"
},
def:"請填寫正確信息!",
undef:"datatype未定義!",
reck:"兩次輸入的內容不一致!",
r:"通過信息驗證!",
c:"正在檢測信息…",
s:"請{填寫|選擇}{0|信息}!",
v:"所填信息沒有經過驗證,請稍后…",
p:"正在提交數據…"
};

要修改tit(彈出框的標題文字)的話,可以這樣:$.Tipmsg.tit="Message Box",則彈出框的標題文字會換成"Message Box"

注:5.3.2+
$.Tipmsg.w里,形如"*6-16"的提示文字,里面的數字是會被替換的。如綁定datatype="*2-18",那它默認的出錯信息就會是"請填寫2到18位任意字符!",可以通過$.Tipmsg.w或Validform對象的tipmsg屬性修改和擴展默認錯誤信息,如果你已經設置了"zh2-4"的提示信息是"2-4位中文",那么"zh2-8"出錯的信息就自動會是:"2-8位中文"。對於自定義的datatype,在擴展默認信息時,注意錯誤信息的名字要跟datatype名字一樣,如上面示例是:$.Tipmsg.w["zh2-4"]="2-4位中文"。對於多頁面或一個頁面多表單有相同datatype來說,在$.Tipmsg.w或Validform對象的tipmsg屬性中擴展默認提示信息是個很好的選擇。
5.3.1+
$.Tipmsg.s是用來指定在沒有綁定nullmsg時的默認提示信息。"{0}"是會被找到的label參數指定的對象或Validform_label里的文字替換掉的,"{填寫|選擇}"里的文字在綁定了"recheck"屬性的表單元素上檢測時是會不顯示的,當前驗證對象是radio、checkbox或select時,會輸出"選擇",是其他類型的元素時會輸出"填寫"和后面的"信息"。

具體示例請參見demo頁。

dataType【object】

獲取內置的一些正則:

{
    "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】

可以通過Validform對象的這個方法來給表單元素綁定驗證規則,綁定驗證類型中列出的附加屬性都可以通過這個方法綁定。

demo.addRule([
    {
        ele:"#name",
        datatype:"s6-18",
        ajaxurl:"valid.php",
        nullmsg:"請輸入昵稱!",
        errormsg:"昵稱至少6個字符,最多18個字符!"
    },
    {
        ele:"#userpassword",
        datatype:"*6-16",
        nullmsg:"請設置密碼!",
        errormsg:"密碼范圍在6~16位之間!"
    },
    {
        ele:"#userpassword2",
        datatype:"*",
        recheck:"userpassword",
        nullmsg:"請再輸入一次密碼!",
        errormsg:"您兩次輸入的賬號密碼不一致!"
    }
]);

其中ele是指定要綁定規則的對象,會在Validform對象下查找這些對象。

eq(n)【返回值:Validform】

獲取Validform對象的第n個元素。

如你頁面上有多個form的class都是formsub,執行上面的驗證綁定,得到的demo對象就可以操作所有這些表單,如果你要對其中某個表單執行某些操作,那么就可以使用這個方法。

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

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

以ajax方式提交表單。flag為true時,跳過驗證直接提交,sync為true時將以同步的方式進行ajax提交。

參數url是5.3版新增,傳入了url地址時,表單會提交到這個地址

如demo.ajaxPost(true),不做驗證直接ajax提交表單。

abort()【返回值:Validform】

終止ajax的提交。

如執行上面的ajaxPost()之后,發現某些項填寫不對,想取消表單提交,那么就可以執行這個操作:demo.abort()

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

以初始化時傳入參數的設置方式提交表單,flag為true時,跳過驗證直接提交。

參數url是5.3版新增,傳入了url地址時,表單會提交到這個地址

如demo.submitForm(true),不做驗證直接提交表單。

resetForm()【返回值:Validform】

重置表單。

如demo.resetForm(),重置表單到初始狀態。

resetStatus()【返回值:Validform】

重置表單的提交狀態。傳入了postonce參數的話,表單成功提交后狀態會設置為"posted",重置提交狀態可以讓表單繼續可以提交。

如demo.resetStatus()

getStatus()【返回值:String】

獲取表單的提交狀態,normal:未提交,posting:正在提交,posted:已成功提交過。

如demo.getStatus()

setStatus(status)【返回值:Validform】

設置表單的提交狀態,可以設置normal,posting,posted三種狀態,不傳參則設置狀態為posting,這個狀態表單可以驗證,但不能提交。

如demo.setStatus("posted")

ignore(selector)【返回值:Validform】

忽略對所選擇對象的驗證,不傳入selector則忽略所有表單元素。

如demo.ignore("select,textarea,#name"),忽略Validform對象下所有select,textarea及一個id為"name"元素的驗證。

unignore(selector)【返回值:Validform】

將ignore方法所忽略驗證的對象重新獲取驗證效果,不傳入selector則恢復驗證所有表單元素。

如demo.unignore("select,textarea,#name"),恢復Validform對象下所有select,textarea及一個id為"name"元素的驗證。

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

bool為true時則只驗證不顯示提示信息

對指定對象進行驗證(默認驗證當前整個表單),通過返回true,否則返回false(綁定實時驗證的對象,格式符合要求時返回true,而不會等ajax的返回結果)

如demo.check(),驗證當前整個表單,且只驗證但不顯示對錯信息。

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

setup參數是一個對象。

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

可用參數:
tiptype等 5.3.2+:可以在這里設置初始化可用的所有參數
url:指定表單的提交路徑,這里指定的路徑會覆蓋表單action屬性所指定的路徑 ajaxpost:表單以ajax提交時,可以在這里配置ajax的參數 ajaxurl:配置實時驗證ajax的參數 ①、config方法還能為已經初始化過的表單重新配置參數了!5.3.2+ 如var demo=$(".formsub").Validform(); demo.config({tiptype:2}); demo下的各表單還能分別配置不同參數! 如demo.eq(0).config({tiptype:1,ajaxPost:true}); demo.eq(1).config({tiptype:1,callback:function(curform){my_method_to_submit_form(); return false;}}); ②、執行config可以動態設置、添加參數,如: demo.config({ url:"http://validform.rjboy.cn" }); $(".save").click(function(){ demo.config({ ajaxpost:{ timeout:1000 } }); }); 那么在點擊save按鈕后,demo所對應的表單的config={ url:"http://validform.rjboy.cn", ajaxpost:{ timeout:1000 } } ③、參數url的優先級:form表單的action所指定的提交地址會被config.url覆蓋, config.url會被config.ajaxpost.url覆蓋,config.ajaxpost.url會被Validform對象的方法submitForm(flag,url) 和ajaxPost(flag,sync,url)里的url覆蓋。 如果表單里沒有指定action提交地址,那么就會提交到config.url設定的地址。 考慮到整個驗證框架的邏輯,傳入dataType參數不會起作用,不會被覆蓋,ajax必須返回含有status值的json數據。 ④、另外注意的是:傳入的success和error方法里,能多獲取到一個參數,如: demo.config={ ajaxpost:{ url:"", timeout:1000, ..., success:function(data,obj){ //data是返回的json數據; //obj是當前表單的jquery對象; }, error:function(data,obj){ //data是{ status:**, statusText:**, readyState:**, responseText:** }; //obj是當前表單的jquery對象; } }, ajaxurl:{ success:function(data,obj){ //data是返回的json數據; //obj是當前正做實時驗證表單元素的jquery對象; //注意:5.3版中,實時驗證的返回數據須是含有status值的json數據! //跟callback里的ajax返回數據格式統一,建議不再返回字符串"y"或"n"。目前這兩種格式的數據都兼容。 } } } 
調用外部插件

文件上傳 - swfupload

密碼強度檢測 - passwordStrength

日期控件 - datePicker

表單美化 - jqtransform

Validform的公用對象

$.Datatype

可以通過$.Datatype對象來擴展datatype類型。

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

$.Tipmsg

可以通過$.Tipmsg對象來修改默認提示文字。具體可修改的提示文字請查看Validform對象的tipmsg屬性。

如果Validform對象的tipmsg屬性沒有找到相關的提示信息,那么就會到$.Tipmsg中查找對應提示文字。

如$.Tipmsg.tit="msg box"; //設置默認彈出框的標題文字。

$.Showmsg(msg)

調用Validform自定義的彈出框。

參數msg是要顯示的提示文字。

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

$.Hidemsg()

關閉Validform自定義的彈出框。

如$.Hidemsg()


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM