ExtJs 备忘录(3)—— Form表单(三) [ 数据验证 ]

简介:


正文
一、资料
1.1.  表单提示的方式设置,如:
 

Ext.form.Field.prototype.msgTarget = ' side '

      该设置为枚举值:'qtip','side','title','under'
qtip:把鼠标移动到控件就可以显示提示信息了,有点像设置了title的input标签一样的效果。
side:该方式用的比较多,控件右边会出现红底白色小圆感叹号图标。
title:和qtip一样,但是没有边框效果,就和普通设置了title的input标签一样。
under:会在控件的正下方挤出一行来显示一个黄底黑色方形感叹号和错误信息文字。
这里不设置就是默认的qtip效果 ,注意这里ext的版本是3.0正式版。
注意单独的控件也有此属性设置msgTarget。
1.2.  验证方式
1.2.1  内置
1.2.1.1  默认
maxLength、minLength、allowBlank(非空)、regex(正则表达式)
1.2.1.2  自定义
validator,具体用法可以看代码部分,接受一个函数为参数。
1.2.2  vtype
1.2.2.1  默认
alpha     只能输入数字
alphanum   只能输入字母和数字
email      emali验证
url      url验证
1.2.2.2  自定义
大家可以参考 ExtJS中表单验证使用自定义vtype示例

二、代码
这里借用博客园注册界面来实现同样的验证功能(可能验证效果不一样)。
2.1  截图


2.2  validatoradd.aspx
 

<% @ Page Language = " C# "  AutoEventWireup = " true "  CodeFile = " validatoradd.aspx.cs "  Inherits = " validatoradd "   %>

<! DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" >

< html  xmlns ="http://www.w3.org/1999/xhtml" >
< head  runat ="server" >
    
< title ></ title >
</ head >
< body >
    
< form  id ="form1"  runat ="server" >
< script  type ="text/javascript" >
    Ext.onReady(
function () {
    
        Ext.QuickTips.init();
        Ext.form.Field.prototype.msgTarget 
=   ' side ' ;
        

        
var  form1  =   new  Ext.FormPanel({
            layout: 
' form ' ,
            collapsible: 
true ,
            autoHeight: 
true ,
            frame: 
true ,
            renderTo: Ext.getBody(),
            title: 
' <center style="curor:hand" onclick="window.location.reload();">模拟博客园注册</center> ' ,
            style: 
' margin-left:auto;margin-right:auto;width:500px;margin-top:8px; ' ,
            
// 设置标签对齐方式
            labelAlign:  ' right ' ,
            
// 设置标签宽
            labelWidth:  170 ,
            
// 设置按钮的对齐方式
            buttonAlign: ' center ' ,
            
            
// [重要]默认元素属性设置
            defaults:{
                    width:
180
                    ,allowBlank:
false                 // 不允许为空
                    ,blankText: ' 该项不能为空! '    // 显示为空的错误信息
                },
            items: [
                
// 不能为空,字符数  >2 && <30
                 new  TextField( ' txt_userName ' , ' 登录用户名 ' , null , null ,[
                    [
' min ' , 2 , ' 用户名过短,至少需要2个字符 ' ],
                    [
' max ' , 30 ]
                ])
                
// 不能为空,字符数  >4 && <50
                , new  TextField( ' txt_pwd ' , ' 密   码 ' , null ,
                    [[
' inputtype ' , ' password ' ],
                    [
' id ' , ' txt_pwd1 ' ]],
                    [[
' min ' , 4 , ' 密码至少需要4位字符 ' ],
                    [
' max ' , 50 ]]
                ),
                
// 不能为空,字符数  >4 && <50
                 new  TextField( ' txt_confirm_pwd ' , ' 确 认 密 码 ' , null ,
                    [[
' inputtype ' , ' password ' ]],
                    [[
' min ' , 4 , ' 至少需要4位字符 ' ],
                    [
' max ' , 50 ],
                    [
' val ' , function (){
                        
// $这里注意了$,如果是返回true,表示验证成功了
                         // 返回字符串,表示验证失败,且错误信息为这个字符串
                         if ( this .getRawValue() != null ){
                            
var  txt_pwd  =  Ext.get( ' txt_pwd1 ' );
                            
if (txt_pwd.getValue()  !=   this .getRawValue())
                                
return   " 请再输入一遍密码,要求与上面的一致 " ;
                        }
                        
return   true ;
                    }]]
                ),
                
// 不能为空,字符数  >2 && <30
                 new  TextField( ' txt_display_name ' , ' 显 示 名 称 ' , null , null ,[
                    [
' min ' , 2 , ' 用户名过短,至少需要2个字符 ' ],
                    [
' max ' , 30 ]
                ]),
                
// 不能为空 :
                 new  TextField( ' txt_email ' , ' 邮   箱 ' , null , null ,[[ ' vt ' , ' email ' ]]),
                
new  RadioGroup( ' rbl_Gender ' , ' 性   别 ' ,[[ ' ' , ' 1 ' , true ],[ ' ' , ' 0 ' ]])
            ],
            buttons: [{
                text: 
" 保 存 "
                ,handler:
function (){
                    
// 验证所有表单元素
                     if (form1.form.isValid()){
                        MsgInfo(
" 开始表单提交! " );
                    }
                }
            }, {
                text: 
" 取 消 "
                ,handler:
function (){
                    
// 重置表单项
                    form1.form.reset();
                }
            }]
        });
    });
    
