Ext.form.DateField控件属性说明

 

配置项

1、format : String 

用以覆盖本地化的默认日期格式化字串。字串必须为符合指定Date#parseDate的形式(默认为 'm/d/y')。

2、   altFormats : String 

用 "|" 符号分隔的多个日期格式化字串，当输入的日期与默认的格式不符时用来尝试格式化输入值(默认为 'm/d/Y|m-d-y|m-d-Y|m/d|m-d|d')。 

3、disabledDaysText : String 

一个禁用的星期数组，以 0 开始。例如，[0，6] 表示禁用周六和周日(默认为 null)。 

4、disabledDatesText : String 

禁用星期上显示的工具提示(默认为 'Disabled')。

5、minText : String 

当字段的日期早于 minValue 属性指定值时显示的错误文本(默认为'The date in this field must be after {minValue}') 

6、maxText : String 

当字段的日期晚于 maxValue 属性指定值时显示的错误文本(默认为'The date in this field must be before {maxValue}') 

7、invalidText : String 

表单元素无效时标在上面的文本信息（默认为"The value in this field is invalid"）。

 

8、triggerClass : String 

应用到触发器身上的CSS样式类

9、showToday : Boolean 

False表示隐藏底部的Today按钮并禁止空格的快捷键来选择当日日期（默认为true）。

10、minValue : Date/String 

允许最早的日期。可以是JavaScript日期对象或者是一个符合日期格式要求的字符串（默认为null）。

11、maxValue : Date/String 

允许最晚的日期。可以是JavaScript日期对象或者是一个符合日期格式要求的字符串（默认为null）。

12、disabledDays : Array 

禁用日子的数组，从0开始。[0, 6]禁止了从星期日到星期六（默认为null）。

13、disabledDates : Array 

一个以字串形式表示的禁用的日期数组。这些字串将会被用来创建一个动态正则表达式，所以它们是很强大的。一个例子: 

["03/08/2003", "09/16/2003"] 将会禁用那些确切的日期

["03/08", "09/16"] 将会禁用每年中的那些日子 

