基于Ext Core的包含校验功能的表单提交扩展Ext.ux.submit

近期因为工作需要，需要使用 Ext Core ，但是目前 Core 的扩展太少了，尤其是基于表单验证及提交的，基本没有，如果使用 Ext 本身的功能，那么库大小又增加不少。在研究了 Ext.form.Field 的代码和 vtype 代码后，决定自己写一个集成验证功能的表单提交扩展。

扩展的源代码如下：

Ext.namespace('Ext.ux');

Ext.ux.submit = function(){

var alpha = /^[a-zA-Z_]+$/;

var alphanum = /^[a-zA-Z0-9_]+$/;

var email = /^(/w+)([-+.][/w]+)*@(/w[-/w]*/.){1,5}([A-Za-z]){2,4}$/;

var url = /(((https?)|(ftp)):////([/-/w]+/.)+/w{2,3}(//[%/-/w]+(/./w{2,})?)*(([/w/-/./?////+@&#;`~=%!]*)(/./w{2,})?)*//?)/i;

return {

emptyText : null,

vtype:{

'email' : function(v){

return email.test(v);

},

'emailText' : ' 请输入正确的电子邮件地址，格式如： user@example.com',

'emailMask' : /[a-z0-9_/./-@]/i,

'url' : function(v){

return url.test(v);

},

'urlText' : ' 请输入正确的 URL 地址，格式如： http:/'+'/www.example.com"',

'alpha' : function(v){

return alpha.test(v);

},

'alphaText' : ' 该输入项只能包含字符和 _',

'alphaMask' : /[a-z_]/i,

'alphanum' : function(v){

return alphanum.test(v);

},

'alphanumText' : ' 该输入项只能包含字符 , 数字和 _',

'alphanumMask' : /[a-z0-9_]/i

},

run:function(opt){

if(opt.id){

var valid=true;

if(Ext.isArray(opt.valid)){

for(var i=0;i<opt.valid.length;i++){

validvalid= valid & this.validateValue(opt.valid[i]);

}

}

if(valid){

var params={};

var els=Ext.fly(opt.id).select("input",true).each(function(el){

if(el.dom.id){

params[el.dom.id]=el.dom.value;

}

})

Ext.Ajax.request({

url:opt.url,

success:function(response,opts){

var o = Ext.decode(response.responseText);

if(o){

if(o.error.length>0){

for(var i=0;i<o.error.length;i++){

var msgid='msg_'+o.error[i].id;

console.log(msgid);

Ext.fly(msgid).dom.innerHTML=o.error[i].msg;

Ext.fly(msgid).setDisplayed("block");

}

}

if(o.msg) alert(o.msg);

}

},

failure:function(response,opts){

alert(response.responseText);

},

params:params

});

}

}

},

validateValue : function(o){

var el=Ext.getDom(o.id);

if(el){

var value=el.value.trim();

var msgel=Ext.get('msg_'+o.id);

msgel.setDisplayed("none");

if(!o.allowBlank){

if(Ext.isEmpty(value)){

msgel.dom.innerHTML=" 请输入 "+o.title+" ！ <br/>";

msgel.setDisplayed("block");

return false;

}

}

if(o.minLength){

if(value.length < o.minLength){

msgel.dom.innerHTML = " 请输入正确的 "+o.title+" ！ ";

msgel.setDisplayed("block");

return false;

}

}

if(o.maxLength){

if(value.length > o.maxLength){

msgel.dom.innerHTML = " 请输入正确的 "+o.title+" ！ ";

msgel.setDisplayed("block");

return false;

}

}

if(o.vtype){

if(!this.vtype[o.vtype](value, this)){

msgel.dom.innerHTML =  this.vtype[o.vtype +'Text'];

msgel.setDisplayed("block");

return false;

}

}

return true;

}

},

};

}();

要使用该扩展，有以下规则必须遵守：

1、input 元件和 form 元件必须设置 id 属性
2、显示错误信息的元件的 id 必须已“ msg_ ”开头，后面跟 input 的 id ，譬如以下代码

<div class="item"><label> 用户名称： </label><div class="element"><input type="text" id="username" value=""/><span id="msg_username" class="error"></span></div></div>

代码中 input 的 id 为“ username ”，则错误信息的元件 id 必须为“ msg_username ”。

3、run 方法的参数必须是 JSON 格式，且必须包含 id 、 url 两个属性。 Id 属性表示 form 的 id 。 url 属性表示要提交的服务端地址。如果包含校验信息，需要将校验信息以数组形式，且属性为 vaild ，譬如以下代码。

Ext.ux.submit.run({

id:"form1",

url:"test.asp?act=1",

valid:[

{id:'username',title:' 用户 '},

{id:'email',title:' 电子邮件 ',vtype:'email'},

{id:'age',title:' 年龄 ',maxLength:2,minLength:1},

{id:'url',title:' 个人主页 ',vtype:'url'}

]

});

})

4、目前支持的校验方式如下：

是否允许空白：设置 allowBlank 属性为 true 表示允许空白

字符长度范围：属性 minLength 表示最短长度， maxLength 表示最大长度

电子邮件：设置 vtype 属性为“ email ”

网址：设置 vtype 属性为“ url ”

纯字母：设置 vtype 属性为“ alpha ”

字母 + 数字：设置 vtype 属性为“ alphanum ”

5、服务器端验证错误信息须设置在 error 属性里，而且须以数组形式设置。譬如以下代码。

response.write "{error:[{id:'username',msg:' 请输入正确的用户名 '}],msg:''}"

JSON 结构中的 id 属性为 input 元件的 id 属性， msg 属性表示要显示的信息。

6、目前这个扩展的服务器端信息显示是使用 alert 方法，如果需要使用其它形式，请自行修改扩展代码。
具体的使用方法请下载例子代码研究，再次我就不多说了。如果大家发现例子中有什么 bug ，或者有什么好的建议和意见，请留言或发邮件给我，多谢！希望这个扩展对大家有帮助。
本文的例子下载地址：http://download.csdn.net/source/1633051