</ script >
    
</ form >
</ body >
</ html >

      代码说明:
a).  注意defaults属性,这个是非常有用的,常用于设置大部分(items里面的控件的属性)都有的属性,控件也可以通过自行设置来覆盖这个默认设置。
b).  经过一轮封装后代码仍然稍长,难免有为了封装而封装,这个时候大家可以自行斟酌是否使用封装控件还是直接使用Ext的表单控件。
c).  特别需要注意在提交的时候需要加上if(form1.form.isValid()),来进行全局验证,因为前面的控件如果你不去触发他(获得光标一次)他是不会去验证的!其他注意项可以参照文章稍后部分的注意。


2.3  easy-ext.js  修改部分,主要是对TextField进行扩充
 

// #region Ext.form.TextField
function  TextField(fName,fLabel,defaultValue,others,validators)
{
    
// / <summary>
     // / Ext.form.TextField封装
     // / </summary>
     // / <param name="fName">name</param>
     // / <param name="fLabel">fieldLabel</param>
     // / <param name="defaultValue">默认值</param>
     // / <param name="others">其他常用设置,格式如:[["width":100]]</param>
     // / <param name="validators">验证设置,格式如:[["maxLength":50],["maxLengthText":'太长']]</param>
     // / <returns>Ext.form.TextField</returns>
     var  text  =   new  Ext.form.TextField();
    
    
if (fName != null )
        text.name 
=  fName;
    
    
if (fLabel != null )
        text.fieldLabel 
=  fLabel;
    
    
// 设置默认值
     if (defaultValue  !=   null )
        text.setValue(defaultValue);
        
    
// 设置其他常用设置
     if (others != null )
    {
        
for ( var  i  =   0  ;i < others.length; i ++ )
        {
            
if (others[i].length  ==   2 )
            {
                
var  okey  =  others[i][ 0 ];
                
var  oValue  =  others[i][ 1 ];
                
switch (okey.toLowerCase())
                {
                    
case   " width " : // Number
                         if ( typeof (okey)  ==   " string "   &&   typeof (oValue)  ==   " number " )
                            text.setWidth(oValue);
                        
break ;
                    
case   " height " : // Number
                         if ( typeof (okey)  ==   " string "   &&   typeof (oValue)  ==   " number " )
                            text.setHeight(oValue);
                        
break ;
                    
case   " it " :
                    
case   " inputtype " : // radio, text, password, file (defaults to 'text')
                         if ( typeof (okey)  ==   " string "   &&   typeof (oValue)  ==   " string " )
                            text.inputType 
=  String(oValue);
                        
break ;
                    
case   " disabled " : // Boolean
                         if ( typeof (okey)  ==   " string "   &&   typeof (oValue)  ==   " boolean " )
                            text.disabled 
=  Boolean(oValue);
                        
break ;
                    
case   " ro " :
                    
case   " readonly " : // Boolean
                         if ( typeof (okey)  ==   " string "   &&   typeof (oValue)  ==   " boolean " )
                            text.readOnly 
=  Boolean(oValue);
                        
break ;
                    
case   " et " :
                    
case   " emptytext " : // String
                         if ( typeof (okey)  ==   " string "   &&   typeof (oValue)  ==   " string " )
                            text.emptyText 
=  String(oValue);
                        
break ;
                    
case   " id " :
                        
if ( typeof (okey)  ==   " string "   &&   typeof (oValue)  ==   " string " )
                            text.id 
=  oValue;
                        
break ;
                }
            }
        }
    }
    
    
// 设置验证条件
     if (validators != null )
    {
        
for ( var  i  =   0  ;i < validators.length; i ++ )
        {
            
if (validators[i].length  ==   3 )
            {
                
var  vkey  =  validators[i][ 0 ];
                
var  vValue  =  validators[i][ 1 ];
                
var  vText  =  validators[i][ 2 ];
                privateTextFieldValidatorSwitch(text,vkey,vValue);
                privateTextFieldValidatorSwitch(text,vkey
+ " em " ,vText);
            }
            
else   if (validators[i].length  ==   2 )
            {
                
var  vkey  =  validators[i][ 0 ];
                
var  vValue  =  validators[i][ 1 ];
                privateTextFieldValidatorSwitch(text,vkey,vValue);
            }
        }
    }
    
    
return  text;
}
// 辅助TextField验证用函数
function  privateTextFieldValidatorSwitch(text,vkey,vValue)
{
    
if (vkey != null )
    {
        
switch (vkey.toLowerCase())
        {
            
/* em:Error Message */
            
/* - 最大字符数验证 -  */
            
case   " max " :
            
case   " maxlength " : // Number
                 if ( typeof (vkey)  ==   " string "   &&   typeof (vValue)  ==   " number " )
                    text.maxLength 
=  Number(vValue);
                
break ;
            
case   " maxem " :
            
case   " maxlengthtext " : // String
                 if ( typeof (vkey)  ==   " string "   &&   typeof (vValue)  ==   " string " )
                    text.maxLengthText 
=  String(vValue);
                
break ;
            
/* - 最小字符数验证 -  */
            
case   " min " :
            
case   " minlength " : // Number
                 if ( typeof (vkey)  ==   " string "   &&   typeof (vValue)  ==   " number " )
                    text.minLength 
=  Number(vValue);
                
break ;
            
case   " minem " :
            
case   " minlengthtext " : // String
                 if ( typeof (vkey)  ==   " string "   &&   typeof (vValue)  ==   " string " )
                    text.minLengthText 
=  String(vValue);
                
break ;
            
/* - 正则表达式验证 -  */
            
case   " rx " :
            
case   " regex " :
                    text.regex 
=  vValue;
                
break ;
            
case   " rxem " :
            
case   " regexText " : // String
                 if ( typeof (vkey)  ==   " string "   &&   typeof (vValue)  ==   " string " )
                    text.regexText 
=  String(vValue);
                
break ;
            
/* - 非空验证 -  */
            
case   " ab " :
            
case   " allowblank " :
                
if ( typeof (vkey)  ==   " string "   &&   typeof (vValue)  ==   " boolean " )
                    text.allowBlank 
=  Boolean(vValue);
                
break ;
            
case   " abem " :
            
case   " blanktext " :
                
if ( typeof (vkey)  ==   " string "   &&   typeof (vValue)  ==   " string " )
                    text.blankText 
=  String(vValue);
                
break ;
            
/* - 函数验证 -  */
            
case   " val " :
            
case   " validator " : // Function
                 if ( typeof (vkey)  ==   " string "   &&   typeof (vValue)  ==   " function " )
                    text.validator 
=  vValue;
                
break ;
            
/* - 验证事件 默认是keyup -  */
            
case   " ve " :
            
case   " validationevent " :
                
if ( typeof (vkey)  ==   " string "   &&   typeof (vValue)  ==   " string " )
                    text.validationEvent 
=  String(vValue);
                
break ;
            
case   " vt " :
            
case   " vtype " :
                
if ( typeof (vkey)  ==   " string "   &&   typeof (vValue)  ==   " string " )
                    text.vtype 
=  String(vValue);
                
break ;
        }
    }
}

