天天看点

ExtJS4组件_form表单配置-属性-方法详解

、Ext.form.Action 

配置项:

      success:执行成功后回调的函数,包括两个参数:form和action  

      failure:执行失败后回调的函数,包括两个参数:form和action  

      method:表单的提交方式,有效值包括GET、POST  

      params:传递到请求中的参数  

      url:动作提交的路径 

      waitMsg:动作执行时显示的等待信息  

属性:

      Action.CLIENT_INVALID:客户端验证错误 

      Action.CONNECT_FAILURE:通信错误  

      Action.LOAD_FAILURE:加载数据时,没有包含data属性的字段被返回  

      Action.SERVER_INVALID:服务端验证错误  

      failureType:错误类型  

      result:包含布尔类型的success属性和其他属性,如{success: true, msg: 'ok'}  

      type:动作类型,可选值有submit和load  

      Ext.form.Action.Submit:返回的信息中要包含一个布尔类型的success属性和一个可选的

      errors属性  

      Ext.form.Action.Load:返回的信息中要包含一个布尔类型的success属性和一个data属性 

2、Ext.form.BasicForm

      baseParams:传递到请求中的参数  

      url:表单默认的提交路径  

      fileUpload:表单是否进行文件上传  

      timeout:表单动作的超时时间,默认为30秒  

      trackResetOnLoad:是否在表单初次创建时清楚数据  

方法:

      doAction( String/Object actionName,[Object options] ):执行一个预订的动作,可用选项包括:  

      url:动作提交的路径  

      headers:  

       failure:执行失败后回调的函数,包括两个参数:form和action  

      clientValidation:是否客户端验证  

      clearInvalid():清除表单中所有的无效验证信息  

      findField( String id ):查找表单字段  

             getValues( [Boolean asString] ):  

             isDirty():表单数据是否被更改过  

             isValid():客户端验证是否成功  

             load( Object options ):执行表单读取动作  

             loadRecord( Record record ):从一个数据记录中读取数据到表单中  

             markInvalid( Array/Object errors ):成批设置表单字段为验证无效  

             reset():重置表单  

             setValues( Array/Object values ):成批设置表单字段值  

             submit( Object options ):执行表单提交动作  

             updateRecord( Record record ):持久化表单数据到记录集中  

3、Ext.form.FormPanel

      items:一个元素或元素数组  

      buttons:一个按钮配置对象的数组,按钮将被添加到表单页脚中  

      buttonAlign:按钮的对齐方式,可选值有left、center、right,默认为center  

      labelWidth:表单标签的宽度  

      labelAlign:表单标签的对齐方式,可选值有left、top、right,默认为left  

      labelSeparator:字段标签与字段之间的分隔符,默认为':'  

      minButtonWidth:按钮的最小宽度,默认为75  

      getForm() : Ext.form.BasicForm  

      load( Object options )  

      startMonitoring()  

      stopMonitoring()  

4、Ext.form.Field

      name:字段名  

      value:字段的初始化值  

      disabled:字段是否不可用,默认为false  

      fieldLabel:字段标签说明  

      hideLabel:隐藏字段标签,默认为false  

      labelStyle:字段标签样式  

      inputType:默认为text  

      invalidClass:默认为x-form-invalid  

      invalidText:字段非法文本提示  

      msgTarget:错误信息显示的位置,默认为qtip  

      qtip:显示一个浮动的提示信息         title:显示一个浏览器的浮动提示信息  

      under:在字段下方显示一个提示信息  

      side:在字段右边显示一个提示信息  

      readOnly:字段是否只读,默认为false  

      validateOnBlur:字段在失去焦点时被验证,默认为true  

      clearInvalid():  

      getRawValue()  

      setRawValue( Mixed value )  

      getValue()  

      setValue( Mixed value )  

      isDirty():字段值在装载后是否被修改过  

      isValid( Boolean preventMark ):当前字段值是否合法  

      markInvalid( [String msg] )  

      validate()  

   reset()  

5、Ext.form.Hidden

6、Ext.form.Label

html: 

text: 

7、Ext.form.TextField

      allowBlank:是否允许为空,默认为true  

      blankText:空验证失败后显示的提示信息  

      emptyText:在一个空字段中默认显示的信息  

      grow:字段是否自动伸展和收缩,默认为false  

      growMin:收缩的最小宽度  

      growMax:伸展的最大宽度  

      inputType:字段类型:默认为text  

      maskRe:用于过滤不匹配字符输入的正则表达式  

      maxLength:字段允许输入的最大长度  

      maxLengthText:最大长度验证失败后显示的提示信息  

      minLength:字段允许输入的最小长度  

      minLengthText:最小长度验证失败后显示的提示信息  

      regex:正则表达式  

      regexText:正则表达式验证失败后显示的提示信息  

      vtype:验证类型的名字         alpha:限制只能输入字母  

      alphanum:限制只能输入字母和数字  

      email  

      url  

      vtypeText:验证失败时的提示信息  

      validator:自定义验证函数  

      selectOnFocus:当字段得到焦点时自动选择已存在的文本,默认为false 

8、Ext.form.TextArea  

      preventScrollbars:是否禁止出现滚动条,默认为false  

