本文分享一個通用的 JavaScript 表單驗證插件。使用方式只有兩步:第一步,在表單元素上加 dataType 屬性宣告資料型別與範圍;第二步,實例化驗證器 new ValidatorForm(表單物件)。插件內建常見錯誤提示文字,若要自訂,加上 msg 屬性即可。
運行效果截圖如下:

線上展示:https://demo.jb51.net/js/2015/js-normal-table-check-plug-codes/
基礎驗證:email(Email 位址)、tel(電話,支援手機/市話,能識別區號與全半形逗號分隔的多筆號碼)、mobile(手機號碼)、url(網址)、number(數字)、english(英文字母)、chinese(全形字元)、username(帳號,字母開頭的 4-20 位字母數字底線組合)、password(密碼,4-20 位字母數字或 @!#$%^&*.~ 組合)、date(日期)、length(長度,格式 length[最小,最大])。
均可搭配中括號使用:長度驗證 chinese[1,10] 限制 1-10 個全形字元(注意一個全形字元長度計為 2);數字範圍 number[18,26] 限制輸入 18-26;日期範圍 date[1970-1-1,2012-12-12] 限制區間。
上限與下限設定:chinese[1,] 表示至少 1 個有效字元;chinese[,6] 表示最多 6 個。number 與 date 的寫法同理。
其它驗證:
Compare 用於值比對,格式為 Compare[比較符比較對象,比較類型]。比較符包含 >、>=、<、<=、!=、=;比較對象是表單項的 name(若有多個同名項目則取第一個);比較類型可選 text、number、date,留空時會自動識別當前項的值格式。例如 Compare[=password]。
exec 用於自訂函式,格式為 exec[函式名]。它會傳入目前的輸入框物件,並期望回傳一個 JSON 物件:{stat: 結果[true/false], msg: 提示文字, msgCss: 樣式[className], inCss: 輸入框樣式[className]}。其中 stat 為必填,其餘留空則使用預設設定。
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="https://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <title>表單驗證插件示例</title> <style> body,td{font:12px Verdana;color:#333} input,textarea,select,td,th{font:12px Verdana;color:#333;border:1px solid #999;background:#fff} table{border-collapse:collapse;} th{font:bold 12px Verdana; text-align:right;padding:5px;} td{padding:3px;line-height:1.8;} input{height:20;} textarea{width:80%;height:50px;overflow:auto;} form{display:inline} /*輸入框樣式*/ input[type=text],input[type=password],textarea{border:1px solid #ccc;padding:2px;border-radius:1px;box-shadow:0 1px 2px rgba(0,0,0,0.1) inset;outline:medium none;line-height:25px; -webkit-transition:all 0.15s ease-in 0s; -moz-transition:all 0.15s ease-in 0s; -o-transition:all 0.15s ease-in 0s; font-family:"Microsoft YaHei",Verdana,Arial; font-size:14px; vertical-align:top; } input[type=text],input[type=password]{height:25px;} input[type=text]:focus,input[type=password]:focus,textarea:focus{border-color:#52a8ec;box-shadow:0 1px 2px rgba(0,0,0,0.1) inset,0 0 5px rgba(82,168,236,0.6);outline:0 none;} </style> </head> <body> <form name="theForm" id="theForm" action="" method="get"> <table align="center" width="100%"> <tr> <td>真實姓名:</td><td><input type="text" name="Name" dataType="chinese[1,]" /><span msgbox="1">請輸入真實姓名</span> <span id="vfMsgBox_Name"></span> </td> </tr> <tr> <td>英文名:</td><td><input type="text" name="Nick" dataType="english[1,10]" /></td> </tr> <tr> <td>主頁:</td><td><input type="text" name="Homepage" dataType="url" /></td> </tr> <tr> <td>密碼:</td><td><input name="password" type="text" dataType="password" /></td> </tr> <tr> <td>重復:</td><td><input name="password2" type="text" dataType="Compare[=password'密碼]" /></td> </tr> <tr> <td>信箱:</td><td><input type="text" name="email" dataType="email[1,]" /></td> </tr> <tr> <td>郵編:</td><td><input type="text" name="QQ" dataType="number[100000,999999]" /></td> </tr> <tr> <td>年齡:</td><td><input type="text" name="Year" dataType="number[18,28]" /></td> </tr> <tr> <td>電話:</td><td><input type="text" name="Phone" dataType="tel" /></td> </tr> <tr> <td>手機:</td><td><input type="text" name="mobile" dataType="mobile" /></td> </tr> <tr> <td>自我介紹:</td><td><textarea name="Description" dataType="length[0,150] exec[testFunction]"></textarea> <span>自定義驗證,長度大於50觸發自定義錯誤及樣式,大於150由系統提示</span> </td> </tr> <tr> <td colspan="2"><input name="Submit" type="submit" value="確定提交"></td> </tr> </table> </form> <style type="text/css"> /*輸入項樣式*/ input.vf_inCorrect,textarea.vf_inCorrect{box-shadow:0 1px 2px rgba(3,139,0,0.2) inset;border-color:#90b983;color:#2d7c14;} input.vf_inError,textarea.vf_inError{box-shadow:0 1px 2px rgba(139,23,0,0.2) inset,0 0 5px rgba(139,23,0,0.6);border-color:#d46060;color:#b40000;} .vf_Normal,.vf_Correct,.vf_Error,.vf_Focus{vertical-align:middle;display:inline-block;padding:3px;font-size:12px;margin-left:5px; background:#eee;} .vf_Normal{color:#777;} .vf_Focus{color:#000;} .vf_Correct{color:#20800d;display:none;} .vf_Error{color:#f00;} /*自定義樣式*/ input.inTestClass,textarea.inTestClass{box-shadow:0 0 2px rgba(0,0,0,0.3) inset,0 0 5px rgba(139,23,0,0.6);border-color:#00f;color:#eee;background-color:#333;} .TestClass_OK{color:#fff;background-color:#080;} .TestClass_Err{color:#fff;background-color:#c00;} </style> <script type="text/javascript"> //添加事件 function addEvent(o,e,f){ if(window.attachEvent){o.attachEvent("on"+e,f)}else if(window.addEventListener){o.addEventListener(e,f,false);}else{o["on"+e]=f;} } //取消事件 function removeEvent(o,e,f){ if(window.detachEvent){o.detachEvent("on"+e,f);}else if(window.removeEventListener){o.removeEventListener(e,f,false);}else{o["on"+e]=null;} } // class是否存在 function hasClass(obj,sClass){var reg = new RegExp("(^|\\s)" + sClass + "(\\s|$)");return reg.test(obj.className)} //阻止浏覽器的默認行為 function stopDefault(e){if(e&&e.preventDefault){e.preventDefault();}else{window.event.returnValue=false;}return false;} //阻斷事件冒泡 function stopBubble(e){if(e&&e.stopPropagation){e.stopPropagation();}else{window.event.cancelBubble=true;}} function GetID(s){return document.getElementById(s);} //創建元素 function creElm(o,pN,t){ var tmp=document.createElement(t||'div'),p; for(p in o){tmp[p]=o[p];} return pN?pN.appendChild(tmp):document.body.appendChild(tmp); } //計算字符串長度[全角算2長度] function strLength(str){return str.replace(/[^\x00-\xff]/g,"**").length;} function SetCss(o,k,s){ var c=o.className.split(' '),n=0,nCSS=''; for(var i=0;i<c.length;i++) { if(c[i]!=k){nCSS+=(nCSS=='')?c[i]:' '+c[i];} else{n=1;} } if(s=='add'){nCSS+=(nCSS=='')?k:' '+k;} o.className=nCSS; } //自定義驗證函數 function testFunction(o){ var val=o.value,len=Math.floor(strLength(val)); return {stat:len<50,msg:'已輸入<strong>'+len+'</strong>個字符;',msgCss:(len<50?'TestClass_OK':'TestClass_Err'),inCss:null}; } function ValidatorForm(f,Stat,Validator){ var vf=this; //正則,最小值,最大值,提示消息 this.Validator={ email:[/^(\w+([-+.]\w+)*@\w+([-.]\w+)*\.\w+([-.]\w+)*)?$/,0,0,'Email地址填寫錯誤'], tel:[/^((0?1[358]\d{9})[,,]?|((0(10|2[0-9]{1}|[3-9]{1}\d{2})[-_-—]?)?\d{7,8})[,,]?)*$/,0,0,'電話號碼填寫錯誤'], mobile:[/^(0?1[358]\d{9})*$/,0,12,'手機號碼填寫錯誤'], url:[/^(http:\/\/[A-Za-z0-9]+\.[A-Za-z0-9]+[\/=\?%\-&_~`@[\]\':+!]*([^<>\"\"])*)?$/,0,0,'網址填寫錯誤'], number:[/^\d*$/,0,0,'只能填寫數字格式'], english:[/^[A-Za-z]*$/,0,0,'只能輸入半角英文字母'], chinese:[/^[\u0391-\uFFE5]*$/,0,0,'只能輸入全角中文'], username:[/^[a-zA-Z]{1}\w*$/,4,20,'帳號需由字母開頭的4-20位字母、數字或下劃線組成'], password:[/^[\@A-Za-z0-9\!\#\$\%\^\&\*\.\~]*$/,4,20,'密碼長度4-20,請勿輸入特殊字符'], date:[/^((\d{4})[\-|\.|\/](\d{1,2})[\-|\.|\/](\d{1,2}))?$/,'','','請填寫如2012-1-1格式日期!'], Compare:[/^[\s\S]*$/,0,0,''], length:[/^[\s\S]*$/,0,0,''], exec:[/^[a-zA-Z]{1}\w*$/,0,0,''] } //消息Box樣式及框入框樣式 this.Stat={ tag:'span', msgNormal:'vf_Normal', msgCorrect:'vf_Correct', msgError:'vf_Error', msgFocus:'vf_Focus', inCorrect:'vf_inCorrect', inError:'vf_inError', inFocus:'vf_inFocus' } if(Validator){for(var i in this.Validator){this.Validator[i]=Validator[i]!==undefined?Validator[i]:this.Validator[i];}} if(Stat){for(var i in this.Stat){this.Stat[i]=Stat[i]!==undefined?Stat[i]:this.Stat[i];}} this.Form=f; var fn=f.elements.length,i,j,_dataType; for(i=0;i<fn;i++){ _dataType=f.elements[i].getAttribute('dataType'); _dataType=_dataType?_dataType.split(' '):[]; for(j=0;j<_dataType.length;j++) { if(this.Validator[_dataType[j].split('[')[0]]){ f.elements[i].onblur=(function(o){return function(){vf.CheckData(o);}})(f.elements[i]); if(f.elements[i].tagName.toUpperCase()=='TEXTAREA'){ f.elements[i].onkeyup=(function(o){ return function(){ var MsgTag=vf.GetMsgBox(o); MsgTag.innerHTML='已輸入<strong>'+Math.floor(strLength(o.value))+'</strong>個字符;'; } })(f.elements[i]); } } } } //提交表單 this.submit=function(e){ var fn=vf.Form.elements.length,i,j,_Err=0,_Focus,_Msg='',t,_dataType; for(i=0;i<fn;i++){ _dataType=f.elements[i].getAttribute('dataType'); _dataType=_dataType?_dataType.split(' '):[]; for(j=0;j<_dataType.length;j++) { if(vf.Validator[_dataType[j].split('[')[0]]){ t=vf.CheckData(f.elements[i]); if(t&&t[0]==false){ _Err++; if(!_Focus){_Focus=f.elements[i];} _Msg+='\n'+f.elements[i].name+' '+t[1]; break; } } } } if(_Err>0){ e&&stopDefault(e); alert('共有'+_Err+'項填寫錯誤!'); _Focus.focus(); } } addEvent(f,'submit',vf.submit); } ValidatorForm.prototype={ //驗證內容是否正確 CheckData:function(o){ var _dataType=o.getAttribute('dataType'),i,s=true,_Msg='',_msgCss,_inCss,_mdt,min,max,_dt; _dataType=_dataType?_dataType.split(' '):[]; for(i=0;s&&i<_dataType.length;i++){ if(this.Validator[_dataType[i].split('[')[0]]){ _dt=_dataType[i].split('[')[0]; //自定義驗證函數 if(_dt=='exec'){ _mdt=_dataType[i].match(/^exec\[([a-zA-Z]{1}\w*)\]$/); if(_mdt==null){return false;} try { if(typeof(eval(_mdt[1]))=="function") { var _exec=eval(_mdt[1])(o); s=s&&_exec.stat; var MsgTag=this.GetMsgBox(o); _Msg=_exec.msg||''; if(_exec.msgCss){_msgCss=_exec.msgCss;} } } catch(e) { alert('not function'); return false; } } //值對比 else if(_dt=='Compare'){ _mdt=_dataType[i].match(/^Compare\[(=|!=|>|>=|<|<=)([^,]+),?(number|text|date)?\]$/); if(_mdt==null){return false;} _mdt[2]=(_mdt[2]+'\'').split('\''); if(_mdt[2][1]==''){_mdt[2][1]=_mdt[2][0];} if(!this.Form[_mdt[2][0]]||this.Form[_mdt[2][0]].value==''){return false;} var v2=this.Form[_mdt[2][0]].length>1?this.Form[_mdt[2][0]][0].value:this.Form[_mdt[2][0]].value; s=s&&this.Check_Compare(o.value,_mdt[1],v2,_mdt[3]); var cc; switch (_mdt[1]){ case ">": cc='大於';break; case ">=": cc='大於或等於';break; case "<": cc='小於';break; case "<=": cc='小於或等於';break; case "!=": cc='不一至';break; default: cc='一至'; } if(!s){_Msg=(_mdt[1]=='='||_mdt[1]=='!=')?'必須和'+_mdt[2][1]+cc:'必須'+cc+_mdt[2][1];} } //日期格式驗證 else if(_dt=='date'){ _mdt=_dataType[i].match(/^date\[(\d{4}[\-|\.|\/]\d{1,2}[\-|\.|\/]\d{1,2})?,(\d{4}[\-|\.|\/]\d{1,2}[\-|\.|\/]\d{1,2})?\]$/); if(_mdt==null){s=s&&this.Validator[_dt][0].test(o.value);} else{ min=_mdt?_mdt[1]:this.Validator[_dt][1]; max=_mdt?_mdt[2]:this.Validator[_dt][2]; s=s&&this.Validator[_dt][0].test(o.value)&&this.Check_Date(o.value,min,max); } } //其它類型驗證 else{ _mdt=_dataType[i].match(/^([^[]+)\[(\d*),(\d*)\]$/); min=_mdt?_mdt[2]:this.Validator[_dt][1]; max=_mdt?_mdt[3]:this.Validator[_dt][2]; s=s&&this.Validator[_dt][0].test(o.value); if(s){s=s&&this.Check_Num((_dt=='number'?o.value-0:strLength(o.value)),min,max);} else{_Msg=this.Validator[_dt][3];} } //生成提示文本 if(_Msg==''&&!s) { if(min||max){ if(_dt=='number'){ _Msg=min&&max?'只能輸入'+min+'-'+max+'范圍數字':min?'只能輸入大於'+min+'數字':'只能輸入小於'+max+'數字'; } else if(_dt=='date'){ _Msg=min&&max?'只能輸入'+min+'至'+max+'范圍日期':min?'只能輸入大於'+min+'日期':'只能輸入小於'+max+'日期'; } else{ _Msg=min&&max?'需輸入'+min+'-'+max+'個有效字符':min?'至少需輸入'+min+'個有效字符':'最多只能輸入'+max+'個有效字符'; } }else{_Msg=this.Validator[_dt][3];} } } } if(s){this.AddCorrect(o,{msg:_Msg,msgCss:_msgCss,inCss:_inCss});}else{this.AddError(o,{msg:_Msg,msgCss:_msgCss,inCss:_inCss});} return [s,_Msg]; }, //驗證正確 AddCorrect:function(o,s){ var MsgTag=this.GetMsgBox(o); MsgTag.innerHTML=s.msg||''; this.vfSetCss(MsgTag,s.msgCss||this.Stat.msgCorrect,1); this.vfSetCss(o,s.inCss||this.Stat.inCorrect,0); }, //驗證錯誤 AddError:function(o,s){ var MsgTag=this.GetMsgBox(o); MsgTag.innerHTML=o.getAttribute('msg')||s.msg; this.vfSetCss(MsgTag,s.msgCss||this.Stat.msgError,1); this.vfSetCss(o,s.inCss||this.Stat.inError,0); }, //獲取/創建提示Box GetMsgBox:function(o){ var MsgTag=GetID('vfMsgBox_'+o.name); if(!MsgTag){ MsgTag=o.nextSibling; while(MsgTag&&MsgTag.nodeType!=1){MsgTag=MsgTag.nextSibling;} if(!MsgTag||MsgTag.tagName.toUpperCase()!=this.Stat.tag.toUpperCase()||!MsgTag.getAttribute('msgbox')){ MsgTag=creElm({},o.parentNode,this.Stat.tag); MsgTag.setAttribute('msgbox','1'); if(o.nextSibling.nextSibling){o.parentNode.insertBefore(MsgTag,o.nextSibling);} } } return MsgTag; }, //驗證值范圍 Check_Num:function(v,min,max){ v=v||0; if(min&&max){return v>=min-0&&v<=max-0;} else if(min){return v>=min-0;} else if(max){return v<=max-0;} return true; }, //值對比 Check_Compare:function(v,operator,v2,DataType){ if(!DataType){ if(this.Validator.number[0].test(v)){DataType='number';} else if(this.Validator.date[0].test(v)){DataType='date';} else{DataType='text'} } if(DataType=='number'){v-=0;v2-=0;} else if(DataType=='date'){ var _mdt=v.match(this.Validator.date[0]); if(_mdt==null){return false;} v=new Date(_mdt[2],_mdt[3]-1,_mdt[4])-new Date; _mdt=v2.match(this.Validator.date[0]); if(_mdt==null){return false;} v2=new Date(_mdt[2],_mdt[3]-1,_mdt[4])-new Date; } switch (operator){ case ">": return v>v2;break; case ">=": return v>=v2;break; case "<": return v<v2;break; case "<=": return v<=v2;break; case "!=": return v!=v2;break; default: return v==v2; } }, //日期驗證范圍 Check_Date:function(v,min,max){ var _mdt=v.match(this.Validator.date[0]); if(_mdt==null){return false;} v=new Date(_mdt[2],_mdt[3]-1,_mdt[4])-new Date; _mdt=min.match(this.Validator.date[0]); min=_mdt==null?null:new Date(_mdt[2],_mdt[3]-1,_mdt[4])-new Date; _mdt=max.match(this.Validator.date[0]); max=_mdt==null?null:new Date(_mdt[2],_mdt[3]-1,_mdt[4])-new Date; return this.Check_Num(v,min,max); }, //設置樣式 vfSetCss:function(o,css,s){ if(!s){ SetCss(o,this.Stat.inCorrect,'del'); SetCss(o,this.Stat.inError,'del'); SetCss(o,this.Stat.inFocus,'del'); } if(s){o.className=css;}else{SetCss(o,css,'add');} } } new ValidatorForm(GetID('theForm')); </script>
以屬性當設定檔。整個插件的可擴充性來自 dataType 屬性。 конструкtor 遍歷 f.elements,讀出每個欄位的 dataType,用空白切成陣列,再逐一比對 this.Validator 這個「規則表」——命中的就掛上 onblur 驗證。要新增型別,只要在 Validator 物件裡加一筆正規表達式、最小值、最大值與提示文字,不必動主流程。
支援多重規則。因為 dataType 是用空白分隔的多值屬性,一個欄位可以同時宣告多條規則(例如 dataType="email Compare[=email'信箱]"),CheckData 裡的迴圈會逐條檢查,全部通過才算正確。
全形長度計算。strLength() 用 str.replace(/[^\x00-\xff]/g,"**").length 把非 ASCII 字元換成兩個字元再取長度,如此一來一個中文就算 2 長度,與資料庫或後端常見的字元計數方式對齊。
提示框自動生成。GetMsgBox() 先找 id 為 vfMsgBox_欄位名 的元素,找不到就在輸入框後面動態插入一個 <span>,並標記 msgbox="1"。呼叫端不必為每個欄位手寫提示容器。
樣式與邏輯分離。驗證結果透過 className 呈現:正確加 vf_inCorrect、錯誤加 vf_inError,提示文字則套用 vf_Correct/vf_Error。介面要改配色或版型,只動 CSS 就好。
IIFE 保住事件處理器。綁定 onblur 時用了 (function(o){return function(){...}})(f.elements[i]) 這個閉包寫法,避免迴圈變數被後續迭代覆蓋——這是早期 JavaScript 事件綁定的經典陷阱,示範得很到位。
eval 的使用。exec 型別靠 eval(_mdt[1]) 把字串還原成函式再呼叫。在受控的專案內部這樣做尚可,但若 dataType 的值有可能來自外部輸入,就等於開了一個程式碼注入的入口。建議改用查表(window[funcName] 或直接維護一個函式對應物件)。
正規表達式的字符類問題。例如 [\-|\.|\/] 中的 | 在字符類裡是普通字元而非「或」,因此實際上會連 | 本身都當成合法分隔符。寫成 [\-.\/] 即可。
手機號段已過時。mobile 與 tel 的正則列舉了 2015 年前後的號段,之後新增的號段會被誤判為錯誤。這類規則建議放在伺服器端集中維護,或至少定期更新。
只在 blur 與 submit 驗證。使用者輸入過程中沒有回饋。若加上 input 事件做即時提示,體驗會更好。
希望本文所述對大家的 JavaScript 程式設計有所幫助。