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)

本文转自博客园农民伯伯的博客,原文链接:ExtJs 备忘录(3)—— Form表单(三) [ 数据验证 ],如需转载请自行联系原博主。

目录
相关文章
|
前端开发
61EasyUI 表单 - 创建异步提交表单
61EasyUI 表单 - 创建异步提交表单
41 0
|
小程序 API
form表单组件
form表单组件
170 0
|
小程序 数据安全/隐私保护
小程序封装form表单
本文主要介绍了如何封装一个表单组件,在封装表单组件时,我们需要定义组件属性和方法、组件模板和组件样式,以确保组件能够在页面中正常使用。通过本文的介绍,希望能够更好地帮助大家理解表单组件的封装方式,并在实际项目中应用。
209 0
|
SQL 前端开发 数据库
Yii2.0的模型表单、活动表单和AJAX表单是干什么的?底层原理是什么?
Yii2.0的模型表单、活动表单和AJAX表单是干什么的?底层原理是什么?
113 0
|
JavaScript 前端开发 PHP
jquery $.post 序列化表单ajax提交
jquery $.post 序列化表单ajax提交
111 0