9、Ext.form.NumberField  

      allowDecimals:是否允许输入小数,默认为true  

      allowNegative:是否允许输入负数,默认为true  

      baseChars:输入的有效数字集合,默认为'0123456789'  

      decimalPrecision:数字的精度,默认保留小数点后2位  

      decimalSeparator:十进制分隔符,默认为'.'  

      maxValue:允许输入的最大数值  

      maxText:超过最大值之后的提示信息  

      minValue:允许输入的最小数值  

      minText:超过最小值之后的提示信息  

      nanText:输入非有效数值之后的提示信息 

10、Ext.form.Checkbox  

      boxLabel:复选框的文字描述  

      checked:复选框是否被选择,默认为false  

      handler:当checked值改变时触发的函数,函数包含两个参数:checkbox、checked  

      inputValue:  

      getValue():返回复选框的checked状态  

      setValue( Boolean/String checked ):  

11、Ext.form.CheckboxGroup  

      allowBlank:是否允许不选择,默认为true  

      blankText:  

      columns:显示的列数,可选值包括:固定值auto、数值、数组(整数、小数)  

      items:对象数组  

      vertical:是否垂直方向显示对象,默认为false 

12、Ext.form.Radio  

      getGroupValue():  

      setValue( value {String/Boolean} ):  

13、Ext.form.RadioGroup  

      allowBlank:  

      blankText: 

14、Ext.form.ComboBox  

      displayField:被显示在下拉框中的字段名  

      editable:是否可编辑,默认为true  

      forceSelection:输入值是否严格为待选列表中存在的值。如果输入不存在的值,会自动选择第一个最接近的值。当表单提交时在服务器端可以通过该名字取得列表中的所选值  

      listWidth:下拉列表的宽度  

      minListWidth:下拉列表的最小宽度,默认为70像素  

      loadingText:当下拉框加载数据时显示的提示信息,只有当mode='remote'时才会生效  

      maxHeight:下拉列表框的最大高度,默认为300像素  

      minChars:下拉列表框自动选择前用户需要输入的最小字符数量。mode='remote'默认为4,

      mode='local'默认为0  

      mode:下拉列表框的数据读取模式。remote读取远程数据,local读取本地数据  

      pageSize:下拉列表框的分页大小。该项设置只在mode='remote'时生效  

      queryParam:查询的名字,默认为'query',将被传递到查询字符串中  

      allQuery:一个发往服务器用来查询全部信息的查询字符串,默认为空字符串''  

      selectOnFocus:当获得焦点时立刻选择一个已存在的列表项。默认为false,此项只有在

      editable=true时才会生效  

      store:列表框绑定的数据源  

      transform:将页面中已存在的元素转换为组合框  

      lazyInit:延时初始化下拉列表,默认为true  

      lazyRender:延时渲染,默认为false  

      triggerAction:设置单击触发按钮时执行的默认操作,有效值包括all和query,默认为query,如果设置为all则会执行allQuery中设置的查询  

      typeAhead:设置在输入过程中是否自动选择匹配的剩余部分文本(选择第一个满足条件的),默认为false  

      value:初始化组合框中的值  

      valueField:组合框的值字段  

      valueNotFoundText:值不存在时的提示信息  

      tpl:Ext模板字符串或模板对象,可以通过该配置项自定义下拉列表的显示方式方法:  

      clearValue():清空字段当前值        doQuery( String query, Boolean forceAll ):        getValue():        getStore():        setValue( String value ):

15、Ext.form.DateField  

      maxValue:允许选择的最大日期

      maxText:当日期大于最大值时的错误提示信息

      minValue:允许选择的最小时间

      minText:当日期小于最小值时的错误提示信息

      format:日期显示格式,默认为“m/d/y”,一般使用“Y-m-d”

             Y:四位年份

            m:带前缀0的月份

            d:带前缀0的日期

            y:两位年份

            n:不带前缀0的月份

            j:不带前缀0的日期

            w:星期的数字,0表示星期日,1代表星期一

      showToday:是否显示今天按钮,默认为true

      altFormats:多个日期输入格式组成的字符串,不同的格式之间使用“|”进行分割,默认值为'm/d/Y|n/j/Y|n/j/y|m/j/y|n/d/y|m/j/Y|n/d/Y|m-d-y|m-d-Y|m/d|m-d|md|mdy|mdY|d|Y-m-d'

      disabledDates:禁止选择的日期组成的数组

      disabledDatesText:选择禁选日期时显示的提示信息

      disabledDays:禁止选择的星期组成的数组,0代表星期日,1代表星期一

      disabledDaysText:选择禁选星期时显示的提示信息

      invalidText:当日期值非法时显示的提示信息

      getValue():取得日期值

16、Ext.form.FieldSet  

      animCollapse:动画折叠,默认为false

      checkboxToggle:设置是否显示字段集的checkbox选择框,默认为false

      checkboxName:指定字段集中用于展开或隐藏字段集面板的checkbox的名字,该属性只有在checkboxToggle为true时生效

      labelWidth:字段标签的宽度,可以级联到子容器

      layout:布局,默认为form 

17、Ext.form.TimeField  

      maxValue:列表中允许的最大时间

      maxText:当时间大于最大值时的错误提示信息

      minValue:列表中允许的最小时间

      minText:当时间小于最小值时的错误提示信息

      increment:两个相邻选项间的时间间隔,默认为15分钟

      format:显示格式,默认为“g:i A”。一般使用“H:i:s”

             H:带前缀0的24小时

             i:带前缀0的分钟

             s:带前缀0的秒

      invalidText:当时间值非法时显示的提示信息

      altFormats:多个时间输入格式组成的字符串,不同的格式之间使用“|”进行分割

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