// #endregion

    代码说明:
这里再次强调一下,根据实际情况进行封装,满足大部分需求即可!这里扩充了其他常用参数的设置和数据验证的扩充,再这基础之上大家可以很方便的加入其它扩充条件。

三、注意
下面都是写例子或以前发觉的问题,收集如下:
1.  关于正则表达式验证,如果regex属性设置为带双(单)引号的字符串,将出现js错误!
错误写法:‘/^\d$/’   
正确写法:/^\d$/
2.  关于设置id后用Ext.getCmp取不到的问题,改成用Ext.get就可以取到了,取值用getValue。这里很是奇怪,直接设置id: xx1可以用getCmp去得到,通过设置属性后就取不到了!!?

四、下载
ExtJS2009-9-20(3)


结束语
写这系列的时候打算把表单就写一篇文章里面的,结果发觉太大,就拆成了两篇,然后拆成三篇,现在只能拆成四篇了,要讲的东西太多,想尽量详细一点,老实说也是边写边查资料收集,难免有误,大家谅解!



本文转自over140 51CTO博客,原文链接:http://blog.51cto.com/over140/586544,如需转载请自行联系原作者

相关文章
|
前端开发
61EasyUI 表单 - 创建异步提交表单
61EasyUI 表单 - 创建异步提交表单
45 0
|
SQL 前端开发 数据库
Yii2.0的模型表单、活动表单和AJAX表单是干什么的?底层原理是什么?
Yii2.0的模型表单、活动表单和AJAX表单是干什么的?底层原理是什么?
115 0
|
移动开发 前端开发 HTML5
前端表单部分新属性
前端表单部分新属性
99 0