["^03/08"]将会只匹配开头(当使用短年份时非常有用 

["03/../2006"]将会禁用 2006 年 三月 的每一天 

["^03"]将会禁用每年三月的每一天

注意日期的格式必须一定要符合#format的配置格式。 为了提供正则表达式的支持, 如果你使用一个包含 "." 的日期格式，你就得将小数点转义使用。例如: ["03\\.08\\.03"]。

14、autoCreate : String/Object 

一个指定的DomHelper配置对象，如果为真则为一个默认对象（{tag: "input", type: "text", size: "20", autocomplete: "off"}）。

15、hideTrigger : Boolean 

为true时隐藏触发元素，只显示基本文本域（默认为false）。

16、vtypeText : String 

在当前字段的#vtype中，制定一个错误信息代替默认的（默认为null）。如vtype不设置该项就无效。 

17、stripCharsRe : RegExp 

一个JavaScript正则表达式，用于在进行验证该动作之前抽离不需要的内容（默认为null）

18、grow : Boolean 

当值为 true 时表示字段可以根据内容自动伸缩。 

19、growMin : Number 

当 grow = true 时允许的字段最小宽度（默认为 30）

20、growMax : Number 

当 grow = true 时允许的字段最大宽度(默认为 800) 

21、vtype : String 

中定义的效验类型名(默认为 null) 

22、maskRe : RegExp 

一个用来过滤无效按键的正则表达式(默认为 null) 

23、disableKeyFilter : Boolean 

值为 true 时禁用输入按键过滤(默认为 false) 

24、allowBlank : Boolean 

值为 false 时将效验输入字符个数大于0(默认为 true) 

25、minLength : Number 

输入字段所需的最小字符数(默认为 0) 

26、maxLength : Number 

输入字段允许的最大字符数(默认为 Number.MAX_VALUE)

27、minLengthText : String 

输入字符数小于最小字符数时显示的文本（默认为"The minimum length for this field is {minLength}"） 

28、maxLengthText : String 

输入字符数小于最小字符数时显示的文本（默认为"The maximum length for this field is {maxLength}"） 

29、selectOnFocus : Boolean 

值为 ture 时表示字段获取焦点时自动选择字段既有文本(默认为 false)。 

30、blankText : String 

当允许为空效验失败时显示的错误文本（默认为 "This field is required"）。 

31、validator : Function 

字段效验时调用的自定义的效验函数(默认为 null)。 如果启用此项，则此函数将在所有基础效验（#allowBlank、#minLength、#maxLength和任意的#vtype）成功之后被调用，调用函数时传递的参数为该字段的值。且此函数的有效返回应为成功时返回 true，失败时返回错误文本。 

32、regex : RegExp 

一个用以在效验时使用的 JavaScript 正则表达式对象(默认为 null)。如果启用此项，则此正则表达式将在所有基础效验成功之后被执行，执行此正则表达式时传递的参数为该字段的值。如果效验失败，则根据#regexText的设置将字段标记为无效。

33、regexText : String 

当#regex被设置且效验失败时显示的错误文本(默认为 "")。 

34、emptyText : String 

空字段中显示的文本(默认为 null)。注意，只要这个字段是被激活的而且name属性指定的，那么也会发送到服务端。 

35、emptyClass : String 

#emptyText使用的CSS样式类名(默认为 'x-form-empty-field')。此类的添加与移除均由当前字段是否有值来自动处理。

36、enableKeyEvents : Boolean 

True表示，为HTML的input输入字段激活键盘事件的代理（默认为false） 

37、fieldLabel : String 

在组件旁边那里显示的label文本（默认为''）。 

此组件只有在Ext.form.FormLayout FormLayout布局管理器控制的容器下渲染才有用。

38、inputType : String 

input字段的type属性，诸如 radio、text、password、file等的元素都有type属性。属性是“file”与“怕ssword”就要在这里设置了，因为当前Ext并没有这些单独的组件。 注意当你使用inputType:'file'时，#emptyText就避免使用。

39、tabIndex : Number 

字段的tabIndex。注意这只对已渲染的元素有效，applyTo的那些无效（默认为undfined）。

40、value : Mixed 

字段初始化的值（默认为undefined）。

41、name : String 

字段的name属性，HTML的name属性（默认为''）。 

42、cls : String 

一个可选添加的CSS样式类，加入到组件的元素上（默认为''）。这为组件或组件的子节点加入标准CSS规则提供了方便。 An optional extra CSS class that will be added to this component's Element (defaults to ''). 

43、invalidClass : String 

当出现无效字段所使用上的CSS样式（默认为"x-form-invalid）。

44、focusClass : String 

当表单元素获取焦点时的CSS样式（默认为"x-form-focus"）。 

45、validationEvent : String/Boolean 

初始化元素验证的事件名，如果设假，则不进行验证（默认"keyup"）。

46、validateOnBlur : Boolean 

是否当失去焦点时验证此表单元素（默认真）。 

47、validationDelay : Number 

用户输入开始到验证开始的间隔毫秒数（默认250毫秒）。

48、fieldClass : String 

表单元素一般状态CSS样式（默认为"x-form-field"）。 

49、msgTarget : String 

错误提示的显示位置。 可以是以下列表中的任意一项（默认为"qtip"）

50、msgFx : String 

Experimental 表单元素无效提示显示的动画效果（默认为"normal"）

51、readOnly : Boolean 

如果为真，则在HTML时标明此表单元素为只读 -- 注意：只是设置表单对象的只读属性。 

52、disabled : Boolean 

渲染该组件为禁用状态的（默认为false）。

  

53、   fireEvent( String eventName, Object... args ) : Boolean 

触发指定的事件,并在这里把处理函数的参数传入（应该至少要有事件的名称）... 

触发指定的事件,并在这里把处理函数的参数传入（应该至少要有事件的名称）。 

参数项： 

eventName : String 事件名称如果这个事件是要在Observable父类上逐层上报（参阅Ext.Component#getBubbleTarget），那么第一个参数一定是true，然后第二个参数是事件名称。 

args : Object... 传入事件处理函数的参数

返回值： Boolean 从处理函数返回true或者false 

  

54、addListener( String eventName, Function fn, Object scope, Object options ) 

加入一个事件处理函数。#on是其简写方式。 

参数项： 

eventName : String 事件处理函数的名称。

fn : Function 事件处理函数。该函数会送入以下的参数：

evt : EventObject用于描述这次事件Ext.EventObject EventObject的事件对象。