Ext.form各类控件的配置及方法

Ext.form各类控件的配置及方法

1、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：传递到请求中的参数 

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

          url：表单默认的提交路径 

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

          timeout：表单动作的超时时间，默认为30秒 

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

    方法： 

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

              url：动作提交的路径 

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

              params：传递到请求中的参数 

              headers： 

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

              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 

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

          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：输入值是否严格为待选列表中存在的值。如果输入不存在的值，会自动选择第一个最接近的值。 

           hiddenName：隐藏字段的名字，如果提供该参数则一个隐藏字段将被创建，用来存储所选值，当表单提交时在服务器端可以通过该名字取得列表中的所选值 

           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：多个时间输入格式组成的字符串，不同的格式之间使用“|”进行分割