X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/c930e9176a5a85509c5b0230e2bff5c22a591432..0494b8d9b9bb03ab6c22b34dae81261e3cd7e3e6:/docs/output/Ext.form.ComboBox.html diff --git a/docs/output/Ext.form.ComboBox.html b/docs/output/Ext.form.ComboBox.html index 725f6979..888f930f 100644 --- a/docs/output/Ext.form.ComboBox.html +++ b/docs/output/Ext.form.ComboBox.html @@ -1,4 +1,10 @@ -
Properties Methods Events Config Options Direct Link
Observable
  Component
    BoxComponent
      Field
        TextField
          TriggerField
            ComboBox

Class Ext.form.ComboBox

Package:Ext.form
Defined In:Combo.js
Class:ComboBox
Subclasses:TimeField
Extends:TriggerField
xtype:combo

A combobox control with support for autocomplete, remote-loading, paging and many other features.

+

Class Ext.form.ComboBox

Package:Ext.form
Defined In:Combo.js
Class:ComboBox
Subclasses:TimeField
Extends:TriggerField

A combobox control with support for autocomplete, remote-loading, paging and many other features.

A ComboBox works in a similar manner to a traditional HTML <select> field. The difference is that to submit the valueField, you must specify a hiddenName to create a hidden input field to hold the value of the valueField. The displayField is shown in the text field @@ -60,14 +66,14 @@ Ext.util.Format.comboRenderer = function(combo){

A ComboBox uses filtering itself, for information about filtering the ComboBox store manually see lastQuery.

Config Options

The length of time in milliseconds to wait until the typeahead text is displayed if typeAhead = true (defaults to 250)
Config OptionsDefined By
 allQuery : String
The text query to send to the server to return all records for the list with no filtering (defaults to '')
ComboBox
 allowBlank : Boolean
Specify false to validate that the value's length is > 0 (defaults to -true)
TextField
 allowDomMove : Boolean
Whether the component can move the Dom node when rendering (defaults to true).
Component
 allowDomMove : Boolean
Whether the component can move the Dom node when rendering (defaults to true).
Component
 blankText : String
The error text to display if the allowBlank validation -fails (defaults to 'This field is required')
TextField
 cls : String
A custom CSS class to apply to the field's underlying element (defaults to "").
Field
 clearFilterOnReset : Boolean
true to clear any filters on the store (when in local mode) when reset is called +(defaults to true)
ComboBox
 cls : String
A custom CSS class to apply to the field's underlying element (defaults to '').
Field
 disableKeyFilter : Boolean
Specify true to disable input keystroke filtering (defaults +

Component
 data : Mixed
The initial set of data to apply to the tpl to +update the content area of the Component.
Component
 disableKeyFilter : Boolean
Specify true to disable input keystroke filtering (defaults to false)
TextField
 disabledClass : String
CSS class added to the component when it is disabled (defaults to 'x-item-disabled').
Component
 enableKeyEvents : Boolean
true to enable the proxying of key events for the HTML input -field (defaults to false)
TextField
 fieldClass : String
The default CSS class for the field (defaults to "x-form-field")
Field
 fieldClass : String
The default CSS class for the field (defaults to 'x-form-field')
Field
 focusClass : String
The CSS class to use when the field receives focus (defaults to "x-form-focus")
Field
 focusClass : String
The CSS class to use when the field receives focus (defaults to 'x-form-focus')
Field
 handleHeight : Number
The height in pixels of the dropdown list resize handle if resizable = true (defaults to 8)
ComboBox
 hidden : Boolean
Render this component hidden (default is false). If true, the hide method will be called internally.
Component
 hideTrigger : Boolean
true to hide the trigger element and display only the base -text field (defaults to false)
TriggerField
 invalidClass : String
The CSS class to use when marking a field invalid (defaults to "x-form-invalid")
Field
 invalidClass : String
The CSS class to use when marking a field invalid (defaults to 'x-form-invalid')
Field
 listClass : String
The CSS class to add to the predefined 'x-combo-list' class +defaults to false).
ComboBox
 listClass : String
The CSS class to add to the predefined 'x-combo-list' class applied the dropdown list element (defaults to '').
ComboBox
 listEmptyText : String
The empty text to display in the data view if no items are found. (defaults to '')
ComboBox
 msgFx : String
Experimental The effect used when displaying a validation message under the field -(defaults to 'normal').
Field
 preventMark : Boolean
true to disable marking the field invalid. +Defaults to false.
Field
 queryParam : String
Name of the query (baseParam name for the store) -as it will be passed on the querystring (defaults to 'query')
ComboBox
 regexText : String
The error text to display if regex is used and the @@ -603,14 +647,15 @@ Acceptable values for this property are: Acceptable values for this property are:
  • any Store subclass
  • -
  • an Array : Arrays will be converted to a Ext.data.ArrayStore internally. +
  • an Array : Arrays will be converted to a Ext.data.ArrayStore internally, +automatically generating field names to work with all data components.
    • 1-dimensional array : (e.g., ['Foo','Bar'])
      -A 1-dimensional array will automatically be expanded (each array item will be the combo -value and text)
    • +A 1-dimensional array will automatically be expanded (each array item will be used for both the combo +valueField and displayField)
  • 2-dimensional array : (e.g., [['f','Foo'],['b','Bar']])
    For a multi-dimensional array, the value in index 0 of each item will be assumed to be the combo -value, while the value at index 1 is assumed to be the combo text. +valueField, while the value at index 1 is assumed to be the combo displayField.

See also mode.

ComboBox
 stripCharsRe : RegExp
A JavaScript RegExp object used to strip unwanted content from the value before validation (defaults to null).
TextField
ComboBox
 validateOnBlur : Boolean
Whether the field should validate when it loses focus (defaults to true).
Field
 validationDelay : Number
The length of time in milliseconds after user input begins until validation is initiated (defaults to 250)
Field
 value : Mixed
A value to initialize this field with (defaults to undefined).
Field
 value : Mixed
A value to initialize this field with (defaults to undefined).
Field
 hidden : Boolean
True if this component is hidden. Read-only.
Component
 initialConfig : Object
This Component's initial configuration specification. Read-only.
Component
 hidden : Boolean
True if this component is hidden. Read-only.
Component
 initialConfig : Object
This Component's initial configuration specification. Read-only.
Component
 keyNav : Ext.KeyNav +<p>A {@link Ext.KeyNav KeyNav} object which handles navigation keys for this ComboBox. This performs actions +based on keystrokes typed when the input field is focused.</p> +<p><b>After the ComboBox has been rendered</b>, you may override existing navigation key functionality, +or add your own based upon key names as specified in the {@link Ext.KeyNav KeyNav} class.</p> +<p>The function is executed in the scope (<code>this</code> reference of the ComboBox. Example:</p><pre><code> +myCombo.keyNav.esc = function(e) { // Override ESC handling function + this.collapse(); // Standard behaviour of Ext's ComboBox. + this.setValue(this.startValue); // We reset to starting value on ESC +}; +myCombo.keyNav.tab = function() { // Override TAB handling function + this.onViewClick(false); // Select the currently highlighted row +}; +</code></pre>
ComboBox
 rendered : Boolean
True if this component has been rendered. Read-only.
Component
 view : Ext.DataView
The DataView used to display the ComboBox's options.
ComboBox

Public Methods

MethodDefined By
 rendered : Boolean
True if this component has been rendered. Read-only.
Component
 view : Ext.DataView
The DataView used to display the ComboBox's options.
ComboBox

Public Methods

MethodDefined By

Public Events

EventDefined By

Public Events

EventDefined By