Docs Help

Terms, Icons, and Labels

Many classes have shortcut names used when creating (instantiating) a class with a configuration object. The shortcut name is referred to as an alias (or xtype if the class extends Ext.Component). The alias/xtype is listed next to the class name of applicable classes for quick reference.

Access Levels

Framework classes or their members may be specified as private or protected. Else, the class / member is public. Public, protected, and private are access descriptors used to convey how and when the class or class member should be used.

Member Types

Member Syntax

Below is an example class member that we can disect to show the syntax of a class member (the lookupComponent method as viewed from the Ext.button.Button class in this case).

lookupComponent ( item ) : Ext.Component
protected

Called when a raw config object is added to this container either during initialization of the items config, or when new items are added), or {@link #insert inserted.

This method converts the passed object into an instanced child component.

This may be overridden in subclasses when special processing needs to be applied to child creation.

Parameters

item :  Object

The config object being added.

Returns
Ext.Component

The component to be added.

Let's look at each part of the member row:

Member Flags

The API documentation uses a number of flags to further commnicate the class member's function and intent. The label may be represented by a text label, an abbreviation, or an icon.

Class Icons

- Indicates a framework class

- A singleton framework class. *See the singleton flag for more information

- A component-type framework class (any class within the Ext JS framework that extends Ext.Component)

- Indicates that the class, member, or guide is new in the currently viewed version

Member Icons

- Indicates a class member of type config

- Indicates a class member of type property

- Indicates a class member of type method

- Indicates a class member of type event

- Indicates a class member of type theme variable

- Indicates a class member of type theme mixin

- Indicates that the class, member, or guide is new in the currently viewed version

Class Member Quick-Nav Menu

Just below the class name on an API doc page is a row of buttons corresponding to the types of members owned by the current class. Each button shows a count of members by type (this count is updated as filters are applied). Clicking the button will navigate you to that member section. Hovering over the member-type button will reveal a popup menu of all members of that type for quick navigation.

Getter and Setter Methods

Getting and setter methods that correlate to a class config option will show up in the methods section as well as in the configs section of both the API doc and the member-type menus just beneath the config they work with. The getter and setter method documentation will be found in the config row for easy reference.

History Bar

Your page history is kept in localstorage and displayed (using the available real estate) just below the top title bar. By default, the only search results shown are the pages matching the product / version you're currently viewing. You can expand what is displayed by clicking on the button on the right-hand side of the history bar and choosing the "All" radio option. This will show all recent pages in the history bar for all products / versions.

Within the history config menu you will also see a listing of your recent page visits. The results are filtered by the "Current Product / Version" and "All" radio options. Clicking on the button will clear the history bar as well as the history kept in local storage.

If "All" is selected in the history config menu the checkbox option for "Show product details in the history bar" will be enabled. When checked, the product/version for each historic page will show alongside the page name in the history bar. Hovering the cursor over the page names in the history bar will also show the product/version as a tooltip.

Search and Filters

Both API docs and guides can be searched for using the search field at the top of the page.

On API doc pages there is also a filter input field that filters the member rows using the filter string. In addition to filtering by string you can filter the class members by access level, inheritance, and read only. This is done using the checkboxes at the top of the page.

The checkbox at the bottom of the API class navigation tree filters the class list to include or exclude private classes.

Clicking on an empty search field will show your last 10 searches for quick navigation.

API Doc Class Metadata

Each API doc page (with the exception of Javascript primitives pages) has a menu view of metadata relating to that class. This metadata view will have one or more of the following:

Expanding and Collapsing Examples and Class Members

Runnable examples (Fiddles) are expanded on a page by default. You can collapse and expand example code blocks individually using the arrow on the top-left of the code block. You can also toggle the collapse state of all examples using the toggle button on the top-right of the page. The toggle-all state will be remembered between page loads.

Class members are collapsed on a page by default. You can expand and collapse members using the arrow icon on the left of the member row or globally using the expand / collapse all toggle button top-right.

Desktop -vs- Mobile View

Viewing the docs on narrower screens or browsers will result in a view optimized for a smaller form factor. The primary differences between the desktop and "mobile" view are:

Viewing the Class Source

The class source can be viewed by clicking on the class name at the top of an API doc page. The source for class members can be viewed by clicking on the "view source" link on the right-hand side of the member row.

Ext JS 6.6.0 - Modern Toolkit


top

Ext.field.ComboBox xtype: combobox, comboboxfield

Summary

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

A ComboBox is like a combination of a traditional HTML text <input> field and a <select> field; if the editable config is true, then the user is able to type freely into the field, and/or pick values from a dropdown selection list.

The user can input any value by default, even if it does not appear in the selection list; to prevent free-form values and restrict them to items in the list, set forceSelection to true.

The selection list's options are populated from any Ext.data.Store, including remote stores. The data items in the store are mapped to each option's displayed text and backing value via the valueField and displayField configurations which are applied to the list via the itemTpl.

If your store is not remote, i.e. it depends only on local data and is loaded up front, you MUST set the queryMode to 'local'.

Example usage:

Events

ComboBox fires a select event if an item is chosen from the associated list. If the ComboBox is configured with forceSelection: true, an action event is fired when the user has typed the ENTER key while editing the field, and a change event on each keystroke.

Customized combobox

Both the text shown in dropdown list and text field can be easily customized:

See also the floatedPicker and edgePicker options for additional configuration of the options list.

No members found using the current filters

configs

Optional Configs

alignTarget : String

The element reference to which the picker aligns and sizes to. By default, it sizes to the bodyElement which encapsulates the input field and triggers.

An alternate value which may be useful if using floated pickers on phone platforms could be el, to align the picker to the field's encapsulating element.

Defaults to:

'bodyElement'

allQuery : String
bindable bind

The text query to use to filter the store when the trigger element is tapped (or expansion is requested by a keyboard gesture). By default, this is null causing no filtering to occur.

Defaults to:

null

getAllQuery : String

Returns the value of allQuery

Returns

String

setAllQuery (allQuery)

Sets the value of allQuery

Parameters

allQuery :  String

alwaysOnTop : Boolean / Number
bindable bind

A flag indicating that this component should be above its floated siblings.

This may be a positive number to prioritize the ordering of multiple visible always on top components.

This may be set to a negative number to prioritize a component to the bottom of the z-index stack.

Defaults to:

false

Available since: 6.2.0

getAlwaysOnTop : Boolean / Number

Returns the value of alwaysOnTop

Returns

Boolean / Number

setAlwaysOnTop (alwaysOnTop)

Sets the value of alwaysOnTop

Parameters

alwaysOnTop :  Boolean / Number

animateUnderline : Boolean
bindable bind

'true' to animate the underline of a field when focused

Defaults to:

false

getAnimateUnderline : Boolean

Returns the value of animateUnderline

Returns

Boolean

setAnimateUnderline (animateUnderline)

Sets the value of animateUnderline

Parameters

animateUnderline :  Boolean

anyMatch : Boolean
bindable bind

  • Only valid when queryMode is 'local'. Configure as true to cause the primaryFilter to match the typed characters at any position in the displayField's value when filtering locally*.

Defaults to:

false

getAnyMatch : Boolean

Returns the value of anyMatch

Returns

Boolean

setAnyMatch (anyMatch)

Sets the value of anyMatch

Parameters

anyMatch :  Boolean

ariaAttributes : Object
bindable bind

An object containing ARIA attributes to be set on this Component's ARIA element. Use this to set the attributes that cannot be determined by the Component's state, such as aria-live, aria-flowto, etc.

Note that this config is only meaningful at the Component rendering time, and setting it after that will do nothing.

Defaults to:

null

getAriaAttributes : Object

Returns the value of ariaAttributes

Returns

Object

setAriaAttributes (ariaAttributes)

Sets the value of ariaAttributes

Parameters

ariaAttributes :  Object

ariaDescribedBy : String

DOM selector for a child element that is to be used as description for this Component, set in aria-describedby attribute. The selector works the same way as ariaLabelledBy.

ariaLabel : String

ARIA label for this Component. It is best to use ariaLabelledBy option instead, because screen readers prefer aria-labelledby attribute to aria-label. ariaLabel and ariaLabelledBy config options are mutually exclusive.

ariaLabelledBy : String

DOM selector for a child element that is to be used as label for this Component, set in aria-labelledby attribute. If the selector is by id, the label element can be any existing element, not necessarily a child of the main Component element.

ariaLabelledBy and ariaLabel config options are mutually exclusive, and ariaLabelledBy has the higher precedence.

autoCapitalize : Boolean
bindable bind

True to set the field's DOM element autocapitalize attribute to "on", false to set to "off".

Defaults to:

null

getAutoCapitalize : Boolean

Returns the value of autoCapitalize

Returns

Boolean

setAutoCapitalize (autoCapitalize)

Sets the value of autoCapitalize

Parameters

autoCapitalize :  Boolean

autoComplete : Boolean
bindable bind

Autocomplete is disabled on Picker fields by default.

Defaults to:

false

getAutoComplete : Boolean

Returns the value of autoComplete

Returns

Boolean

setAutoComplete (autoComplete)

Sets the value of autoComplete

Parameters

autoComplete :  Boolean

autoCorrect : Boolean
bindable bind

True to set the field DOM element autocorrect attribute to "on", false to set to "off".

Defaults to:

null

getAutoCorrect : Boolean

Returns the value of autoCorrect

Returns

Boolean

setAutoCorrect (autoCorrect)

Sets the value of autoCorrect

Parameters

autoCorrect :  Boolean

autoFitErrors : Boolean
bindable bind

Whether to adjust the field's body width to make room for the error messages.

Defaults to:

true

getAutoFitErrors : Boolean

Returns the value of autoFitErrors

Returns

Boolean

setAutoFitErrors (autoFitErrors)

Sets the value of autoFitErrors

Parameters

autoFitErrors :  Boolean

autoFocus : Boolean
bindable bind

true to automatically focus the first result gathered by the data store in the dropdown list when it is opened. A false value would cause nothing in the list to be highlighted automatically, so the user would have to manually highlight an item before pressing the enter or tab key to select it (unless the value of (typeAhead) were true), or use the mouse to select a value.

Defaults to:

true

getAutoFocus : Boolean

Returns the value of autoFocus

Returns

Boolean

setAutoFocus (autoFocus)

Sets the value of autoFocus

Parameters

autoFocus :  Boolean

autoFocusLast : Boolean
bindable bind

When true, the last selected record in the dropdown list will be re-selected upon autoFocus. Set to false to always select the first record in the drop-down list. For accessible applications it is recommended to set this option to false.

Defaults to:

true

getAutoFocusLast : Boolean

Returns the value of autoFocusLast

Returns

Boolean

setAutoFocusLast (autoFocusLast)

Sets the value of autoFocusLast

Parameters

autoFocusLast :  Boolean

autoHideInputMask : Boolean
bindable bind

Specify as false to always show the inputMask.

Defaults to:

true

Available since: 6.5.0

getAutoHideInputMask : Boolean

Returns the value of autoHideInputMask

Returns

Boolean

setAutoHideInputMask (autoHideInputMask)

Sets the value of autoHideInputMask

Parameters

autoHideInputMask :  Boolean

autoLoadOnValue : Boolean
bindable bind

This option controls whether to initially load the store when a value is set so that the display value can be determined from the appropriate record.

The store will only be loaded in a limited set of circumstances:

  • The store is not currently loading.
  • The store does not have a pending Ext.data.Store#autoLoad.
  • The store has not been loaded before.

Defaults to:

false

getAutoLoadOnValue : Boolean

Returns the value of autoLoadOnValue

Returns

Boolean

setAutoLoadOnValue (autoLoadOnValue)

Sets the value of autoLoadOnValue

Parameters

autoLoadOnValue :  Boolean

autoSelect : Boolean
bindable bind

true to auto select the first value in the store or options when they are changed. Only happens when the value is set to null.

Defaults to:

false

getAutoSelect : Boolean

Returns the value of autoSelect

Returns

Boolean

setAutoSelect (autoSelect)

Sets the value of autoSelect

Parameters

autoSelect :  Boolean

axisLock : Boolean
bindable bind

If true, then, when showBy or alignTo fallback on constraint violation only takes place along the major align axis.

That is, if alignment "l-r" is being used, and axisLock: true is used, then if constraints fail, only fallback to "r-l" is considered.

Defaults to:

null

getAxisLock : Boolean

Returns the value of axisLock

Returns

Boolean

setAxisLock (axisLock)

Sets the value of axisLock

Parameters

axisLock :  Boolean

badFormatMessage : String

The error message that will be displayed if the value cannot be parsed (for some derived types) or if the value does not match a configured inputMask.

Defaults to:

'Value does not match the required format'

Available since: 6.5.0

bind : Object / String
bindable bind

Setting this config option adds or removes data bindings for other configs. For example, to bind the title config:

 var panel = Ext.create({
     xtype: 'panel',
     bind: {
         title: 'Hello {user.name}'
     }
 });

To dynamically add bindings:

 panel.setBind({
     title: 'Greetings {user.name}!'
 });

To remove bindings:

 panel.setBind({
     title: null
 });

The bind expressions are presented to Ext.app.ViewModel#bind. The ViewModel instance is determined by lookupViewModel.

Note: If bind is passed as a string, it will use the Ext.Component#property-defaultBindProperty for the binding.

Defaults to:

null

getBind : Object / String

Returns the value of bind

Returns

Object / String

setBind (bind)

Sets the value of bind

Parameters

bind :  Object / String

border : Boolean
bindable bind

Enables or disables bordering on this component. The following values are accepted:

  • null or `true (default): Do nothing and allow the border to be specified by the theme.
  • false: suppress the default border provided by the theme.

Please note that enabling bordering via this config will not add a border-color or border-style CSS property to the component; you provide the border-color and border-style via CSS rule or style configuration (if not already provide by the theme).

Using style:

Ext.Viewport.add({
    centered: true,
    width: 100,
    height: 100,

    style: 'border: 1px solid blue;'
    // ...
});

Using CSS:

Ext.Viewport.add({
    centered: true,
    width: 100,
    height: 100,

    cls: 'my-component'
    // ...
});

And your CSS file:

.my-component {
    border: 1px solid red;
}

Defaults to:

null

getBorder : Boolean

Returns the value of border

Returns

Boolean

setBorder (border)

Sets the value of border

Parameters

border :  Boolean

bottom : Number / String
bindable bind

The absolute bottom position of this Component; must be a valid CSS length value, e.g: 300, 100px, 30%, etc. Explicitly setting this value will make this Component become 'positioned', which means it will no longer participate in the layout of the Container that it resides in.

Defaults to:

null

getBottom : Number / String

Returns the value of bottom

Returns

Number / String

setBottom (bottom)

Sets the value of bottom

Parameters

bottom :  Number / String

caseSensitive : Boolean
bindable bind

  • Only valid when queryMode is 'local'.* Configure as true to cause the primaryFilter to match with exact case matching.

Defaults to:

false

getCaseSensitive : Boolean

Returns the value of caseSensitive

Returns

Boolean

setCaseSensitive (caseSensitive)

Sets the value of caseSensitive

Parameters

caseSensitive :  Boolean

centered : Boolean
bindable bind

Configure this as true to have this Component centered within its Container. Setting this value to true will make this Component become 'positioned', which means it will no longer participate in the layout of the Container that it resides in.

Defaults to:

false

getCentered : Boolean

Returns the value of centered

Returns

Boolean

setCentered (centered)

Sets the value of centered

Parameters

centered :  Boolean

clearable : Boolean
bindable bind

true to show a clear trigger in this field when it has a non-empty value

Defaults to:

true

getClearable : Boolean

Returns the value of clearable

Returns

Boolean

setClearable (clearable)

Sets the value of clearable

Parameters

clearable :  Boolean

cls : String / String[]
bindable bind

The CSS class to add to this widget's element, in addition to the baseCls. In many cases, this property will be specified by the derived widget class. See userCls for adding additional CSS classes to widget instances (such as items in a Ext.Container).

Defaults to:

null

getCls : String / String[]

Returns the value of cls

Returns

String / String[]

setCls (cls)

Sets the value of cls

Parameters

cls :  String / String[]

constrainAlign : String / Ext.util.Region / Ext.dom.Element
bindable bind

A specification of the constraint to apply when showBy or alignTo is called to align a floated or positioned component.

Defaults to the parent container for positioned components (components which have their top, right, bottom or left set to move them out of their container's layout flow).

Defaults to the viewport for floated components.

May be a Ext.ComponentQuery selector to find an ancestor component to constrain within.

May be false to specify that constraining is not applied.

You may also specify an element, or a Ext.util.Region

Defaults to:

null

setConstrainAlign (constrainAlign)

Sets the value of constrainAlign

Parameters

constrainAlign :  String / Ext.util.Region / Ext.dom.Element

contentEl : Ext.dom.Element / HTMLElement / String
bindable bind

The configured element will automatically be added as the content of this component. When you pass a string, we expect it to be an element id. If the content element is hidden, we will automatically show it.

Defaults to:

null

getContentEl : Ext.dom.Element / HTMLElement / String

Returns the value of contentEl

Returns

Ext.dom.Element / HTMLElement / String

setContentEl (contentEl)

Sets the value of contentEl

Parameters

contentEl :  Ext.dom.Element / HTMLElement / String

controller : String / Object / Ext.app.ViewController
bindable bind

A string alias, a configuration object or an instance of a ViewController for this container. Sample usage:

Ext.define('MyApp.UserController', {
    alias: 'controller.user'
});

Ext.define('UserContainer', {
    extend: 'Ext.container.container',
    controller: 'user'
});
// Or
Ext.define('UserContainer', {
    extend: 'Ext.container.container',
    controller: {
        type: 'user',
        someConfig: true
    }
});

// Can also instance at runtime
var ctrl = new MyApp.UserController();
var view = new UserContainer({
    controller: ctrl
});

Defaults to:

null

getController Ext.app.ViewController

Returns the Ext.app.ViewController instance associated with this component via the controller config or setController method.

Returns

:Ext.app.ViewController

Returns this component's ViewController or null if one was not configured

setController (controller)

Sets the value of controller

Parameters

controller :  String / Object / Ext.app.ViewController

data : Object
bindable bind

The initial set of data to apply to the tpl to update the content area of the Component.

Note: Data will be appended to any existing data.

Defaults to:

null

getData : Object

Returns the value of data

Returns

Object

setData (data)

Sets the value of data

Parameters

data :  Object

defaultListenerScope : Boolean
bindable bind

If true, this component will be the default scope (this pointer) for events specified with string names so that the scope can be dynamically resolved. The component will automatically become the defaultListenerScope if a controller is specified.

See the introductory docs for Ext.container.Container for some sample usages.

NOTE: This value can only be reliably set at construction time. Setting it after that time may not correctly rewire all of the potentially effected listeners.

Defaults to:

false

getDefaultListenerScope : Boolean

Returns the value of defaultListenerScope

Returns

Boolean

setDefaultListenerScope (defaultListenerScope)

Sets the value of defaultListenerScope

Parameters

defaultListenerScope :  Boolean

disabled : Boolean
bindable bind

true to disable the field.

Be aware that conformant with the HTML specification, disabled Fields will not be submitted.

Defaults to:

false

getDisabled : Boolean

Returns the value of disabled

Returns

Boolean

setDisabled (disabled)

Sets the value of disabled

Parameters

disabled :  Boolean

displayed : Boolean
bindable bind

Set to true to call show and false to call hide. Unlike the hidden config, changing this config will potentially involve animations to show or hide the component.

Defaults to:

null

Available since: 6.5.0

getDisplayed : Boolean

Returns the value of displayed

Returns

Boolean

setDisplayed (displayed)

Sets the value of displayed

Parameters

displayed :  Boolean

displayField : String / Number
bindable bind

The underlying data value name to bind to this Select control. If configured as null, the valueField is used.

This resolved value is the visibly rendered value of the available selection options.

Defaults to:

'text'

getDisplayField : String / Number

Returns the value of displayField

Returns

String / Number

setDisplayField (displayField)

Sets the value of displayField

Parameters

displayField :  String / Number

displayTpl : String / String[] / Ext.XTemplate
bindable bind

The template to be used to display the selected record inside the text field.

If not specified, the displayField is shown in the text field.

Defaults to:

null

getDisplayTpl : String / String[] / Ext.XTemplate

Returns the value of displayTpl

Returns

String / String[] / Ext.XTemplate

setDisplayTpl (displayTpl)

Sets the value of displayTpl

Parameters

displayTpl :  String / String[] / Ext.XTemplate

docked : String
bindable bind

The dock position of this component in its container. Can be left, top, right or bottom.

Notes

You must use a HTML5 doctype for docked bottom to work. To do this, simply add the following code to the HTML file:

<!doctype html>

So your index.html file should look a little like this:

<!doctype html>
<html>
    <head>
        <title>MY application title</title>
        ...

Defaults to:

null

getDocked : String

Returns the value of docked

Returns

String

setDocked (docked)

Sets the value of docked

Parameters

docked :  String

draggable : Boolean / Object / Ext.drag.Source
bindable bind

Set to true to allow this component to be dragged. This can also be the config object for the Ext.drag.Source that will manage the drag.

Defaults to:

null

getDraggable : Boolean / Object / Ext.drag.Source

Returns the value of draggable

Returns

Boolean / Object / Ext.drag.Source

setDraggable (draggable)

Sets the value of draggable

Parameters

draggable :  Boolean / Object / Ext.drag.Source

edgePicker
bindable bind

A configuration object, containing an cfg#xtype property which specifies the widget to create if picker: 'edge' (or if it's 'auto' and the app is on a phone) Replaces defaultPhonePicker

Defaults to:

{
    xtype: 'picker',
    cover: true
}

getEdgePicker

Returns the value of edgePicker

Returns

setEdgePicker (edgePicker)

Sets the value of edgePicker

Parameters

edgePicker :  Object

editable : Boolean
bindable bind

Configure as false to prevent the user from typing text directly into the field; the field can only have its value set programmatically or via an action invoked by a trigger.

Contrast with readOnly which disables all mutation via the UI.

Defaults to:

true

getEditable : Boolean

Returns the value of editable

Returns

Boolean

setEditable (editable)

Sets the value of editable

Parameters

editable :  Boolean

enableRegEx : Boolean
bindable bind

When queryMode is 'local' only

Set to true to have the ComboBox use the typed value as a RegExp source to filter the store to get possible matches. Invalid regex values will be ignored.

Defaults to:

null

getEnableRegEx : Boolean

Returns the value of enableRegEx

Returns

Boolean

setEnableRegEx (enableRegEx)

Sets the value of enableRegEx

Parameters

enableRegEx :  Boolean

enterAnimation : String / Mixed
deprecated dep bindable bind

Animation effect to apply when the Component is being shown. Typically you want to use an inbound animation type such as 'fadeIn' or 'slideIn'.

Defaults to:

null

Deprecated since version 2.0.0
Please use showAnimation instead.

getEnterAnimation : String / Mixed

Returns the value of enterAnimation

Returns

String / Mixed

setEnterAnimation (enterAnimation)

Sets the value of enterAnimation

Parameters

enterAnimation :  String / Mixed

error : String / String[]
bindable bind

The error (or errors) to display for this field. This config is typically set by the field's validators but can be set directly if an error needs to be associated with a field manually.

Errors will be HTML encoded as necessary and errorTpl before becoming the current errorMessage.

Defaults to:

null

Available since: 6.5.0

getError : String / String[]

Returns the value of error

Returns

String / String[]

setError (error)

Sets the value of error

Parameters

error :  String / String[]

errorMessage : String
bindable bind

The field's error message to display as errorTarget. This message must already be properly formatted and encoded as appropriate for the errorTarget.

Defaults to:

null

Available since: 6.5.0

getErrorMessage : String

Returns the value of errorMessage

Returns

String

setErrorMessage (errorMessage)

Sets the value of errorMessage

Parameters

errorMessage :  String

errorTarget : String
bindable bind

The location where the error message text should display.

The following are values that have predefined meaning:

  • qtip Display a Ext.tip.Manager containing the message when the user hovers (or taps) the field. For this option to work, quick tips must be enabled by calling Ext.tip.Manager#init.
  • side Add an error icon to the right of the field, displaying the message in a popup on hover or tap.
  • title Display the message in a default browser title attribute.
  • under Add a div beneath the field containing the error message.

Defaults to:

'qtip'

Available since: 6.5.0

getErrorTarget : String

Returns the value of errorTarget

Returns

String

setErrorTarget (errorTarget)

Sets the value of errorTarget

Parameters

errorTarget :  String

errorTip : Object
bindable bind

The default config that will be used to display errors in the tooltip.

Defaults to:

null

Available since: 6.5.0

getErrorTip : Object

Returns the value of errorTip

Returns

Object

setErrorTip (errorTip)

Sets the value of errorTip

Parameters

errorTip :  Object

errorTpl : String / String[] / Ext.XTemplate
bindable bind

The template used to format the error set for this field. By default, the errorTarget is used to determine whether the error(s) are formatted as an HTML list or as plain text.

Defaults to:

null

Available since: 6.5.0

getErrorTpl : String / String[] / Ext.XTemplate

Returns the value of errorTpl

Returns

String / String[] / Ext.XTemplate

setErrorTpl (errorTpl)

Sets the value of errorTpl

Parameters

errorTpl :  String / String[] / Ext.XTemplate

eventHandlers : Object
deprecated dep bindable bind private pri

A map of event type to the corresponding handler method name. This is used internally by native event handling mechanism.

Defaults to:

{
    focus: 'handleFocusEvent',
    blur: 'handleBlurEvent'
}

Deprecated since version 6.6.0
Inline event handlers are deprecated

getEventHandlers : Object

Returns the value of eventHandlers

Returns

Object

setEventHandlers (eventHandlers)

Sets the value of eventHandlers

Parameters

eventHandlers :  Object

exitAnimation : String / Mixed
deprecated dep bindable bind

Animation effect to apply when the Component is being hidden.

Defaults to:

null

Deprecated since version 2.0.0
Please use hideAnimation instead. Typically you want to use an outbound animation type such as 'fadeOut' or 'slideOut'.

getExitAnimation : String / Mixed

Returns the value of exitAnimation

Returns

String / Mixed

setExitAnimation (exitAnimation)

Sets the value of exitAnimation

Parameters

exitAnimation :  String / Mixed

flex : Number / String / Object
bindable bind

The flex of this item if this item item is inside a Ext.layout.HBox or Ext.layout.VBox layout.

You can also update the flex of a component dynamically using the Ext.layout.FlexBox#setItemFlex method.

When supplied as a string or number this option supports the same syntax as CSS flex. For example:

flex: '1 2 auto'

sets flex-grow property to 0, flex-shrink to 2 and flex-basis to 'auto'.

The default flex-shrink value for box layout items is set to 0 in the stylesheet, which is different from the browser's default flex-shrink value of 1. This accommodates the majority use case for applications since where non-flexed components are typically not expected to shrink smaller than their default size.

For convenience when only a single number is supplied it is used as the value for both flex-grow and flex-shrink, for example flex: 3 is the same as flex: '3 3'

An object form is also accepted:

flex: {
    grow: 1,
    shrink: 2,
    basis: 'auto'
}

When the object form is supplied shrink always defaults to 0 regardless of the value of grow.

Although 'auto' is the default value for flex-basis, flex-basis defaults to 0% when flex is supplied as a single numeric or string value (e.g. flex: 1). If this behavior is not desired either explicitly set flex-basis to 'auto' or use the object form to set only grow and/or shrink:

flex: {
    grow: 2
}

Defaults to:

null

getFlex : Number / String / Object

Returns the value of flex

Returns

Number / String / Object

setFlex (flex)

Sets the value of flex

Parameters

flex :  Number / String / Object

floated : Boolean
bindable bind

A Component may be floated above all other components in the application. This means that the component is absolutely positioned, and will move to the front and occlude other sibling floated component if clicked.

A Floated component may have floated descendants. It will bring these decendants to the front with it when brought to the front of its sibling floated components.

By default, descendant floated components are all positioned using the viewport coordinate system. To make a floating component a positioning parent for descendants, and have the ancestors positioned relatively, configure the parent floated component with cfg-relative: true.

Defaults to:

false

Available since: 6.2.0

getFloated : Boolean

Returns the value of floated

Returns

Boolean

setFloated (floated)

Sets the value of floated

Parameters

floated :  Boolean

floatedPicker
bindable bind

A configuration object, containing an cfg#xtype property which specifies the widget to create if picker: 'floated' (or if it's 'auto' and the app is not on a phone) Replaces defaultTabletPicker

Defaults to:

{
    xtype: 'boundlist',
    infinite: false,
    // BoundListNavigationModel binds to input field
    // Must only be enabled when list is visible
    navigationModel: {
        disabled: true
    },
    scrollToTopOnRefresh: false,
    loadingHeight: 70,
    maxHeight: 300,
    floated: true,
    axisLock: true,
    hideAnimation: null
}

getFloatedPicker

Returns the value of floatedPicker

Returns

setFloatedPicker (floatedPicker)

Sets the value of floatedPicker

Parameters

floatedPicker :  Object

floatedPickerAlign : String
bindable bind

*Only valud when the floatedPicker is used. The showBy alignment string to use when showing the floated picker by the input field.

Defaults to:

tl-bl?

getFloatedPickerAlign : String

Returns the value of floatedPickerAlign

Returns

String

setFloatedPickerAlign (floatedPickerAlign)

Sets the value of floatedPickerAlign

Parameters

floatedPickerAlign :  String

focusCls : String

CSS class that will be added to focused component's focusClsEl, and removed when component blurs.

Defaults to:

'x-focused'

focusTrap
bindable bind private pri

Defaults to:

{
    tabIndex: -1,
    cls: 'x-hidden-clip'
}

getFocusTrap

Returns the value of focusTrap

Returns

setFocusTrap (focusTrap)

Sets the value of focusTrap

Parameters

focusTrap :  Object

forceSelection : Boolean
bindable bind

Set to true to restrict the selected value to one of the values in the list, or false to allow the user to set arbitrary text into the field.

Defaults to:

false

getForceSelection : Boolean

Returns the value of forceSelection

Returns

Boolean

setForceSelection (forceSelection)

Sets the value of forceSelection

Parameters

forceSelection :  Boolean

height : Number / String
bindable bind

The height of this Component; must be a valid CSS length value, e.g: 300, 100px, 30%, etc. By default, if this is not explicitly set, this Component's element will simply have its own natural size. If set to auto, it will set the width to null meaning it will have its own natural size.

Defaults to:

null

getHeight : Number / String

Returns the value of height

Returns

Number / String

setHeight (height)

Sets the value of height

Parameters

height :  Number / String

hidden : Boolean
bindable bind

Whether or not this Component is hidden (its CSS display property is set to none).

Defaults to true for floated Components.

Defaults to:

null

getHidden : Boolean

Returns the value of hidden

Returns

Boolean

setHidden (hidden)

Sets the value of hidden

Parameters

hidden :  Boolean

hiddenName : String
bindable bind

Specify a hiddenName if you're using the Ext.form.Panel#standardSubmit option. This name will be used to post the underlying value of the select to the server.

Defaults to:

null

getHiddenName : String

Returns the value of hiddenName

Returns

String

setHiddenName (hiddenName)

Sets the value of hiddenName

Parameters

hiddenName :  String

hideAnimation : String / Mixed
bindable bind

Animation effect to apply when the Component is being hidden. Typically you want to use an outbound animation type such as 'fadeOut' or 'slideOut'. For more animations, check the Ext.fx.Animation#type config.

Defaults to:

null

getHideAnimation : String / Mixed

Returns the value of hideAnimation

Returns

String / Mixed

setHideAnimation (hideAnimation)

Sets the value of hideAnimation

Parameters

hideAnimation :  String / Mixed

hideMode : 'clip' / 'display' / 'offsets' / 'opacity' / 'visibility'
bindable bind

A String which specifies how this component's DOM element will be hidden. The accepted values are any of these:

Hiding using display results in having no dimensions as well as resetting scroll positions to 0.

The other modes overcome this but may have different trade-offs in certain circumstances.

Defaults to:

'display'

Available since: 6.5.0

getHideMode : 'clip' / 'display' / 'offsets' / 'opacity' / 'visibility'

Returns the value of hideMode

Returns

'clip' / 'display' / 'offsets' / 'opacity' / 'visibility'

setHideMode (hideMode)

Sets the value of hideMode

Parameters

hideMode :  'clip' / 'display' / 'offsets' / 'opacity' / 'visibility'

hideOnMaskTap : Boolean
bindable bind

When using a modal Component, setting this to true will hide the modal mask and the Container when the mask is tapped on.

Defaults to:

null

getHideOnMaskTap : Boolean

Returns the value of hideOnMaskTap

Returns

Boolean

setHideOnMaskTap (hideOnMaskTap)

Sets the value of hideOnMaskTap

Parameters

hideOnMaskTap :  Boolean

hideTrigger : Boolean
bindable bind

true to hide the expand trigger.

Defaults to:

false

getHideTrigger : Boolean

Returns the value of hideTrigger

Returns

Boolean

setHideTrigger (hideTrigger)

Sets the value of hideTrigger

Parameters

hideTrigger :  Boolean

html : String / Ext.dom.Element / HTMLElement
bindable bind

Optional HTML content to render inside this Component, or a reference to an existing element on the page.

Defaults to:

null

getHtml : String / Ext.dom.Element / HTMLElement

Returns the value of html

Returns

String / Ext.dom.Element / HTMLElement

setHtml (html)

Sets the value of html

Parameters

html :  String / Ext.dom.Element / HTMLElement

id : String

The unique id of this component instance.

It should not be necessary to use this configuration except for singleton objects in your application. Components created with an id may be accessed globally using Ext.getCmp.

Instead of using assigned ids, use the itemId config, and Ext.ComponentQuery which provides selector-based searching for Sencha Components analogous to DOM querying. The Ext.Container class contains shortcut methods to query its descendant Components by selector.

Note that this id will also be used as the element id for the containing HTML element that is rendered to the page for this component. This allows you to write id-based CSS rules to style the specific instance of this component uniquely, and also to select sub-elements using this component's id as the parent.

Note: to avoid complications imposed by a unique id also see itemId.

Defaults to an auto-assigned id.

getId String

Retrieves the id of this component. Will autogenerate an id if one has not already been set.

Returns

:String

id

inline : Boolean
bindable bind

true to cause this field to layout with inline element behavior. An inline field's width is determined by the total width of its label and body elements instead of automatically expanding to fill the width of its container.

Defaults to:

false

getInline : Boolean

Returns the value of inline

Returns

Boolean

setInline (inline)

Sets the value of inline

Parameters

inline :  Boolean

inputCls : String
deprecated dep

Deprecated since version 6.5.0
There is no longer an input component to which to add a class.

inputMask : String / Ext.field.InputMask
bindable bind

Important: To use this config you must require Ext.field.InputMask or use a complete framework build. The logic to implement an inputMask is not automatically included in a build.

Defaults to:

null

Available since: 6.5.0

getInputMask : String / Ext.field.InputMask

Returns the value of inputMask

Returns

String / Ext.field.InputMask

setInputMask (inputMask)

Sets the value of inputMask

Parameters

inputMask :  String / Ext.field.InputMask

inputType : String
bindable bind

The type attribute for input fields -- e.g. text, password, date, url, email, etc.

Defaults to:

'text'

getInputType : String

Returns the value of inputType

Returns

String

setInputType (inputType)

Sets the value of inputType

Parameters

inputType :  String

inputValue
bindable bind private pri

Defaults to:

null

getInputValue

Returns the value of inputValue

Returns

setInputValue (inputValue)

Sets the value of inputValue

Parameters

inputValue :  Object

instanceCls : String / String[]
bindable bind private pri

An extra CSS class or classes to augment the classCls on an individual instance

Defaults to:

null

Available since: 6.5.0

getInstanceCls : String / String[]

Returns the value of instanceCls

Returns

String / String[]

setInstanceCls (instanceCls)

Sets the value of instanceCls

Parameters

instanceCls :  String / String[]

itemId : String
bindable bind

An itemId can be used as an alternative way to get a reference to a component when no object reference is available. Instead of using an id with Ext#getCmp, use itemId with Ext.Container#getComponent which will retrieve itemId's or id's. Since itemId's are an index to the container's internal MixedCollection, the itemId is scoped locally to the container - avoiding potential conflicts with Ext.ComponentManager which requires a unique id.

Also see id, Ext.Container#query, Ext.Container#down and Ext.Container#child.

Defaults to:

undefined

getItemId : String

Returns the value of itemId

Returns

String

setItemId (itemId)

Sets the value of itemId

Parameters

itemId :  String

itemTpl : String / Ext.XTemplate
bindable bind

An XTemplate definition string (Or an Ext.XTemplate) which specifies how to display a list item from a record values object. This is automatically generated to display the displayField if not specified.

Defaults to:

false

getItemTpl : String / Ext.XTemplate

Returns the value of itemTpl

Returns

String / Ext.XTemplate

setItemTpl (itemTpl)

Sets the value of itemTpl

Parameters

itemTpl :  String / Ext.XTemplate

keyMap : Object
bindable bind

An object containing handlers for keyboard events. The property names of this object are the key name and any modifiers. The values of the properties are the descriptors of how to handle each event.

The handler descriptor can be simply the handler function (either the literal function or the method name), or it can be an object with these properties:

  • handler: The function or its name to call to handle the event.
  • scope: The this pointer context (can be "this" or "controller").
  • event: An optional override of the key event to which to listen.

Important: Calls to setKeyMap do not replace the entire keyMap but instead update the provided mappings. That is, unless null is passed as the value of the keyMap which will clear the keyMap of all entries.

Defaults to:

null

Properties

scope : String

The default scope to apply to key handlers which do not specify a scope. This is processed the same way as the scope of cfg-listeners. It defaults to the "controller", but using 'this' means that an instance method will be used.

getKeyMap : Object

Returns the value of keyMap

Returns

Object

setKeyMap (keyMap)

Sets the value of keyMap

Parameters

keyMap :  Object

keyMapEnabled : Boolean
bindable bind

Enables or disables processing keys in the keyMap. This value starts as null and if it is null when initKeyMap is called, it will automatically be set to true. Since initKeyMap is called by Ext.Component at the proper time, this is not something application code normally handles.

Defaults to:

null

getKeyMapEnabled : Boolean

Returns the value of keyMapEnabled

Returns

Boolean

setKeyMapEnabled (keyMapEnabled)

Sets the value of keyMapEnabled

Parameters

keyMapEnabled :  Boolean

keyMapTarget : String
protected pro

The name of the member that should be used to listen for keydown/keypress events. This is intended to be controlled at the class level not per instance.

Defaults to:

'el'

label : String
bindable bind

The label of this field

Defaults to:

null

getLabel : String

Returns the value of label

Returns

String

setLabel (label)

Sets the value of label

Parameters

label :  String

labelAlign : 'top' / 'left' / 'bottom' / 'right'
bindable bind

When value is 'placeholder', the label text will be rendered as placeholder text inside the empty input and will animated to "top" alignment when the input is focused or contains text. The position to render the label relative to the field body.

Defaults to:

'left'

getLabelAlign : 'top' / 'left' / 'bottom' / 'right'

Returns the value of labelAlign

Returns

'top' / 'left' / 'bottom' / 'right'

setLabelAlign (labelAlign)

Sets the value of labelAlign

Parameters

labelAlign :  'top' / 'left' / 'bottom' / 'right'

labelCls : String
bindable bind

Optional CSS class to add to the Label element.

Defaults to:

null

getLabelCls : String

Returns the value of labelCls

Returns

String

setLabelCls (labelCls)

Sets the value of labelCls

Parameters

labelCls :  String

labelInPlaceholder
bindable bind private pri

Defaults to:

true

getLabelInPlaceholder

Returns the value of labelInPlaceholder

Returns

setLabelInPlaceholder (labelInPlaceholder)

Sets the value of labelInPlaceholder

Parameters

labelInPlaceholder :  Object

labelMinWidth : Number / String
bindable bind

Min-width of this field's label.

Defaults to:

null

getLabelMinWidth : Number / String

Returns the value of labelMinWidth

Returns

Number / String

setLabelMinWidth (labelMinWidth)

Sets the value of labelMinWidth

Parameters

labelMinWidth :  Number / String

labelTextAlign : 'top' / 'right' / 'bottom' / 'left'
bindable bind

Text alignment of this field's label

Defaults to:

'left'

getLabelTextAlign : 'top' / 'right' / 'bottom' / 'left'

Returns the value of labelTextAlign

Returns

'top' / 'right' / 'bottom' / 'left'

setLabelTextAlign (labelTextAlign)

Sets the value of labelTextAlign

Parameters

labelTextAlign :  'top' / 'right' / 'bottom' / 'left'

labelWidth : Number / String
bindable bind

Width of this field's label. Can be a number of pixels or any valid CSS value, such as '30%'. To size the label to its text, use labelWidth: 'auto'

Defaults to:

null

getLabelWidth : Number / String

Returns the value of labelWidth

Returns

Number / String

setLabelWidth (labelWidth)

Sets the value of labelWidth

Parameters

labelWidth :  Number / String

labelWrap : Boolean
bindable bind

true to allow the label to wrap. If set to false, the label will be truncated with an ellipsis.

Defaults to:

false

getLabelWrap : Boolean

Returns the value of labelWrap

Returns

Boolean

setLabelWrap (labelWrap)

Sets the value of labelWrap

Parameters

labelWrap :  Boolean

left : Number / String
bindable bind

The absolute left position of this Component; must be a valid CSS length value, e.g: 300, 100px, 30%, etc. Explicitly setting this value will make this Component become 'positioned', which means it will no longer participate in the layout of the Container that it resides in.

Defaults to:

null

getLeft : Number / String

Returns the value of left

Returns

Number / String

setLeft (left)

Sets the value of left

Parameters

left :  Number / String

listeners : Object
bindable bind

A config object containing one or more event handlers to be added to this object during initialization. This should be a valid listeners config object as specified in the addListener example for attaching multiple handlers at once.

DOM events from Ext JS Ext.Component

While some Ext JS Component classes export selected DOM events (e.g. "click", "mouseover" etc), this is usually only done when extra value can be added. For example the DataView's itemclick event passing the node clicked on. To access DOM events directly from a child element of a Component, we need to specify the element option to identify the Component property to add a DOM listener to:

new Ext.panel.Panel({
    width: 400,
    height: 200,
    dockedItems: [{
        xtype: 'toolbar'
    }],
    listeners: {
        click: {
            element: 'el', //bind to the underlying el property on the panel
            fn: function(){ console.log('click el'); }
        },
        dblclick: {
            element: 'body', //bind to the underlying body property on the panel
            fn: function(){ console.log('dblclick body'); }
        }
    }
});

setListeners ( listeners )

An alias for addListener. In versions prior to 5.1, listeners had a generated setter which could be called to add listeners. In 5.1 the listeners config is not processed using the config system and has no generated setter, so this method is provided for backward compatibility. The preferred way of adding listeners is to use the on method.

Parameters

listeners :  Object

The listeners

margin : Number / String
bindable bind

The margin to use on this Component. Can be specified as a number (in which case all edges get the same margin) or a CSS string like '5 10 10 10'

Defaults to:

null

getMargin : Number / String

Returns the value of margin

Returns

Number / String

setMargin (margin)

Sets the value of margin

Parameters

margin :  Number / String

matchFieldWidth : Boolean
bindable bind

*Only valid when the picker: 'floated' is used. Whether the floatedPicker's width should be explicitly set to match the width of the input element.

Defaults to:

true

getMatchFieldWidth : Boolean

Returns the value of matchFieldWidth

Returns

Boolean

setMatchFieldWidth (matchFieldWidth)

Sets the value of matchFieldWidth

Parameters

matchFieldWidth :  Boolean

maxHeight : Number / String
bindable bind

The maximum height of this Component; must be a valid CSS length value, e.g: 300, 100px, 30%, etc. If set to auto, it will set the width to null meaning it will have its own natural size. Note that this config will not apply if the Component is 'positioned' (absolutely positioned or centered)

Defaults to:

null

getMaxHeight : Number / String

Returns the value of maxHeight

Returns

Number / String

setMaxHeight (maxHeight)

Sets the value of maxHeight

Parameters

maxHeight :  Number / String

maxLength : Number
bindable bind

The maximum number of permitted input characters.

Defaults to:

null

getMaxLength : Number

Returns the value of maxLength

Returns

Number

setMaxLength (maxLength)

Sets the value of maxLength

Parameters

maxLength :  Number

maxWidth : Number / String
bindable bind

The maximum width of this Component; must be a valid CSS length value, e.g: 300, 100px, 30%, etc. If set to auto, it will set the width to null meaning it will have its own natural size. Note that this config will not apply if the Component is 'positioned' (absolutely positioned or centered)

Defaults to:

null

getMaxWidth : Number / String

Returns the value of maxWidth

Returns

Number / String

setMaxWidth (maxWidth)

Sets the value of maxWidth

Parameters

maxWidth :  Number / String

minChars : Number
bindable bind

The minimum number of characters the user must type before autocomplete and typeAhead activate.

Defaults to 4 if queryMode is 'remote' or 0 if queryMode is 'local', does not apply if editable is false.

Defaults to:

null

getMinChars : Number

Returns the value of minChars

Returns

Number

setMinChars (minChars)

Sets the value of minChars

Parameters

minChars :  Number

minHeight : Number / String
bindable bind

The minimum height of this Component; must be a valid CSS length value, e.g: 300, 100px, 30%, etc. If set to auto, it will set the width to null meaning it will have its own natural size.

Defaults to:

null

getMinHeight : Number / String

Returns the value of minHeight

Returns

Number / String

setMinHeight (minHeight)

Sets the value of minHeight

Parameters

minHeight :  Number / String

minWidth : Number / String
bindable bind

The minimum width of this Component; must be a valid CSS length value, e.g: 300, 100px, 30%, etc. If set to auto, it will set the width to null meaning it will have its own natural size.

Defaults to:

null

getMinWidth : Number / String

Returns the value of minWidth

Returns

Number / String

setMinWidth (minWidth)

Sets the value of minWidth

Parameters

minWidth :  Number / String

modal : Boolean
bindable bind

true to make this Component modal. This will create a mask underneath the Component that covers its parent and does not allow the user to interact with any other Components until this Component is dismissed.

Defaults to:

null

getModal : Boolean

Returns the value of modal

Returns

Boolean

setModal (modal)

Sets the value of modal

Parameters

modal :  Boolean

modelValidation : Boolean

This config enables binding to your Ext.data.Model#validators. This is only processed by form fields (e.g., Ext.field.*) at present, however, this setting is inherited and so can be set on a parent container.

When set to true by a component (or by an ancestor container), the validators of for any {@Ext.data.Model record} fields will be used wherever the value is bound to such data fields.

While this config can be set arbitrarily high in the component hierarchy, doing so can create a lot overhead if most of your form fields do not actually rely on validators in your data model.

Using this setting for a form that is bound to an Ext.data.Model might look like this:

 {
     xtype: 'panel',
     modelValidation: true,
     items: [{
         xtype: 'textfield',
         bind: '{theUser.firstName}'
     },{
         xtype: 'textfield',
         bind: '{theUser.lastName}'
     },{
         xtype: 'textfield',
         bind: '{theUser.phoneNumber}'
     },{
         xtype: 'textfield',
         bind: '{theUser.email}'
     }]
 }

Defaults to:

null

Available since: 6.5.0

name : String
bindable bind

The field's name. Used by form panels to gather data to be submitted.

For Ext.field.Input this name is set as the name attribute of the inputElement

Defaults to:

null

getName : String

Returns the value of name

Returns

String

setName (name)

Sets the value of name

Parameters

name :  String

nameable : Boolean

Set to true for this component's name property to be tracked by its containing nameHolder.

Defaults to:

false

options : Array
bindable bind

An array of select options.

[
    {text: 'First Option',  value: 'first'},
    {text: 'Second Option', value: 'second'},
    {text: 'Third Option',  value: 'third'}
]

Note: Option object member names should correspond with defined valueField and displayField values.

This config is mutually exclusive with the store config. Specifying them both is unssupported and will produce undefined behaviour.

Defaults to:

null

getOptions : Array

Returns the value of options

Returns

Array

setOptions (options)

Sets the value of options

Parameters

options :  Array

padding : Number / String
bindable bind

The padding to use on this Component. Can be specified as a number (in which case all edges get the same padding) or a CSS string like '5 10 10 10'

Defaults to:

null

getPadding : Number / String

Returns the value of padding

Returns

Number / String

setPadding (padding)

Sets the value of padding

Parameters

padding :  Number / String

parseValidator : Ext.data.validator.Validator
bindable bind private pri

Defaults to:

null

Available since: 6.5.1

setParseValidator (parseValidator)

Sets the value of parseValidator

Parameters

parseValidator :  Ext.data.validator.Validator

pattern : String
bindable bind

The value for the HTML5 pattern attribute. You can use this to change which keyboard layout will be used.

Ext.define('Ux.field.Pattern', {
    extend : 'Ext.field.Text',
    xtype  : 'patternfield',

    config : {
        component : {
            pattern : '[0-9]*'
        }
    }
});

Even though it extends Ext.field.Text, it will display the number keyboard.

Defaults to:

null

getPattern : String

Returns the value of pattern

Returns

String

setPattern (pattern)

Sets the value of pattern

Parameters

pattern :  String

picker : String / Object
bindable bind

A string representing the type of picker to use. Can be one of the following values.

  • 'edge' to use the edgePicker, generally used on small formfactor devices.
  • 'floated' to use the floatedPicker, generally used on tablets or desktops.
  • 'auto' to allow the framework to select the appropriate picker for the device.

Can also be a config object for the picker.

Defaults to:

'auto'

getPicker : String / Object

Returns the value of picker

Returns

String / Object

setPicker (picker)

Sets the value of picker

Parameters

picker :  String / Object

pickerSlotAlign : String
bindable bind private pri

The alignment of text in the picker created by this Select

Defaults to:

'center'

getPickerSlotAlign : String

Returns the value of pickerSlotAlign

Returns

String

setPickerSlotAlign (pickerSlotAlign)

Sets the value of pickerSlotAlign

Parameters

pickerSlotAlign :  String

placeholder : String
bindable bind

A string value displayed in the input when the control is empty.

Defaults to:

null

getPlaceholder : String

Returns the value of placeholder

Returns

String

setPlaceholder (placeholder)

Sets the value of placeholder

Parameters

placeholder :  String

placeHolder : String
deprecated dep

A string value displayed in the input when the control is empty.

Deprecated since version 6.5.0
Use the all lowercase placeholder config.

plugins : Array / Ext.enums.Plugin / Object / Ext.plugin.Abstract
bindable bind

This config describes one or more plugin config objects used to create plugin instances for this component.

Plugins are a way to bundle and reuse custom functionality. Plugins should extend Ext.plugin.Abstract but technically the only requirement for a valid plugin is that it contain an init method that accepts a reference to its owner. Once a plugin is created, the owner will call the init method, passing a reference to itself. Each plugin can then call methods or respond to events on its owner as needed to provide its functionality.

This config's value can take several different forms.

The value can be a single string with the plugin's Ext.enums.Plugin:

 var list = Ext.create({
     xtype: 'list',
     itemTpl: '<div class="item">{title}</div>',
     store: 'Items',

     plugins: 'listpaging'
 });

In the above examples, the string "listpaging" is the type alias for Ext.dataview.plugin.ListPaging. The full alias includes the "plugin." prefix (i.e., 'plugin.listpaging').

The preferred form for multiple plugins or to configure plugins is the keyed-object form (new in version 6.5):

 var list = Ext.create({
     xtype: 'list',
     itemTpl: '<div class="item">{title}</div>',
     store: 'Items',

     plugins: {
         pullrefresh: true,
         listpaging: {
             autoPaging: true,
             weight: 10
         }
     }
 });

The object keys are the id's as well as the default type alias. This form allows the value of the plugins to be merged from base class to derived class and finally with the instance configuration. This allows classes to define a set of plugins that derived classes or instantiators can further configure or disable. This merge behavior is a feature of the config.

The plugins config can also be an array of plugin aliases (arrays are not merged so this form does not respect plugins defined by the class author):

 var list = Ext.create({
     xtype: 'list',
     itemTpl: '<div class="item">{title}</div>',
     store: 'Items',

     plugins: ['listpaging', 'pullrefresh']
 });

An array can also contain elements that are config objects with a type property holding the type alias:

 var list = Ext.create({
     xtype: 'list',
     itemTpl: '<div class="item">{title}</div>',
     store: 'Items',

     plugins: ['pullrefresh', {
         type: 'listpaging',
         autoPaging: true
     }]
 });

Defaults to:

null

setPlugins (plugins)

Sets the value of plugins

Parameters

plugins :  Array / Ext.enums.Plugin / Object / Ext.plugin.Abstract

primaryFilter
bindable bind readonly ro private pri

The filter instance used to filter the store on input field mutation by typing or pasting.

This may be a filter config object which specifies a filter which uses the store's fields.

Ext.util.Filter may also be instantiated using a custom filterFn to allow a developer to specify complex matching. For example, a combobox developer might allow a user to filter using either the valueField or displayField by using:

primaryFilter: {
    filterFn: function(candidateRecord) {
        // This is a method on a Filter instance, we have this config
        var value = this.getValue();

        return Ext.String.startsWith(candidateRecord.get('stateName', value, true) ||
               Ext.String.startsWith(candidateRecord.get('abbreviation', value, true);
    }
}

Defaults to:

true

getPrimaryFilter

Returns the value of primaryFilter

Returns

setPrimaryFilter (primaryFilter)

Sets the value of primaryFilter

Parameters

primaryFilter :  Object

publishes : String / String[] / Object
bindable bind

One or more names of config properties that this component should publish to its ViewModel. Generally speaking, only properties defined in a class config block (including ancestor config blocks and mixins) are eligible for publishing to the viewModel. Some components override this and publish their most useful configs by default.

Note: We'll discuss publishing properties not found in the config block below.

Values determined to be invalid by component (often form fields and model validations) will not be published to the ViewModel.

This config uses the cfg-reference to determine the name of the data object to place in the ViewModel. If reference is not set then this config is ignored.

By using this config and cfg-reference you can bind configs between components. For example:

 ...
     items: [{
         xtype: 'textfield',
         reference: 'somefield',  // component's name in the ViewModel
         publishes: 'value' // value is not published by default
     },{
         ...
     },{
         xtype: 'displayfield',
         bind: 'You have entered "{somefield.value}"'
     }]
 ...

Classes must provide this config as an Object:

 Ext.define('App.foo.Bar', {
     publishes: {
         foo: true,
         bar: true
     }
 });

This is required for the config system to properly merge values from derived classes.

For instances this value can be specified as a value as show above or an array or object as follows:

 {
     xtype: 'textfield',
     reference: 'somefield',
     publishes: [
         'value',
         'rawValue',
         'dirty'
     ]
 }

 // This achieves the same result as the above array form.
 {
     xtype: 'textfield',
     reference: 'somefield',
     publishes: {
         value: true,
         rawValue: true,
         dirty: true
     }
 }

In some cases, users may want to publish a property to the viewModel that is not found in a class config block. In these situations, you may utilize publishState if the property has a setter method. Let's use setFieldLabel as an example:

  setFieldLabel: function(fieldLabel) {
      this.callParent(arguments);
      this.publishState('fieldLabel', fieldLabel);
  }

With the above chunk of code, fieldLabel may now be published to the viewModel.

Defaults to:

{
    selection: 1
}

getPublishes : String / String[] / Object

Returns the value of publishes

Returns

String / String[] / Object

setPublishes (publishes)

Sets the value of publishes

Parameters

publishes :  String / String[] / Object

queryCaching : Boolean
bindable bind

When true, this prevents the combo from re-querying (either locally or remotely) when the current query is the same as the previous query.

Defaults to:

true

getQueryCaching : Boolean

Returns the value of queryCaching

Returns

Boolean

setQueryCaching (queryCaching)

Sets the value of queryCaching

Parameters

queryCaching :  Boolean

queryDelay : Number
bindable bind

The length of time in milliseconds to delay between the start of typing and sending the query to filter the dropdown list.

Defaults to 500 if queryMode = 'remote' or 10 if queryMode = 'local'

Defaults to:

true

getQueryDelay : Number

Returns the value of queryDelay

Returns

Number

setQueryDelay (queryDelay)

Sets the value of queryDelay

Parameters

queryDelay :  Number

queryMode : String
bindable bind

The mode in which the ComboBox uses the configured Store. Acceptable values are:

  • 'local' : In this mode, the ComboBox assumes the store is fully loaded and will query it directly.

  • 'remote' : In this mode the ComboBox loads its Store dynamically based upon user interaction.

    This is typically used for "autocomplete" type inputs, and after the user finishes typing, the Store is loaded.

    A parameter containing the typed string is sent in the load request. The default parameter name for the input string is query, but this can be configured using the queryParam config.

    In queryMode: 'remote', the Store may be configured with remoteFilter: true, and further filters may be programatically added to the Store which are then passed with every load request which allows the server to further refine the returned dataset.

    Typically, in an autocomplete situation, hideTrigger is configured true because it has no meaning for autocomplete.

Defaults to:

'remote'

getQueryMode : String

Returns the value of queryMode

Returns

String

setQueryMode (queryMode)

Sets the value of queryMode

Parameters

queryMode :  String

queryParam : String
bindable bind

Name of the parameter used by the Store to pass the typed string when the ComboBox is configured with queryMode: 'remote'. If explicitly set to a falsy value it will not be sent.

Defaults to:

'query'

getQueryParam : String

Returns the value of queryParam

Returns

String

setQueryParam (queryParam)

Sets the value of queryParam

Parameters

queryParam :  String

readOnly : Boolean
bindable bind

true to set the field DOM element readonly attribute to "true".

Mutation of Ext.field.Text through triggers is also disabled.

To simply prevent typing into the field while still allowing mutation through triggers, set editable to false.

Defaults to:

false

getReadOnly : Boolean

Returns the value of readOnly

Returns

Boolean

setReadOnly (readOnly)

Sets the value of readOnly

Parameters

readOnly :  Boolean

record : Ext.data.Model
bindable bind

A model instance which updates the Component's html based on it's tpl. Similar to the data configuration, but tied to to a record to make allow dynamic updates. This must be a model instance and not a configuration of one.

Defaults to:

null

getRecord : Ext.data.Model

Returns the value of record

Returns

Ext.data.Model

setRecord (record)

Sets the value of record

Parameters

record :  Ext.data.Model

reference : String

Specifies a name for this component inside its component hierarchy. This name must be unique within its view or its Ext.app.ViewController. See the documentation in Ext.container.Container for more information about references.

Note: Valid identifiers start with a letter or underscore and are followed by zero or more additional letters, underscores or digits. References are case sensitive.

Defaults to:

null

relative : Boolean
bindable bind

Only valid when a component is cfg-floated

Configure this as true if you require descendant floated components to be positioned relative to this component's coordinate space, not the viewport's coordinate space.

Note: The coordinate space is this Component's encapsulating element's area. Not that of the inner element in which static child items are rendered by the layout.

Defaults to:

false

Available since: 6.2.0

getRelative : Boolean

Returns the value of relative

Returns

Boolean

setRelative (relative)

Sets the value of relative

Parameters

relative :  Boolean

renderTo : Ext.dom.Element
bindable bind

Optional element to render this Component to. Not required if this component is an item of a Container of a Container.

Defaults to:

null

getRenderTo : Ext.dom.Element

Returns the value of renderTo

Returns

Ext.dom.Element

setRenderTo (renderTo)

Sets the value of renderTo

Parameters

renderTo :  Ext.dom.Element

required : Boolean
bindable bind

true to make this field required.

Defaults to:

false

getRequired : Boolean

Returns the value of required

Returns

Boolean

setRequired (required)

Sets the value of required

Parameters

required :  Boolean

requiredMessage : String
bindable bind

The error message to display when required is true and the field's value is "empty" (null, undefined, or empty string).

Defaults to:

'This field is required'

getRequiredMessage : String

Returns the value of requiredMessage

Returns

String

setRequiredMessage (requiredMessage)

Sets the value of requiredMessage

Parameters

requiredMessage :  String

right : Number / String
bindable bind

The absolute right position of this Component; must be a valid CSS length value, e.g: 300, 100px, 30%, etc. Explicitly setting this value will make this Component become 'positioned', which means it will no longer participate in the layout of the Container that it resides in.

Defaults to:

null

getRight : Number / String

Returns the value of right

Returns

Number / String

setRight (right)

Sets the value of right

Parameters

right :  Number / String

ripple : Boolean / Object / String
bindable bind

Set to truthy, Color or Object value for the ripple.

Defaults to:

null

Available since: 6.5.0

Properties

color : String

The background color of the ripple.

position : Array

Position for the ripple to start at [x,y]. Determines if a Ripple effect should happen whenever this element is pressed.

For example: { ripple: true }

Or:

 {
     ripple: {
         color: 'red'
     }
 }

For complex components, individual elements can suppress ripples by adding the x-no-ripple class to disable rippling for a tree of elements.

getRipple : Boolean / Object / String

Returns the value of ripple

Returns

Boolean / Object / String

setRipple (ripple)

Sets the value of ripple

Parameters

ripple :  Boolean / Object / String

scrollable : Boolean / String / Object
bindable bind

Configuration options to make this Component scrollable. Acceptable values are:

  • true to enable auto scrolling.
  • false (or null) to disable scrolling - this is the default.
  • x or horizontal to enable horizontal scrolling only
  • y or vertical to enable vertical scrolling only

Also accepts a configuration object for a Ext.scroll.Scroller if if advanced configuration is needed.

The getter for this config returns the Ext.scroll.Scroller instance. You can use the Scroller API to read or manipulate the scroll position:

// scrolls the component to 5 on the x axis and 10 on the y axis
component.getScrollable().scrollTo(5, 10);

Defaults to:

null

getScrollable : Boolean / String / Object

Returns the value of scrollable

Returns

Boolean / String / Object

setScrollable (scrollable)

Sets the value of scrollable

Parameters

scrollable :  Boolean / String / Object

selection : Ext.data.Model
bindable bind

The selected model. null if no value exists.

Defaults to:

null

getSelection : Ext.data.Model

Returns the value of selection

Returns

Ext.data.Model

setSelection (selection)

Sets the value of selection

Parameters

selection :  Ext.data.Model

selectOnTab : Boolean
bindable bind

Whether the Tab key should select the currently highlighted item.

Defaults to:

true

getSelectOnTab : Boolean

Returns the value of selectOnTab

Returns

Boolean

setSelectOnTab (selectOnTab)

Sets the value of selectOnTab

Parameters

selectOnTab :  Boolean

selfAlign : String
bindable bind

Specifies the self alignment of this widget in a box layout

Defaults to:

null

getSelfAlign : String

Returns the value of selfAlign

Returns

String

setSelfAlign (selfAlign)

Sets the value of selfAlign

Parameters

selfAlign :  String

session : Boolean / Object / Ext.data.Session
bindable bind

If provided this creates a new Session instance for this component. If this is a Container, this will then be inherited by all child components.

To create a new session you can specify true:

 Ext.create({
     xtype: 'viewport',
     session: true,

     items: [{
         ...
     }]
 });

Alternatively, a config object can be provided:

 Ext.create({
     xtype: 'viewport',
     session: {
         ...
     },

     items: [{
         ...
     }]
 });

Defaults to:

null

getSession : Boolean / Object / Ext.data.Session

Returns the value of session

Returns

Boolean / Object / Ext.data.Session

setSession (session)

Sets the value of session

Parameters

session :  Boolean / Object / Ext.data.Session

shadow : Boolean
bindable bind

Configure as true for the component to have a drop shadow. 'false' will suppress any default shadow. By default the theme will determine the presence of a shadow.

Defaults to:

null

Available since: 6.2.0

getShadow : Boolean

Returns the value of shadow

Returns

Boolean

setShadow (shadow)

Sets the value of shadow

Parameters

shadow :  Boolean

shareableName : Boolean

Set to true to allow this component's name to be shared by other items in the same nameHolder. Such items will be returned in an array from lookupName.

Defaults to:

false

shim : Boolean
bindable bind

Only valid when a component is cfg-floated

Configure as true for the component to use an <iframe> as an underlay to ensure certain non-standard browser plugins are occluded by this component.

Defaults to:

false

Available since: 6.2.0

getShim : Boolean

Returns the value of shim

Returns

Boolean

setShim (shim)

Sets the value of shim

Parameters

shim :  Boolean

showAnimation : String / Mixed
bindable bind

Animation effect to apply when the Component is being shown. Typically you want to use an inbound animation type such as 'fadeIn' or 'slideIn'. For more animations, check the Ext.fx.Animation#type config.

Defaults to:

null

getShowAnimation : String / Mixed

Returns the value of showAnimation

Returns

String / Mixed

setShowAnimation (showAnimation)

Sets the value of showAnimation

Parameters

showAnimation :  String / Mixed

sideError : String
bindable bind private pri

Defaults to:

null

getSideError : String

Returns the value of sideError

Returns

String

setSideError (sideError)

Sets the value of sideError

Parameters

sideError :  String

store : Ext.data.Store / Object / String
bindable bind

The store to provide selection options data. Either a Store instance, configuration object or store ID.

Defaults to:

null

getStore : Ext.data.Store / Object / String

Returns the value of store

Returns

Ext.data.Store / Object / String

setStore (store)

Sets the value of store

Parameters

store :  Ext.data.Store / Object / String

style : String / Object
bindable bind

Additional CSS styles that will be rendered into an inline style attribute when the widget is rendered.

You can pass either a string syntax:

style: 'background:red'

Or by using an object:

style: {
    background: 'red'
}

When using the object syntax, you can define CSS Properties by using a string:

style: {
    'border-left': '1px solid red'
}

Although the object syntax is much easier to read, we suggest you to use the string syntax for better performance.

Defaults to:

null

setStyle (style)

Sets the value of style

Parameters

style :  String / Object

tabIndex : Number
bindable bind

DOM tabIndex attribute for this component's focusEl.

Defaults to:

null

getTabIndex Number

Return the actual tabIndex for this Focusable.

Returns

:Number

tabIndex attribute value

setTabIndex ( newTabIndex )

Set the tabIndex property for this Focusable. If the focusEl is available, set tabIndex attribute on it, too.

Parameters

newTabIndex :  Number

new tabIndex to set

textAlign : 'left' / 'center' / 'right'
bindable bind

The text alignment of this field.

Defaults to:

'left'

getTextAlign : 'left' / 'center' / 'right'

Returns the value of textAlign

Returns

'left' / 'center' / 'right'

setTextAlign (textAlign)

Sets the value of textAlign

Parameters

textAlign :  'left' / 'center' / 'right'

tipError : String
bindable bind private pri

Defaults to:

null

getTipError : String

Returns the value of tipError

Returns

String

setTipError (tipError)

Sets the value of tipError

Parameters

tipError :  String

titleError : String
bindable bind private pri

Defaults to:

null

getTitleError : String

Returns the value of titleError

Returns

String

setTitleError (titleError)

Sets the value of titleError

Parameters

titleError :  String

toFrontOnShow : Boolean
bindable bind

True to automatically call toFront when a cfg-floated Component is shown.

Defaults to:

true

getToFrontOnShow : Boolean

Returns the value of toFrontOnShow

Returns

Boolean

setToFrontOnShow (toFrontOnShow)

Sets the value of toFrontOnShow

Parameters

toFrontOnShow :  Boolean

tooltip : String / Object
bindable bind

The tooltip for this component - can be a string to be used as innerHTML (html tags are accepted) or Ext.tip.ToolTip config object.

The default behavior is to use a shared tip instance. The tooltip configuration is registered with the Ext.tip.Manager. To enable this, your application can set the Ext.app.Application#quickTips config, or an instance of the Ext.tip.Manager may be created manually.

To force a unique tooltip instance to be created, specify autoCreate: true on this configuration.

Configuring this with autoHide: false implies autoCreate: true so that the desired persistent behavior can be obtained with other targets still showing the singleton instance.

Defaults to:

null

getTooltip : String / Object

Returns the value of tooltip

Returns

String / Object

setTooltip (tooltip)

Sets the value of tooltip

Parameters

tooltip :  String / Object

top : Number / String
bindable bind

The absolute top position of this Component; must be a valid CSS length value, e.g: 300, 100px, 30%, etc. Explicitly setting this value will make this Component become 'positioned', which means it will no longer participate in the layout of the Container that it resides in.

Defaults to:

null

getTop : Number / String

Returns the value of top

Returns

Number / String

setTop (top)

Sets the value of top

Parameters

top :  Number / String

touchAction : Object
bindable bind

Emulates the behavior of the CSS touch-action property in a cross-browser compatible manner.

Keys in this object are touch action names, and values are false to disable a touch action or true to enable it. Accepted keys are:

  • panX
  • panY
  • pinchZoom
  • doubleTapZoom

All touch actions are enabled (true) by default, so it is usually only necessary to specify which touch actions to disable. For example, the following disables only horizontal scrolling and pinch-to-zoom on the component's main element:

touchAction: {
    panX: false,
    pinchZoom: false
}

Touch actions can be specified on reference elements using the reference element name, for example:

// disables horizontal scrolling on the main element, and double-tap-zoom
// on the child element named "body"
touchAction: {
    panY: false
    body: {
        doubleTapZoom: false
    }
}

The primary motivation for setting the touch-action of an element is to prevent the browser's default handling of a gesture such as pinch-to-zoom, or drag-to-scroll, so that the application can implement its own handling of that gesture on the element. Suppose, for example, a component has a custom drag handler on its element and wishes to prevent horizontal scrolling of its container while it is being dragged:

Ext.create('Ext.Widget', {
    touchAction: {
        panX: false
    },
    listeners: {
        drag: function(e) {
            // implement drag logic
        }
    }
});

Defaults to:

null

getTouchAction : Object

Returns the value of touchAction

Returns

Object

setTouchAction (touchAction)

Sets the value of touchAction

Parameters

touchAction :  Object

tpl : String / String[] / Ext.Template / Ext.XTemplate[]
bindable bind

A String, Ext.Template, Ext.XTemplate or an Array of strings to form an Ext.XTemplate. Used in conjunction with the data and tplWriteMode configurations.

Note The data configuration must be set for any content to be shown in the component when using this configuration.

Defaults to:

null

setTpl (tpl)

Sets the value of tpl

Parameters

tpl :  String / String[] / Ext.Template / Ext.XTemplate[]

tplWriteMode : String
bindable bind

The Ext.(X)Template method to use when updating the content area of the Component.

Valid modes are:

  • append
  • insertAfter
  • insertBefore
  • insertFirst
  • overwrite

Defaults to:

'overwrite'

getTplWriteMode : String

Returns the value of tplWriteMode

Returns

String

setTplWriteMode (tplWriteMode)

Sets the value of tplWriteMode

Parameters

tplWriteMode :  String

translatable : Object
bindable bind private pri

Defaults to:

null

getTranslatable : Object

Returns the value of translatable

Returns

Object

setTranslatable (translatable)

Sets the value of translatable

Parameters

translatable :  Object

triggerAction : String
bindable bind

The action to execute when the trigger is clicked.

See also queryParam.

Defaults to:

'all'

getTriggerAction : String

Returns the value of triggerAction

Returns

String

setTriggerAction (triggerAction)

Sets the value of triggerAction

Parameters

triggerAction :  String

triggers : Object
bindable bind

Ext.field.trigger.Trigger to use in this field. The keys in this object are unique identifiers for the triggers. The values in this object are Ext.field.trigger.Trigger configuration objects.

Ext.create('Ext.field.Text', {
    label: 'My Custom Field',
    triggers: {
        foo: {
            cls: 'my-foo-trigger',
            handler: function() {
                console.log('foo trigger clicked');
            }
        },
        bar: {
            cls: 'my-bar-trigger',
            handler: function() {
                console.log('bar trigger clicked');
            }
        }
    }
});

The weight value may be a negative value in order to position custom triggers ahead of default triggers like that of a DatePicker field.

Ext.create('Ext.form.DatePicker', {
    label: 'Pick a Date',
    triggers: {
        foo: {
            cls: 'my-foo-trigger',
            weight: -2, // negative to place before default triggers
            handler: function() {
                console.log('foo trigger clicked');
            }
        },
        bar: {
            cls: 'my-bar-trigger',
            weight: -1,
            handler: function() {
                console.log('bar trigger clicked');
            }
        }
    }
});

Defaults to:

{
    clear: {
        type: 'clear'
    }
}

getTriggers : Object

Returns the value of triggers

Returns

Object

setTriggers (triggers)

Sets the value of triggers

Parameters

triggers :  Object

twoWayBindable : String / String[] / Object
bindable bind

This object holds a map of config properties that will update their binding as they are modified. For example, value is a key added by form fields. The form of this config is the same as publishes.

This config is defined so that updaters are not created and added for all bound properties since most cannot be modified by the end-user and hence are not appropriate for two-way binding.

Defaults to:

{
    selection: 1
}

getTwoWayBindable : String / String[] / Object

Returns the value of twoWayBindable

Returns

String / String[] / Object

setTwoWayBindable (twoWayBindable)

Sets the value of twoWayBindable

Parameters

twoWayBindable :  String / String[] / Object

typeAhead : Boolean
bindable bind

true to populate and autoselect the remainder of the text being typed after a configurable delay (typeAheadDelay) if it matches a known value.

Defaults to:

false

getTypeAhead : Boolean

Returns the value of typeAhead

Returns

Boolean

setTypeAhead (typeAhead)

Sets the value of typeAhead

Parameters

typeAhead :  Boolean

typeAheadDelay : Number
bindable bind

The length of time in milliseconds to wait until the typeahead text is displayed if typeAhead is true.

Defaults to:

250

getTypeAheadDelay : Number

Returns the value of typeAheadDelay

Returns

Number

setTypeAheadDelay (typeAheadDelay)

Sets the value of typeAheadDelay

Parameters

typeAheadDelay :  Number

ui : String / String[]
bindable bind

The ui or uis to be used on this Component

When a ui is configured, CSS class names are added to the element, created by appending the ui name(s) to each classCls and/or baseCls.

Defaults to:

null

getUi : String / String[]

Returns the value of ui

Returns

String / String[]

setUi (ui)

Sets the value of ui

Parameters

ui :  String / String[]

underError : String
bindable bind private pri

Defaults to:

null

getUnderError : String

Returns the value of underError

Returns

String

setUnderError (underError)

Sets the value of underError

Parameters

underError :  String

userCls : String / String[]
bindable bind

One or more CSS classes to add to the component's primary element. This config is intended solely for use by the component instantiator (the "user"), not by derived classes.

For example:

 items: [{
     xtype: 'button',
     userCls: 'my-button'
 ...
 }]

Defaults to:

null

getUserCls : String / String[]

Returns the value of userCls

Returns

String / String[]

setUserCls (userCls)

Sets the value of userCls

Parameters

userCls :  String / String[]

userSelectable : Boolean / String / Object
bindable bind

Set to true to allow users to select text within this component.

Can also be any valid value for the CSS3 user-select property.

A value of true implies auto, while false implies none.

May also be an object keyed by child element name.

By default, the user cannot click+drag+select text/elements of the UI. Applications may want to enable user selection for specific DOM elements, such as the bodyElement of a component used as a tab panel. The tab and tab text would not be user selectable in this example, but the content area when the tab is selected would.

 userSelectable: {
     element: true,       // optionally allow the element to be user selectable
     bodyElement: true    // optionally allow the component's body element to be user selectable
 }

Defaults to:

false

Available since: 6.5.1

getUserSelectable : Boolean / String / Object

Returns the value of userSelectable

Returns

Boolean / String / Object

setUserSelectable (userSelectable)

Sets the value of userSelectable

Parameters

userSelectable :  Boolean / String / Object

validateDisabled : Boolean
bindable bind

true to validate the field, even if it is disabled.

Defaults to:

false

getValidateDisabled : Boolean

Returns the value of validateDisabled

Returns

Boolean

setValidateDisabled (validateDisabled)

Sets the value of validateDisabled

Parameters

validateDisabled :  Boolean

validationMessage : String
bindable bind

For validation, regex, etc., this is the error message returned if field is invalid.

Defaults to:

'Is in the wrong format'

getValidationMessage : String

Returns the value of validationMessage

Returns

String

setValidationMessage (validationMessage)

Sets the value of validationMessage

Parameters

validationMessage :  String

validators : Mixed
bindable bind

A validator or array of validators to be applied to the field.

When the field is validated, each validator is applied and if any one of them determines the field is invalid, the field will be marked as invalid. If you examine the field's validators, you will get an array of Ext.data.Validators.

Validation currently is synchronous. If you need to validate a field with interaction with a server, you would do this when the form is submitted.

A validator may be:

  • A regexp - if the field fails to match the regexp, it is invalid.
  • A function - the function will be called to validate the field; it should return false if invalid.`
  • An object - an object with a member fn that is a function to be called to validate the field.
  • An instantiated Validator Ext.data.validator.Validator

Defaults to:

null

getValidators : Mixed

Returns the value of validators

Returns

Mixed

setValidators (validators)

Sets the value of validators

Parameters

validators :  Mixed

value : Mixed
bindable bind

The field's value

Defaults to:

null

getValue : Mixed

Returns the value of value

Returns

Mixed

setValue (value)

Sets the value of value

Parameters

value :  Mixed

valueCollection : Object / Ext.util.Collection
bindable bind readonly ro private pri

A Ext.util.Collection instance, or configuration object used to create the collection of selected records.

This is used by the picker as the core of its selection handling, and also as the collection of selected values for this widget.

Defaults to:

true

Available since: 6.5.0

getValueCollection : Object / Ext.util.Collection

Returns the value of valueCollection

Returns

Object / Ext.util.Collection

setValueCollection (valueCollection)

Sets the value of valueCollection

Parameters

valueCollection :  Object / Ext.util.Collection

valueField : String / Number
bindable bind

The underlying data value name to bind to this Select control. If configured as null, the displayField is used.

Defaults to:

'value'

getValueField : String / Number

Returns the value of valueField

Returns

String / Number

setValueField (valueField)

Sets the value of valueField

Parameters

valueField :  String / Number

valueNotFoundText : String
bindable bind

The message to display if the value passed to setValue is not found in the store.

Defaults to:

null

getValueNotFoundText : String

Returns the value of valueNotFoundText

Returns

String

setValueNotFoundText (valueNotFoundText)

Sets the value of valueNotFoundText

Parameters

valueNotFoundText :  String

viewModel : String / Object / Ext.app.ViewModel
bindable bind

The ViewModel is a data provider for this component and its children. The data contained in the ViewModel is typically used by adding bind configs to the components that want present or edit this data.

When set, the ViewModel is created and links to any inherited viewModel instance from an ancestor container as the "parent". The ViewModel hierarchy, once established, only supports creation or destruction of children. The parent of a ViewModel cannot be changed on the fly.

If this is a root-level ViewModel, the data model connection is made to this component's associated Ext.data.Session. This is determined by calling getInheritedSession.

Defaults to:

null

getViewModel : String / Object / Ext.app.ViewModel

Returns the value of viewModel

Returns

String / Object / Ext.app.ViewModel

setViewModel (viewModel)

Sets the value of viewModel

Parameters

viewModel :  String / Object / Ext.app.ViewModel

weight : Number
bindable bind

This value controls this item's order in a weighted Ext.Container (see parent).

Lower values gravitate towards the start of the container - the top in vertical layouts, the locale start side in horizontal layouts.

Defaults to:

0

getWeight : Number

Returns the value of weight

Returns

Number

setWeight (weight)

Sets the value of weight

Parameters

weight :  Number

width : Number / String
bindable bind

The width of this Component; must be a valid CSS length value, e.g: 300, 100px, 30%, etc. By default, if this is not explicitly set, this Component's element will simply have its own natural size. If set to auto, it will set the width to null meaning it will have its own natural size.

Defaults to:

null

getWidth : Number / String

Returns the value of width

Returns

Number / String

setWidth (width)

Sets the value of width

Parameters

width :  Number / String

x : Number
bindable bind

Only valid when a component is cfg-floated

The x position at which to position this component. This is usually viewport-relative. But if there is a relative: true ancestor, it will be relative to that.

Defaults to:

0

getX : Number

Returns the value of x

Returns

Number

setX (x)

Sets the value of x

Parameters

x :  Number

xtype : String

The xtype configuration option can be used to optimize Component creation and rendering. It serves as a shortcut to the full component name. For example, the component Ext.button.Button has an xtype of button.

You can define your own xtype on a custom Ext.Component by specifying the alias config option with a prefix of widget. For example:

Ext.define('PressMeButton', {
    extend: 'Ext.button.Button',
    alias: 'widget.pressmebutton',
    text: 'Press Me'
});

Any Component can be created implicitly as an object config with an xtype specified, allowing it to be declared and passed into the rendering pipeline without actually being instantiated as an object. Not only is rendering deferred, but the actual creation of the object itself is also deferred, saving memory and resources until they are actually needed. In complex, nested layouts containing many Components, this can make a noticeable improvement in performance.

// Explicit creation of contained Components:
var panel = new Ext.Panel({
   // ...
   items: [
      Ext.create('Ext.button.Button', {
         text: 'OK'
      })
   ]
});

// Implicit creation using xtype:
var panel = new Ext.Panel({
   // ...
   items: [{
      xtype: 'button',
      text: 'OK'
   }]
});

In the first example, the button will always be created immediately during the panel's initialization. With many added Components, this approach could potentially slow the rendering of the page. In the second example, the button will not be created or rendered until the panel is actually displayed in the browser. If the panel is never displayed (for example, if it is a tab that remains hidden) then the button will never be created and will never consume any resources whatsoever.

y : Number
bindable bind

Only valid when a component is cfg-floated

The x position at which to position this component. This is usually viewport-relative. But if there is a relative: true ancestor, it will be relative to that.

Defaults to:

0

getY : Number

Returns the value of y

Returns

Number

setY (y)

Sets the value of y

Parameters

y :  Number

zIndex : Number
bindable bind

The z-index to give this Component when it is rendered.

Not valid for cfg-floated Components. The Z ordering of cfg-floated Components is managed by ordering of the DOM elements.

Defaults to:

null

getZIndex : Number

Returns the value of zIndex

Returns

Number

setZIndex (zIndex)

Sets the value of zIndex

Parameters

zIndex :  Number

properties

Instance Properties

$className
private pri

Defaults to:

'Ext.Base'

$configPrefixed : Boolean
private pri

The value true causes config values to be stored on instances using a property name prefixed with an underscore ("_") character. A value of false stores config values as properties using their exact name (no prefix).

Defaults to:

true

Available since: 5.0.0

$configStrict : Boolean
private pri

The value true instructs the initConfig method to only honor values for properties declared in the config block of a class. When false, properties that are not declared in a config block will be placed on the instance.

Defaults to:

true

Available since: 5.0.0

$eventOptions
private pri

Matches options property names within a listeners specification object - property names which are never used as event names.

Defaults to:

{
    scope: 1,
    delay: 1,
    buffer: 1,
    onFrame: 1,
    single: 1,
    args: 1,
    destroyable: 1,
    priority: 1,
    order: 1
}

$vetoClearingPrototypeOnDestroy
private pri

We don't want the base destructor to clear the prototype because our destroyObservable handler must be called the very last. It will take care of the prototype after completing Observable destruction sequence.

Defaults to:

true

activeAnimation
private pri

Defaults to:

null

ariaEl : String
readonly ro private pri

The name of the Component property that holds a reference to the Element that serves as that Component's ARIA element. This property will be replaced with the actual Element reference after rendering.

Most of the simple Components will have their main element as ariaEl.

Defaults to:

'el'

Available since: 6.0.0

ariaRenderAttributes : Object
private pri

Instance specific ARIA attributes to render into Component's ariaEl. This object is only used during rendering, and is discarded afterwards.

ariaRole : String
readonly ro

ARIA role for this Component, defaults to no role. With no role, no other ARIA attributes are set.

baseCls
protected pro

The base CSS class to apply to this widget's element. Used as the prefix for ui-specific class names. Defaults to the value of classCls or (x- + the xtype) of the widget if classCls is null

Defaults to:

null

classCls

A CSS class to apply to the main element that will be inherited down the class hierarchy. Subclasses may override this property on their prototype to add their own CSS class in addition to the CSS classes inherited from ancestor classes via the prototype chain. For example

Ext.define('Foo', {
    extend: 'Ext.Widget',
    classCls: 'foo'
});

Ext.define('Bar', {
    extend: 'Foo',
    classCls: 'bar'
});

var bar = new Bar();

console.log(bar.element.className); // outputs 'foo bar'

Defaults to:

Ext.baseCSSPrefix + 'selectfield'

classClsRoot
protected pro

When set to true during widget class definition, that class will be the "root" for classCls inheritance. Derived classes may set this to true to avoid inheriting a classCls from their superclass.

Defaults to:

true

clearPropertiesOnDestroy : Boolean / "async"
protected pro

Setting this property to false will prevent nulling object references on a Class instance after destruction. Setting this to "async" will delay the clearing for approx 50ms.

Defaults to:

true

Available since: 6.2.0

clearPrototypeOnDestroy : Boolean
private pri

Setting this property to true will result in setting the object's prototype to null after the destruction sequence is fully completed. After that, most attempts at calling methods on the object instance will result in "method not defined" exception. This can be very helpful with tracking down otherwise hard to find bugs like runaway Ajax requests, timed functions not cleared on destruction, etc.

Note that this option can only work in browsers that support Object.setPrototypeOf method, and is only available in debugging mode.

Defaults to:

false

Available since: 6.2.0

containsFocus : Boolean
readonly ro

true if this currently focused element is within this Component's or Container's hierarchy. This property is set separately from hasFocus, and can be true when hasFocus is false.

Examples:

  • Text field with input element focused would be: focusable: true, hasFocus: true, containsFocus: true

  • Date field with drop-down picker currently focused would be: focusable: true, hasFocus: false, containsFocus: true

  • Form Panel with a child input field currently focused would be: focusable: false, hasFocus: false, containsFocus: true

See also hasFocus.

Defaults to:

false

defaultBindProperty : String

This property is used to determine the property of a bind config that is just the value. For example, if defaultBindProperty="value", then this shorthand bind config:

 bind: '{name}'

Is equivalent to this object form:

 bind: {
     value: '{name}'
 }

The defaultBindProperty is set to "value" for form fields and to "store" for grids and trees.

Defaults to:

'value'

destroyed : Boolean
protected pro

This property is set to true after the destroy method is called.

Defaults to:

false

dockPositions
readonly ro private pri

Defaults to:

{
    top: true,
    right: true,
    bottom: true,
    left: true
}

element : Object
protected pro

A configuration object for Ext.Element.create() that is used to create the Element template. Subclasses should avoid overriding this property and instead add elements using template.

Supports all the standard options of a Ext.Element.create() config and adds 3 additional options:

  1. reference - this option specifies a name for Element references. These references names become properties of the Widget instance and refer to Ext.Element instances that were created using the template:

      element: {
          reference: 'element',
          children: [{
              reference: 'innerElement'
          }]
      }
    

After construction of a widget the reference elements are accessible as follows:

var foo = new FooWidget(),
    innerEl = foo.innerElement; // an Ext.Element that wraps the innerElement

The reference attribute is optional, but all Widgets must have a 'element' reference on some element within the template (usually the outermost one).

  1. listeners - a standard listeners object as specified by Ext.mixin.Observable.

      element: {
          reference: 'element',
          listeners: {
              click: 'onClick'
          },
          children: [{
              reference: 'innerElement',
              listeners: {
                  click: 'onInnerClick'
              }
          }]
      }
    

Since listeners cannot be attached without an Ext.Element reference the reference property MUST be specified in order to use listeners.

The Widget instance is used as the scope for all listeners specified in this way, so it is invalid to use the scope option in the listeners config since it will always be overwritten using this.

  1. uiCls - a suffix to be appended to the ui-specific CSS class for each ui for this widget. These ui classes are constructed by appending the ui to each classCls or baseCls for the widget. As such, uiCls should never be used on the main element reference, as its uiCls is computed automatically.

For example, assume a widget is defined with a ui of 'alt action' and a uiCls of 'inner-el' on its innerElement reference element:

     Ext.define('Doodad', {
         extend: 'Ext.Widget',
         xtype: 'doodad',

         classCls: 'x-doodad',

         ui: 'alt action',

         element: {
             reference: 'element',

             children: [{
                 reference: 'innerElement',
                 cls: 'x-inner-el',
                 uiCls: 'inner-el'
             }]
         }
     });

This would result in the following markup when rendered:

<div class="x-doodad x-doodad-alt x-doodad-action">
    <div class="x-inner-el x-doodad-inner-el x-doodad-alt-inner-el x-doodad-action-inner-el"></div>
</div>

These additional classes can be used to style the reference element for a particular ui; however, use of uiCls is not typically necessary or recommended. Reference elements should usually be styled using simple descendant selectors:

.x-doodad-alt .x-inner-el {
    color: red;
}

When there is a possibility that widgets can be nested it is best to use direct child selectors to avoid the possibility of selecting all descendants instead of just the reference element for the intended widget:

.x-doodad-alt > .x-inner-el {
    color: red;
}

Only use uiCls when there is a possibility of nesting, AND there may be a variable number of elements between the main element and the reference element in question. For example, Ext.Container with docked items has a different number of elements in between its element and its bodyElement than a Container without docked items because of the wrapping elements that are dynamically added to support docking. To ensure it does not style all descendants it must use a uiCls to style its bodyElement:

.x-container-alt-body-el {
    background: #fff;
}

Note that when uiCls is specified it also adds a class name that does not contain the ui using just the classCls and/or baseCls as the prefix. This class name can be used for base-level styling that does not relate to any particular UI:

.x-container-body-el {
    position: relative;
}

Defaults to:

{
    reference: 'element'
}

eventsSuspended
private pri

Initial suspended call count. Incremented when suspendEvents is called, decremented when resumeEvents is called.

Defaults to:

0

factoryConfig : Object

If this property is specified by the target class of this mixin its properties are used to configure the created Ext.Factory.

floatedSelector : String
readonly ro private pri

The CSS selector to match floated elements.

Defaults to:

".x-floated"

floatingCls : String

The CSS class to add to this component when it is floated at the viewport level.

Defaults to:

Ext.baseCSSPrefix + 'floating'

floatWrapCls : String
readonly ro private pri

The CSS class to add to this component's floatWrap when it's created.

Defaults to:

"x-float-wrap"

focusable : Boolean
readonly ro

true for keyboard interactive Components or Widgets, false otherwise. For Containers, this property reflects interactiveness of the Container itself, not its children. See isFocusable.

Note: It is not enough to set this property to true to make a component keyboard interactive. You also need to make sure that the component's focusEl is reachable via Tab key (tabbable). See also tabIndex.

Defaults to:

false

focusClsEl : Ext.dom.Element

The element that will have the focusCls applied when component's focusEl is focused.

focusEl : Ext.dom.Element

The element that will be focused when focus method is called on this component. Usually this is the same element that receives focus via mouse clicks, taps, and pressing Tab key.

Defaults to:

'el'

hasFocus : Boolean
readonly ro

true if this component's focusEl is focused. See also containsFocus.

Defaults to:

false

hasListeners : Object
readonly ro

This object holds a key for any event that has a listener. The listener may be set directly on the instance, or on its class or a super class (via observe) or on the Ext.app.EventBus. The values of this object are truthy (a non-zero number) and falsy (0 or undefined). They do not represent an exact count of listeners. The value for an event is truthy if the event must be fired and is falsy if there is no need to fire the event.

The intended use of this property is to avoid the expense of fireEvent calls when there are no listeners. This can be particularly helpful when one would otherwise have to call fireEvent hundreds or thousands of times. It is used like this:

 if (this.hasListeners.foo) {
     this.fireEvent('foo', this, arg1);
 }

htmlErrorsTpl : Ext.XTemplate
readonly ro private pri

The default template used to format errors in HTML. This property is promoted to an Ext.XTemplate instance on first use.

Defaults to:

[
    '<tpl if="count == 1">',
    '<tpl for="errors">{.:htmlEncode}</tpl>',
    '<tpl elseif="count">',
    '<ul class="{listCls}">',
    '<tpl for="errors"><li>{.:htmlEncode}</li></tpl>',
    '</ul>',
    '</tpl>'
]

Available since: 6.5.0

inheritUi : Boolean / String

Set to true on widgets that should inherit ui from their parent container. This property is typically set on the class body, but can be set on an instance as long as it is set prior to the instance being added to its container. This property is inspected at the moment a widget is added to a container, and any UIs on the container are added to the widget at that time. Inherited UIs are in addition to the widget's own ui, and are updated when the container's UI changes.

Defaults to:

false

initFocusable
protected pro

Template method to do any Focusable related initialization that does not involve event listeners creation.

Defaults to:

Ext.emptyFn

isComponent
private pri

Defaults to:

true

isConfiguring : Boolean
readonly ro protected pro

This property is set to true during the call to initConfig.

Defaults to:

false

Available since: 5.0.0

isField : Boolean

Set to true on all Ext.field.Field subclasses. This is used by Ext.form.Panel#getValues to determine which components inside a form are fields.

Defaults to:

true

isFirstInstance : Boolean
readonly ro protected pro

This property is set to true if this instance is the first of its class.

Defaults to:

false

Available since: 5.0.0

isFormField
private pri

Defaults to:

true

isInner
private pri

Defaults to:

true

isInstance : Boolean
readonly ro protected pro

This value is true and is used to identify plain objects from instances of a defined class.

Defaults to:

true

isObservable : Boolean

true in this class to identify an object as an instantiated Observable, or subclass thereof.

Defaults to:

true

isSelectField : Boolean

true to identify an object as an instance of this class, or a subclass thereof.

Defaults to:

true

noBorderCls : String
readonly ro private pri

The CSS class to add to this component should not have a border.

Defaults to:

Ext.baseCSSPrefix + 'noborder-trbl'

originalValue : Mixed
private pri

The original value when the field was instantiated.

Defaults to:

null

plainErrorsTpl : Ext.XTemplate
readonly ro private pri

The default template used to format errors as plain text. This property is promoted to an Ext.XTemplate instance on first use.

Defaults to:

[
    '<tpl if="count">',
    '<tpl for="errors" between="\\n">{.}</tpl>',
    '</tpl>'
]

Available since: 6.5.0

positioned
private pri

Defaults to:

false

rendered : Boolean
readonly ro

The rendered flag is set when a widget is inserted into the document for the first time.

Note that this is a one-way operation. The first time a widget is inserted into the document, this flag is set, and it is never unset.

self : Ext.Class
protected pro

Get the reference to the current class from which this object was instantiated. Unlike Ext.Base#statics, this.self is scope-dependent and it's meant to be used for dynamic inheritance. See Ext.Base#statics for a detailed comparison

Ext.define('My.Cat', {
    statics: {
        speciesName: 'Cat' // My.Cat.speciesName = 'Cat'
    },

    constructor: function() {
        alert(this.self.speciesName); // dependent on 'this'
    },

    clone: function() {
        return new this.self();
    }
});


Ext.define('My.SnowLeopard', {
    extend: 'My.Cat',
    statics: {
        speciesName: 'Snow Leopard'         // My.SnowLeopard.speciesName = 'Snow Leopard'
    }
});

var cat = new My.Cat();                     // alerts 'Cat'
var snowLeopard = new My.SnowLeopard();     // alerts 'Snow Leopard'

var clone = snowLeopard.clone();
alert(Ext.getClassName(clone));             // alerts 'My.SnowLeopard'

Defaults to:

Base

shadowCls : String
readonly ro private pri

The CSS class to add to this component when it has a shadow.

Defaults to:

Ext.baseCSSPrefix + 'shadow'

shimCls : String
readonly ro private pri

The CSS class to add to this component's shim element if enabled.

Defaults to:

"x-shim"

tag : String
protected pro

The tag name to use for this field's input element. Subclasses should override this property on their class body. Not intended for instance-level use.

Defaults to:

'input'

template : Array
protected pro

An array of child elements to use as the children of the main element in the element template. Only used if "children" are not specified explicitly in the element template.

Defaults to:

[]

uiReferences : Object
private pri

A map that tracks all reference elements configured with a uiCls. Contains the element reference by default since the element always gets non-suffixed ui-specific CSS class names added to it (see syncUiCls)

userSelectableClsMap
private pri

Defaults to:

{
    "true": Ext.baseCSSPrefix + 'user-selectable-auto',
    "false": Ext.baseCSSPrefix + 'user-selectable-none',
    all: Ext.baseCSSPrefix + 'user-selectable-all',
    auto: Ext.baseCSSPrefix + 'user-selectable-auto',
    text: Ext.baseCSSPrefix + 'user-selectable-text',
    none: Ext.baseCSSPrefix + 'user-selectable-none'
}

validateOnInit : "none" / "auto" / "all"

Determines how initial values will handle validation

  • none: Will not validate any initial values
  • auto: Will only validate non-empty initial values
  • all: Will validate all initial values

Defaults to:

'auto'

validRefRe : RegExp
private pri

Regular expression used for validating reference values.

Defaults to:

/^[a-z_][a-z0-9_]*$/i

Static Properties

$onExtended
static sta private pri

Defaults to:

[]

methods

Instance Methods

_addDeclaredListeners ( listeners ) : Boolean
private pri

Adds declarative listeners as nested arrays of listener objects.

Parameters

listeners :  Array

Returns

:Boolean

true if any listeners were added

_fixReference
private pri

Sets up a reference on our current reference holder.

activatePlugin ( type ) : Ext.plugin.Abstract
private pri

Creates a particular plugin type if defined in the plugins configuration.

Available since: 6.2.0

Parameters

type :  String

The type of the plugin.

Returns

:Ext.plugin.Abstract

The plugin that was created.

addBindableUpdater ( property )
private pri

Ensures that the given property (if it is a Config System config) has a proper "updater" method on this instance to sync changes to the config.

Available since: 5.0.0

Parameters

property :  String

The name of the config property.

addCls ( cls, [prefix], [suffix] )

Adds a CSS class (or classes) to this Component's rendered element.

Parameters

cls :  String/String[]

The CSS class(es) to add.

prefix :  String (optional)

Optional prefix to add to each class.

Defaults to: ""

suffix :  String (optional)

Optional suffix to add to each class.

Defaults to: ""

addDelegatedListener ( eventName, fn, scope, options, order, caller, manager )
private pri

Adds a listeners with the "delegate" event option. Users should not invoke this method directly. Use the "delegate" event option of addListener instead.

Parameters

eventName :  Object

fn :  Object

scope :  Object

options :  Object

order :  Object

caller :  Object

manager :  Object

addDeprecations ( deprecations )
private pri

This method applies a versioned, deprecation declaration to this class. This is typically called by the deprecated config.

Parameters

deprecations :  Object

addElementReference ( name, domNode ) : Ext.dom.Element
private pri

Adds an element reference to this Widget instance.

Parameters

name :  String

The name of the reference

domNode :  HTMLElement

Returns

:Ext.dom.Element

addElementReferenceOnDemand ( name, domNode )
private pri

Reduces instantiation time for a Widget by lazily instantiating Ext.Element references the first time they are used. This optimization only works for elements with no listeners specified.

Parameters

name :  String

The name of the reference

domNode :  HTMLElement

addListener ( eventName, [fn], [scope], [options], [order] ) : Object
chainable ch

The on method is shorthand for addListener.

Appends an event handler to this object. For example:

myGridPanel.on("itemclick", this.onItemClick, this);

The method also allows for a single argument to be passed which is a config object containing properties which specify multiple events. For example:

myGridPanel.on({
    cellclick: this.onCellClick,
    select: this.onSelect,
    viewready: this.onViewReady,
    scope: this // Important. Ensure "this" is correct during handler execution
});

One can also specify options for each event handler separately:

myGridPanel.on({
    cellclick: {fn: this.onCellClick, scope: this, single: true},
    viewready: {fn: panel.onViewReady, scope: panel}
});

Names of methods in a specified scope may also be used:

myGridPanel.on({
    cellclick: {fn: 'onCellClick', scope: this, single: true},
    viewready: {fn: 'onViewReady', scope: panel}
});

Parameters

eventName :  String/Object

The name of the event to listen for. May also be an object who's property names are event names.

fn :  Function/String (optional)

The method the event invokes or the name of the method within the specified scope. Will be called with arguments given to Ext.util.Observable#fireEvent plus the options parameter described below.

scope :  Object (optional)

The scope (this reference) in which the handler function is executed. If omitted, defaults to the object which fired the event.

options :  Object (optional)

An object containing handler configuration.

Note: The options object will also be passed as the last argument to every event handler.

This object may contain any of the following properties:

scope :  Object

The scope (this reference) in which the handler function is executed. If omitted, defaults to the object which fired the event.

delay :  Number

The number of milliseconds to delay the invocation of the handler after the event fires.

single :  Boolean

True to add a handler to handle just the next firing of the event, and then remove itself.

buffer :  Number

Causes the handler to be scheduled to run in an Ext.util.DelayedTask delayed by the specified number of milliseconds. If the event fires again within that time, the original handler is not invoked, but the new handler is scheduled in its place.

onFrame :  Number

Causes the handler to be scheduled to run at the next animation frame event. If the event fires again before that time, the handler is not rescheduled - the handler will only be called once when the next animation frame is fired, with the last set of arguments passed.

target :  Ext.util.Observable

Only call the handler if the event was fired on the target Observable, not if the event was bubbled up from a child Observable.

element :  String

This option is only valid for listeners bound to Ext.Component. The name of a Component property which references an Ext.dom.Element to add a listener to.

This option is useful during Component construction to add DOM event listeners to elements of Ext.Component which will exist only after the Component is rendered.

For example, to add a click listener to a Panel's body:

  var panel = new Ext.panel.Panel({
      title: 'The title',
      listeners: {
          click: this.handlePanelClick,
          element: 'body'
      }
  });

In order to remove listeners attached using the element, you'll need to reference the element itself as seen below.

 panel.body.un(...)

delegate :  String (optional)

A simple selector to filter the event target or look for a descendant of the target.

The "delegate" option is only available on Ext.dom.Element instances (or when attaching a listener to a Ext.dom.Element via a Component using the element option).

See the delegate example below.

capture :  Boolean (optional)

When set to true, the listener is fired in the capture phase of the event propagation sequence, instead of the default bubble phase.

The capture option is only available on Ext.dom.Element instances (or when attaching a listener to a Ext.dom.Element via a Component using the element option).

stopPropagation :  Boolean (optional)

This option is only valid for listeners bound to Ext.dom.Element. true to call stopPropagation on the event object before firing the handler.

preventDefault :  Boolean (optional)

This option is only valid for listeners bound to Ext.dom.Element. true to call preventDefault on the event object before firing the handler.

stopEvent :  Boolean (optional)

This option is only valid for listeners bound to Ext.dom.Element. true to call stopEvent on the event object before firing the handler.

args :  Array (optional)

Optional set of arguments to pass to the handler function before the actual fired event arguments. For example, if args is set to ['foo', 42], the event handler function will be called with an arguments list like this:

 handler('foo', 42, <actual event arguments>...);

destroyable :  Boolean (optional)

When specified as true, the function returns a destroyable object. An object which implements the destroy method which removes all listeners added in this call. This syntax can be a helpful shortcut to using un; particularly when removing multiple listeners. NOTE - not compatible when using the element option. See un for the proper syntax for removing listeners added using the element config.

Defaults to:

false

priority :  Number (optional)

An optional numeric priority that determines the order in which event handlers are run. Event handlers with no priority will be run as if they had a priority of 0. Handlers with a higher priority will be prioritized to run sooner than those with a lower priority. Negative numbers can be used to set a priority lower than the default. Internally, the framework uses a range of 1000 or greater, and -1000 or lesser for handlers that are intended to run before or after all others, so it is recommended to stay within the range of -999 to 999 when setting the priority of event handlers in application-level code. A priority must be an integer to be valid. Fractional values are reserved for internal framework use.

order :  String (optional)

A legacy option that is provided for backward compatibility. It is recommended to use the priority option instead. Available options are:

  • 'before': equal to a priority of 100
  • 'current': equal to a priority of 0 or default priority
  • 'after': equal to a priority of -100

Defaults to:

'current'

order :  String (optional)

A shortcut for the order event option. Provided for backward compatibility. Please use the priority event option instead.

Defaults to: 'current'

Returns

:Object

Only when the destroyable option is specified.

A Destroyable object. An object which implements the destroy method which removes all listeners added in this call. For example:

this.btnListeners =  = myButton.on({
    destroyable: true
    mouseover:   function() { console.log('mouseover'); },
    mouseout:    function() { console.log('mouseout'); },
    click:       function() { console.log('click'); }
});

And when those listeners need to be removed:

Ext.destroy(this.btnListeners);

or

this.btnListeners.destroy();

addManagedListener ( item, ename, [fn], [scope], [options] ) : Object

The addManagedListener method is used when some object (call it "A") is listening to an event on another observable object ("B") and you want to remove that listener from "B" when "A" is destroyed. This is not an issue when "B" is destroyed because all of its listeners will be removed at that time.

Example:

Ext.define('Foo', {
    extend: 'Ext.Component',

    initComponent: function () {
        this.addManagedListener(MyApp.SomeGlobalSharedMenu, 'show', this.doSomething);
        this.callParent();
    }
});

As you can see, when an instance of Foo is destroyed, it ensures that the 'show' listener on the menu (MyApp.SomeGlobalSharedMenu) is also removed.

As of version 5.1 it is no longer necessary to use this method in most cases because listeners are automatically managed if the scope object provided to addListener is an Observable instance. However, if the observable instance and scope are not the same object you still need to use mon or addManagedListener if you want the listener to be managed.

Parameters

item :  Ext.util.Observable/Ext.dom.Element

The item to which to add a listener/listeners.

ename :  Object/String

The event name, or an object containing event name properties.

fn :  Function/String (optional)

If the ename parameter was an event name, this is the handler function or the name of a method on the specified scope.

scope :  Object (optional)

If the ename parameter was an event name, this is the scope (this reference) in which the handler function is executed.

options :  Object (optional)

If the ename parameter was an event name, this is the addListener options.

Returns

:Object

Only when the destroyable option is specified.

A Destroyable object. An object which implements the destroy method which removes all listeners added in this call. For example:

this.btnListeners = myButton.mon({
    destroyable: true
    mouseover:   function() { console.log('mouseover'); },
    mouseout:    function() { console.log('mouseout'); },
    click:       function() { console.log('click'); }
});

And when those listeners need to be removed:

Ext.destroy(this.btnListeners);

or

this.btnListeners.destroy();

addPlugin ( plugin )

Adds a plugin. For example:

 list.addPlugin('pullrefresh');

Or:

 list.addPlugin({
     type: 'pullrefresh',
     pullRefreshText: 'Pull to refresh...'
 });

Available since: 6.2.0

Parameters

plugin :  Object/String/Ext.plugin.Abstract

The plugin or config object or alias to add.

addTrigger ( name, trigger ) : Ext.field.trigger.Trigger

Adds a trigger to this text field.

Parameters

name :  String

Unique name (within this field) for the trigger. Cannot be the same as the name of an existing trigger for this field.

trigger :  Ext.field.trigger.Trigger/Object

The trigger instance or a config object for a trigger to add

Returns

:Ext.field.trigger.Trigger

The trigger that was added

afterEdit
private pri

Used to handle joining of a record to a tpl

afterErase
private pri

Used to handle joining of a record to a tpl

afterRender
template tpl

This method is called after the component is initially added to the DOM. If this component Ext.Container other components, the afterRender method for child components is called before the parent's afterRender.

Implementations of this method should avoid reading from the DOM but are free to write to the DOM as needed. To read the DOM, consider implementing onRender instead.

This method is not generally needed because components always have their own DOM element and these are maintained by config property updaters prior to insertion in the DOM. In general, it is always best to manipulate the component's elements outside the DOM where there is no associated reflow or layout cost. This method is useful for situations where the component's elements must be in the DOM in order to be manipulated correctly.

Available since: 6.5.0

This is a template method. a hook into the functionality of this class. Feel free to override it in child classes.

alignTo ( component, alignment, options )
private pri

Parameters

component :  Object

alignment :  Object

options :  Object

applyBind ( binds, currentBindings ) : Object
private pri

Available since: 5.0.0

Parameters

binds :  String/Object

currentBindings :  Object

Returns

:Object

applyCentered ( centered ) : Boolean
private pri

Parameters

centered :  Boolean

Returns

:Boolean

applyPlugins ( plugins, oldPlugins )
private pri

Applier for the plugins config property.

Parameters

plugins :  String[]/Object[]/Ext.plugin.Abstract[]

The new plugins to use.

oldPlugins :  Ext.plugin.Abstract[]

The existing plugins in use.

applySession ( session ) : Ext.data.Session
private pri

Transforms a Session config to a proper instance.

Available since: 5.0.0

Parameters

session :  Object

Returns

:Ext.data.Session

applyStyle ( style, oldStyle )
protected pro

Parameters

style :  Object

oldStyle :  Object

applyTpl ( tpl )
private pri

Parameters

tpl :  Object

applyValidators ( validators )
private pri

Parameters

validators :  Object

applyViewModel ( viewModel ) : Ext.app.ViewModel
private pri

Transforms a ViewModel config to a proper instance.

Available since: 5.0.0

Parameters

viewModel :  String/Object/Ext.app.ViewModel

Returns

:Ext.app.ViewModel

beforeFilter ( queryPlan )
template tpl

A method which may modify aspects of how the store is to be filtered (if queryMode is "local") of loaded (if queryMode is "remote").

This is called by the {@link #doFilter method, and may be overridden in subclasses to modify the default behaviour.

This method is passed an object containing information about the upcoming query operation which it may modify before returning.

Parameters

queryPlan :  Object

An object containing details about the query to be executed.

query :  String (optional)

The query value to be used to match against the ComboBox's textField. If not present, the primary textfield filter is disabled.

lastQuery :  String

The query value used the last time a store query was made.

force :  Boolean

If true, causes the query to be executed even if the minChars threshold is not met.

cancel :  Boolean

A boolean value which, if set to true upon return, causes the query not to be executed.

This is a template method. a hook into the functionality of this class. Feel free to override it in child classes.

bubble ( fn, [scope], [args] )

Bubbles up the getRefOwner hierarchy, calling the specified function with each component. The scope (this reference) of the function call will be the scope provided or the current component. The arguments to the function will be the args provided or the current component. If the function returns false at any point, the bubble is stopped.

Parameters

fn :  Function

The function to call

scope :  Object (optional)

The scope of the function. Defaults to current node.

args :  Array (optional)

The args to call the function with. Defaults to passing the current component.

callOverridden ( args ) : Object
deprecated dep protected pro

Call the original method that was previously overridden with Ext.Base#override

Ext.define('My.Cat', {
    constructor: function() {
        alert("I'm a cat!");
    }
});

My.Cat.override({
    constructor: function() {
        alert("I'm going to be a cat!");

        this.callOverridden();

        alert("Meeeeoooowwww");
    }
});

var kitty = new My.Cat(); // alerts "I'm going to be a cat!"
                          // alerts "I'm a cat!"
                          // alerts "Meeeeoooowwww"

Parameters

args :  Array/Arguments

The arguments, either an array or the arguments object from the current method, for example: this.callOverridden(arguments)

Returns

:Object

Returns the result of calling the overridden method

Deprecated since version 4.1.0
Use method-callParent instead.

callParent ( args ) : Object
protected pro

Call the "parent" method of the current method. That is the method previously overridden by derivation or by an override (see Ext#define).

 Ext.define('My.Base', {
     constructor: function (x) {
         this.x = x;
     },

     statics: {
         method: function (x) {
             return x;
         }
     }
 });

 Ext.define('My.Derived', {
     extend: 'My.Base',

     constructor: function () {
         this.callParent([21]);
     }
 });

 var obj = new My.Derived();

 alert(obj.x);  // alerts 21

This can be used with an override as follows:

 Ext.define('My.DerivedOverride', {
     override: 'My.Derived',

     constructor: function (x) {
         this.callParent([x*2]); // calls original My.Derived constructor
     }
 });

 var obj = new My.Derived();

 alert(obj.x);  // now alerts 42

This also works with static and private methods.

 Ext.define('My.Derived2', {
     extend: 'My.Base',

     // privates: {
     statics: {
         method: function (x) {
             return this.callParent([x*2]); // calls My.Base.method
         }
     }
 });

 alert(My.Base.method(10));     // alerts 10
 alert(My.Derived2.method(10)); // alerts 20

Lastly, it also works with overridden static methods.

 Ext.define('My.Derived2Override', {
     override: 'My.Derived2',

     // privates: {
     statics: {
         method: function (x) {
             return this.callParent([x*2]); // calls My.Derived2.method
         }
     }
 });

 alert(My.Derived2.method(10); // now alerts 40

To override a method and replace it and also call the superclass method, use method-callSuper. This is often done to patch a method to fix a bug.

Parameters

args :  Array/Arguments

The arguments, either an array or the arguments object from the current method, for example: this.callParent(arguments)

Returns

:Object

Returns the result of calling the parent method

callSuper ( args ) : Object
protected pro

This method is used by an override to call the superclass method but bypass any overridden method. This is often done to "patch" a method that contains a bug but for whatever reason cannot be fixed directly.

Consider:

 Ext.define('Ext.some.Class', {
     method: function () {
         console.log('Good');
     }
 });

 Ext.define('Ext.some.DerivedClass', {
     extend: 'Ext.some.Class',

     method: function () {
         console.log('Bad');

         // ... logic but with a bug ...

         this.callParent();
     }
 });

To patch the bug in Ext.some.DerivedClass.method, the typical solution is to create an override:

 Ext.define('App.patches.DerivedClass', {
     override: 'Ext.some.DerivedClass',

     method: function () {
         console.log('Fixed');

         // ... logic but with bug fixed ...

         this.callSuper();
     }
 });

The patch method cannot use method-callParent to call the superclass method since that would call the overridden method containing the bug. In other words, the above patch would only produce "Fixed" then "Good" in the console log, whereas, using callParent would produce "Fixed" then "Bad" then "Good".

Parameters

args :  Array/Arguments

The arguments, either an array or the arguments object from the current method, for example: this.callSuper(arguments)

Returns

:Object

Returns the result of calling the superclass method

center Ext.Component
chainable ch

Center this cfg-floated or positioned Component in its parent.

Returns

:Ext.Component

this

clearDelegatedListeners
private pri

Clears all listeners that were attached using the "delegate" event option. Users should not invoke this method directly. It is called automatically as part of normal clearListeners processing.

clearInvalid
deprecated dep

Mark field as valid.

Available since: 6.5.0

Deprecated since version 6.5.0
Use setError(null) instead. (for classic compatibility)

clearListeners

Removes all listeners for this object including the managed listeners

clearManagedListeners

Removes all managed listeners for this object.

clearValue

Clears the value of this field.

collapseIf ( e )
private pri

Runs on touchstart of doc to check to see if we should collapse the picker.

Parameters

e :  Object

completeEdit
protected pro

Called when focus leaves this input field. Used to postprocess raw values and perform conversion and validation.

constructor ( config )

Creates new Component.

Parameters

config :  Object

The standard configuration object.

createPlugin ( config ) : Ext.plugin.Abstract
private pri

Converts the provided type or config object into a plugin instance.

Parameters

config :  String/Object/Ext.plugin.Abstract

The plugin type, config object or instance.

Returns

:Ext.plugin.Abstract

createRelayer ( newName, [beginEnd] ) : Function
private pri

Creates an event handling function which re-fires the event from this object as the passed event name.

Parameters

newName :  String

The name under which to re-fire the passed parameters.

beginEnd :  Array (optional)

The caller can specify on which indices to slice.

Returns

:Function

createSelectionRecord ( data ) : Ext.data.Model
template tpl

This method is called to create a temporary record when the value entered does not match a record in the store (when forceSelection is false).

The data object passed contains the typed value in both the valueField and the displayField.

The record created and returned from this method will be the selection value in this non-matching state.

Available since: 6.5.1

Parameters

data :  Object

The data object used to create the new record.

Returns

:Ext.data.Model

The new record.

This is a template method. a hook into the functionality of this class. Feel free to override it in child classes.

createTrigger ( name, trigger )
private pri

Parameters

name :  Object

trigger :  Object

destroy

Destroys the Widget. This method should not be overridden in custom Widgets, because it sets the flags and does final cleanup that must go last. Instead, override doDestroy method to add functionality at destruction time.

destroyMembers ( args )

Destroys member properties by name.

If a property name is the name of a config, the getter is not invoked, so if the config has not been initialized, nothing will be done.

The property will be destroyed, and the corrected name (if the property is a config and config names are prefixed) will set to null in this object's dictionary.

Parameters

args :  String...

One or more names of the properties to destroy and remove from the object.

destroyPlugin ( plugin ) : Ext.plugin.Abstract

Removes and destroys a plugin.

Note: Not all plugins are designed to be removable. Consult the documentation for the specific plugin in question to be sure.

Available since: 6.2.0

Parameters

plugin :  String/Ext.plugin.Abstract

The plugin or its id to remove.

Returns

:Ext.plugin.Abstract

plugin instance or null if not found.

didValueChange ( newVal, oldVal )
private pri

Checks if the value has changed. Allows subclasses to override for any more complex logic.

Parameters

newVal :  Object

oldVal :  Object

disable

Disables this Component

doAddListener ( name, fn, scope, options, order, caller, manager )
private pri

Parameters

name :  Object

fn :  Object

scope :  Object

options :  Object

order :  Object

caller :  Object

manager :  Object

doDestroy

Perform the actual destruction sequence. This is the method to override in your subclasses to add steps specific to the destruction of custom Component.

If the Component is currently added to a Container it will first be removed from that Container. All Ext.Element references are also deleted and the Component is de-registered from Ext.ComponentManager.

As a rule of thumb, subclasses should destroy their child Components, Elements, and/or other objects before calling parent method. Any object references will be nulled after this method has finished, to prevent the possibility of memory leaks.

Available since: 6.2.0

doFilter ( query ) : Boolean

Executes a query to filter the dropdown list. Fires the beforequery event prior to performing the query allowing the query action to be canceled if needed.

Parameters

query :  Object

An object containing details about the query to be executed.

query :  String (optional)

The query value to be used to match against the ComboBox's textField. If not present, the primary textfield filter is disabled.

force :  Boolean

If true, causes the query to be executed even if the minChars threshold is not met.

Returns

:Boolean

true if the query resulted in picker expansion.

doFireDelegatedEvent ( eventName, args )
private pri

Fires a delegated event. Users should not invoke this method directly. It is called automatically by the framework as needed (see the "delegate" event option of addListener for more details.

Parameters

eventName :  Object

args :  Object

doFireEvent ( eventName, args, bubbles )
private pri

Continue to fire event.

Parameters

eventName :  String

args :  Array

bubbles :  Boolean

doKeyUp ( me, e )
private pri

Called when a key has been pressed in the <input>

Parameters

me :  Object

e :  Object

doRawFilter
private pri

Execute the query with the raw contents within the textfield.

doValidate ( value, errors, [skipLazy] )
private pri

This method is called by validate if the value is both non-empty (not null, undefined or '') and if the value can be parsed by the parseValue method. This parsing concern is technically only in play for Ext.field.Text and derived classes (such as Ext.field.Date and Ext.field.Number) but the guarantee here is that the value will be a parsed value and not the raw string and if the value cannot be parsed, this method will not be called.

Parameters

value :  Mixed

The (parsed) value

errors :  String[]

The array of validation errors

skipLazy :  Boolean (optional)

false (the default) to run all validators.

enable

Enables this Component

enableBubble ( eventNames )

Enables events fired by this Observable to bubble up an owner hierarchy by calling this.getBubbleTarget() if present. There is no implementation in the Observable base class.

This is commonly used by Ext.Components to bubble events to owner Containers. See Ext.Component#getBubbleTarget. The default implementation in Ext.Component returns the Component's immediate owner. But if a known target is required, this can be overridden to access the required target more quickly.

Example:

Ext.define('Ext.overrides.form.field.Base', {
    override: 'Ext.form.field.Base',

    //  Add functionality to Field's initComponent to enable the change event to bubble
    initComponent: function () {
        this.callParent();
        this.enableBubble('change');
    }
});

var myForm = Ext.create('Ext.form.Panel', {
    title: 'User Details',
    items: [{
        ...
    }],
    listeners: {
        change: function() {
            // Title goes red if form has been modified.
            myForm.header.setStyle('color', 'red');
        }
    }
});

Parameters

eventNames :  String/String[]

The event name to bubble, or an Array of event names.

findFloatParent ( needsShow )
private pri

The method finds this floated component's floatParent. That means a DOM positioning container which acts as a root element for sibling floated components, and allows allows floated components to be absolutely positioned, and their encapsulating elements to be reordered to produce a visual stacking effect.

This component's element is appended to its floatParent.

There is a global floatParent element, created on demand when the first top level floated component is shown. This may be an item child of a container configured with cfg-floated: true, or a free floated component which is programatically shown.

Child items of components inside a floated component may also be configured floated. These are give a floatParent which is created on demand wrapping the nearest floated ancestor. This means that when that ancestor's element is brought to the top of the stack (by moving its element to the end of its own floatParent), the descendant elements will automatically remain above.

Parameters

needsShow :  Object

findFocusTarget Ext.Component
private pri

Finds an alternate Component to focus if this Component is disabled while focused, or focused while disabled, or otherwise unable to focus.

In both cases, focus must not be lost to document.body, but must move to an intuitively connectible Component, either a sibling, or uncle or nephew.

This is both for the convenience of keyboard users, and also for when focus is tracked within a Component tree such as for ComboBoxes and their dropdowns.

For example, a ComboBox with a PagingToolbar in is BoundList. If the "Next Page" button is hit, the LoadMask shows and focuses, the next page is the last page, so the "Next Page" button is disabled. When the LoadMask hides, it attempt to focus the last focused Component which is the disabled "Next Page" button. In this situation, focus should move to a sibling within the PagingToolbar.

Returns

:Ext.Component

A closely related focusable Component to which focus can move.

findPlugin ( type ) : Ext.plugin.Abstract

Retrieves plugin by its type alias. For example:

 var list = Ext.create({
     xtype: 'list',
     itemTpl: '<div class="item">{title}</div>',
     store: 'Items',

     plugins: ['listpaging', 'pullrefresh']
 });

 list.findPlugin('pullrefresh').setPullRefreshText('Pull to refresh...');

Note: See also getPlugin.

Available since: 6.2.0

Parameters

type :  String

The Plugin's type as specified by the class's alias configuration.

Returns

:Ext.plugin.Abstract

plugin instance or null if not found.

findRecordByDisplay ( value ) : Ext.data.Model/false

Finds the record by searching values in the displayField.

Parameters

value :  Object

The value to match the field against.

Returns

:Ext.data.Model/false

The matched record or false.

findRecordByValue ( value ) : Ext.data.Model

Finds the record in the store, or the valueCollection which has the valueField matching the passed value.

The valueCollection is included because of the createNewOnEnter, createNewOnBlur, and forceSelection configs which allow for insertion into the valueCollection of newly created records which are not in the configured store.

Also, a currently selected value may be filtered out of visibility in the configured store

Parameters

value :  String

The value to match the valueField against.

Returns

:Ext.data.Model

The matched record or null.

fireAction ( eventName, args, fn, [scope], [options], [order] )
deprecated dep

Fires the specified event with the passed parameters and executes a function (action). By default, the action function will be executed after any "before" event handlers (as specified using the order option of addListener), but before any other handlers are fired. This gives the "before" handlers an opportunity to cancel the event by returning false, and prevent the action function from being called.

The action can also be configured to run after normal handlers, but before any "after" handlers (as specified using the order event option) by passing 'after' as the order parameter. This configuration gives any event handlers except for "after" handlers the opportunity to cancel the event and prevent the action function from being called.

Parameters

eventName :  String

The name of the event to fire.

args :  Array

Arguments to pass to handlers and to the action function.

fn :  Function

The action function.

scope :  Object (optional)

The scope (this reference) in which the handler function is executed. If omitted, defaults to the object which fired the event.

options :  Object (optional)

Event options for the action function. Accepts any of the options of addListener

order :  String (optional)

The order to call the action function relative too the event handlers ('before' or 'after'). Note that this option is simply used to sort the action function relative to the event handlers by "priority". An order of 'before' is equivalent to a priority of 99.5, while an order of 'after' is equivalent to a priority of -99.5. See the priority option of addListener for more details.

Defaults to: 'before'

Deprecated since version 5.5
Use fireEventedAction instead.

fireEvent ( eventName, args ) : Boolean

Fires the specified event with the passed parameters (minus the event name, plus the options object passed to addListener).

An event may be set to bubble up an Observable parent hierarchy (See Ext.Component#getBubbleTarget) by calling enableBubble.

Parameters

eventName :  String

The name of the event to fire.

args :  Object...

Variable number of parameters are passed to handlers.

Returns

:Boolean

returns false if any of the handlers return false otherwise it returns true.

fireEventArgs ( eventName, args ) : Boolean

Fires the specified event with the passed parameter list.

An event may be set to bubble up an Observable parent hierarchy (See Ext.Component#getBubbleTarget) by calling enableBubble.

Parameters

eventName :  String

The name of the event to fire.

args :  Object[]

An array of parameters which are passed to handlers.

Returns

:Boolean

returns false if any of the handlers return false otherwise it returns true.

fireEventedAction ( eventName, args, fn, [scope], [fnArgs] ) : Boolean

Fires the specified event with the passed parameters and executes a function (action). Evented Actions will automatically dispatch a 'before' event passing. This event will be given a special controller that allows for pausing/resuming of the event flow.

By pausing the controller the updater and events will not run until resumed. Pausing, however, will not stop the processing of any other before events.

Parameters

eventName :  String

The name of the event to fire.

args :  Array

Arguments to pass to handlers and to the action function.

fn :  Function/String

The action function.

scope :  Object (optional)

The scope (this reference) in which the handler function is executed. If omitted, defaults to the object which fired the event.

fnArgs :  Array/Boolean (optional)

Optional arguments for the action fn. If not given, the normal args will be used to call fn. If false is passed, the args are used but if the first argument is this instance it will be removed from the args passed to the action function.

Returns

:Boolean

fireKey ( e )
private pri

Parameters

e :  Object

focus ( [selectText] ) : Boolean

Try to focus this component.

If this component is disabled or otherwise not focusable, a close relation will be targeted for focus instead to keep focus localized for keyboard users.

Parameters

selectText :  Boolean/Number[] (optional)

If applicable, true to also select all the text in this component, or an array consisting of start and end (defaults to start) position of selection.

Returns

:Boolean

true if focus target was found and focusing was attempted, false if no focusing attempt was made.

formatErrors ( errors ) : String
protected pro

Formats the given error(s) based on the given errorTpl and the specified errorTarget.

Available since: 6.5.0

Parameters

errors :  String[]

Returns

:String

getAlignRegion ( component, alignment, options )
private pri

Parameters

component :  Object

alignment :  Object

options :  Object

getAlignmentInfo ( component, alignment )
protected pro

Prepares information on aligning this to component using alignment. Also checks to see if this is already aligned to component according to alignment.

Parameters

component :  Object

alignment :  Object

getAriaLabelEl ( [reference] ) : Ext.dom.Element
private pri

Find component(s) that label or describe this component, and return the id(s) of their ariaEl elements.

Parameters

reference :  Function/String/String[] (optional)

Component reference, or array of component references, or a function that should return the proper attribute string. The function will be called in the context of the labelled component.

Returns

:Ext.dom.Element

Element id string, or null

getBubbleParent Ext.util.Observable
private pri

Gets the bubbling parent for an Observable

Returns

:Ext.util.Observable

The bubble parent. null is returned if no bubble target exists

getConfig ( [name], [peek], [ifInitialized] ) : Object

Returns a specified config property value. If the name parameter is not passed, all current configuration options will be returned as key value pairs.

Parameters

name :  String (optional)

The name of the config property to get.

peek :  Boolean (optional)

true to peek at the raw value without calling the getter.

Defaults to: false

ifInitialized :  Boolean (optional)

true to only return the initialized property value, not the raw config value, and not to trigger initialization. Returns undefined if the property has not yet been initialized.

Defaults to: false

Returns

:Object

The config property value.

getCurrentAlignmentInfo
private pri

Current Alignment information from the last alignTo call

getElementConfig Object
protected pro

A template method for modifying the element config before it is processed. By default adds the result of this.getTemplate() as the children array of element if children were not specified in the original element config. Typically this method should not need to be implemented in subclasses. Instead the element property should be use to configure the element template for a given Widget subclass.

This method is called once when the first instance of each Widget subclass is created. The element config object that is returned is cached and used as the template for all successive instances. The scope object for this method is the class prototype, not the instance.

Returns

:Object

the element config object

getFloatParent Ext.Component
private pri

For cfg-floated components only.

Finds the owning cfg-floated component (if any) responsible for the base z-index stack position of this compoonent, and, if that component is cfg-relative, for the coordinate system in which this component is positioned.

If this is a top level floated component, this method will return null

Returns

:Ext.Component

The owning floated component or null if this component is top level floated.

getFloatWrap Ext.dom.Element
private pri

This method returns, or creates on demand the floatWrap element which wraps the passed floated component. It enables that floated component to act as a host for descendant floated components.

Returns

:Ext.dom.Element

The passed component's floatWrap element.

getFocusClsEl ( [focusEl] ) : Ext.dom.Element
protected pro

Returns the element used to apply focus styling CSS class when Focusable's focusEl becomes focused. By default it is focusEl.

Parameters

focusEl :  Ext.dom.Element (optional)

Return focus styling element for the given focused element. This is used by Components implementing multiple focusable elements.

Returns

:Ext.dom.Element

The focus styling element.

getFocusEl Ext.dom.Element
protected pro

Returns the main focus holder element associated with this Focusable, i.e. the element that will be focused when Focusable's focus method is called. For most Focusables, this will be the focusEl.

Returns

:Ext.dom.Element

getInherited ( [inner] ) : Object

This method returns an object containing the inherited properties for this instance.

Available since: 5.0.0

Parameters

inner :  Boolean (optional)

Pass true to return inheritedStateInner instead of the normal inheritedState object. This is only needed internally and should not be passed by user code.

Defaults to: false

Returns

:Object

The inheritedState object containing inherited properties.

getInheritedConfig ( property, [skipThis] ) : Mixed

This method returns the value of a config property that may be inherited from some ancestor.

In some cases, a config may be explicitly set on a component with the intent of only being presented to its children while that component should act upon the inherited value (see referenceHolder for example). In these cases the skipThis parameter should be specified as true.

Available since: 5.0.0

Parameters

property :  String

The name of the config property to return.

skipThis :  Boolean (optional)

Pass true if the property should be ignored if found on this instance. In other words, true means the property must be inherited and not explicitly set on this instance.

Defaults to: false

Returns

:Mixed

The value of the requested property.

getInitialConfig ( [name] ) : Object/Mixed

Returns the initial configuration passed to the constructor when instantiating this class.

Given this example Ext.button.Button definition and instance:

Ext.define('MyApp.view.Button', {
    extend: 'Ext.button.Button',
    xtype: 'mybutton',

    scale: 'large',
    enableToggle: true
});

var btn = Ext.create({
    xtype: 'mybutton',
    renderTo: Ext.getBody(),
    text: 'Test Button'
});

Calling btn.getInitialConfig() would return an object including the config options passed to the create method:

xtype: 'mybutton',
renderTo: // The document body itself
text: 'Test Button'

Calling btn.getInitialConfig('text')returns 'Test Button'.

Parameters

name :  String (optional)

Name of the config option to return.

Returns

:Object/Mixed

The full config object or a single config value when name parameter specified.

getModalSibling
private pri

Returns the topmost modal floated component (other then this one).

getPlugin ( id ) : Ext.plugin.Abstract

Retrieves a plugin by its id.

 var list = Ext.create({
     xtype: 'list',
     itemTpl: '<div class="item">{title}</div>',
     store: 'Items',

     plugins: [{
         type: 'pullrefresh',
         id: 'foo'
     }]
 });

 list.getPlugin('foo').setPullRefreshText('Pull to refresh...');

Note: See also findPlugin.

Available since: 6.2.0

Parameters

id :  String

The id of the plugin.

Returns

:Ext.plugin.Abstract

plugin instance or null if not found.

getRecordDisplayData ( record ) : Object
template tpl protected pro

Gets data for each record to be used for constructing the display value with the displayTpl. This may be overridden to provide access to associated records.

Parame