Extjs form 组件

1.根类

Ext.form.Basic

提供了,表单组件,字段管理,数据验证,表单提交,数据加载的功能

2.表单的容器

Ext.form.Panel

容器自动关联 Ext.form.Basic 的实例对象更方便的进行字段的配置

重要属性

defaultType:"" 设置默认子项 的xtype

3.数据交互和加载

Ext.form.action.Action

Ext.form.action.Submit ajax方式提交

Ext.form.action.StandardSubmit 原始表单提交方法

Ext.form.action.DirectLoad

Ext.form.action.DirectSubmit 指令式的模式

4.字段的控制

Ext.form.field.Base 是跟类

混入了类 [Ext.form.field.Field]得到表单值的处理功能

混入了类[Ext.form.Labelable]得到表单标签错误信息提示的功能

Ext.form.field.Text   文本框方式的

Ext.form.field.Trigger 触发器

Ext.form.field.Time  带有时间下拉框 和自动验证的input表单。

Ext.form.field.Date 带有日期选择器下拉框并会自动进行

 日期验证的日期输入表单

Ext.form.field.Number   数值型的文本表单,对非数组值行的

按键进行自动过滤,并且限定一系列 有效范围。

Ext.form.field.File 文件上传的

Ext.form.field.ComboBox 选择框

Ext.form.field.Checkbox 选择框方式的

Ext.form.field.Radio 单选框

Ext.form.field.Hidden 特殊的-隐藏字段  提交表单时传递到后台。

Ext.form.field.HtmlEditor 特殊的-文本编辑框

5.其中夹杂布局的类

Ext.form.FieldContainer    文本域容器

Ext.form.CheckboxGroup  表单项容器。   

Ext.form.RadioGroup    一个field container其中有一个专门

Ext.form.field.Radio 控件分类按列分布的布局安排

Ext.form.Label    

创建一个独立的 <label /> 元素,此元素可以加入到 form

 之中,也可以通过 forId 与该form中的表单域 field 关联

Ext.form.Labelable

一个混合类,允许组件被配置且装饰有标签和错误消息,

作为表单字段的通用组件。

Ext.form.FieldSet

  控件组,输入域组合容器. 包装一组输入域的容器,

Ext.form.FieldContainer  文本域容器

Ext.form.Panel

  重要的配置项

    title:'',             标题头

    bodyStyle:'',      自定义到css 样式

    frame : ,            以什么方式提交提画面

    height: ,            高

    width :, 宽

    renderTo:'',    指定某个id ,这元素将被渲染。

    defaultType:'',   当前容器中创建子组件时使用的默认 xtype

    defaults:{}

    由于混入了Ext.form.Labelable

      可以配置

        labelSeparator 字段名字和值的分割符号

        labelWidth 标签宽度

      重要的方法

        Ext.form.field.Text  文本框(xtype: textfield)

       重要的配置项

width : 150,

allowBlank: false, //不能是空

labelAlign :'left',

msgTarget:'side'//在字段的右面展示数据

    重要的方法

    Ext.form.field.ComboBox

    控件支持自动完成、远程加载、和许多其他特性。

Validations 内置校验

  Ext.data.validations

    本单例包含一个验证函数集合, 用以验证任何类型的数据。通常在 Model中使 用它们, 它们是自动生成和执行的

       可以通过msgTarget改变错误信息的显示位置,通过invalidText改变错误信息的内容,每个字段都有自己的invalidText实现方式,错误信息中有许多可替换的标记

    例如,在Date Field的invalidText中,任何’{0}’ 都会被替换成这个字段的值,’ {1}’会被替换成这个字段的format,下面的代码展示了如何使用这个特性自定义错误信息

    自定义校验:

      用Text Field的regex配置应用一个校验规则,和使用maskRe配置限制可输入的字符,这有一个使用TextField校验输入时间的例子 

     {
           fieldLabel: 'Last Login Time',
           name: 'loginTime',
           regex: /^([1-9]|1[0-9]):([0-5][0-9])(s[a|p]m)$/i,
           maskRe: /[ds:amp]/i,
           invalidText: 'Not a valid time.  Must be in the format "12:34 PM".'
    }

Ext.form.action.Submit

    这类用来处理用Form 提交数据,并可以处理应答的返回值。

    这个类的实例只在Form 提交的时候创建。

    buttons: [ {
          text: 'Submit',
          handler: function() { var form = this.up('form').getForm();
          if (form.isValid()) {
            form.submit({ success: function(form, action) {
              Ext.Msg.alert('Success', action.result.msg); },
            failure: function(form, action) {
                Ext.Msg.alert('Failed', action.result.msg);
            }
        });
      } else {
        Ext.Msg.alert('Invalid Data', 'Please correct form errors.')
       } }
    } ]

    1.首先找到对这个类的的引用.

   2. 提交之前调用了isValid方法确保每个表单字段都已经填写正确

   3.最后调用submit方法,并传递了两个回调函数success和failure,在这两个回调函数的参数中,action.result可以引用到服务器端返回JSON的解析后的对象

  数据可以通过loadRecord方法直接从Model加载进入Form Panel:

  Ext.ModelMgr.getModel('User').load(1, {
        success: function(user) {
          // 当用户加载成功,加载数据到表单
          userForm.loadRecord(user);
        }

    });

  代替submit方法,可以使用BasicForm的updateRecord方法更新form绑定的model,然后用Model的save方法保存数据

   buttons: [ { text: 'Submit', handler: function() {
          var form = this.up('form').getForm(),
            //获取到这个
              from record = form.getRecord();
            // 得到底层的模型实例
              if (form.isValid()) {
                //提交前确保表单含有有效数据
                  form.updateRecord(record);
                // 更新的记录表单数据
                  record.save({
                    // 将记录保存到服务器
                  success: function(user) {
                     Ext.Msg.alert('Success', 'User saved successfully.')
                  },
                  failure: function(user) {
                   Ext.Msg.alert('Failure', 'Failed to save user.')
                  } });
                } else {
                // 显示错误警报,如果数据是无效的 Ext.Msg.alert('Invalid Data', 'Please correct form errors.') }
            }

      } ]

      demo 下载 https://github.com/ningmengxs/Extjs.git

原文地址:https://www.cnblogs.com/nmxs/p/6430443.html