<ExtGrid/> Ext.grid.Grid

store : store / Object

required req

<ExtGrid store="{ }" />

let element = document.body.querySelector('ExtGrid');
element.store = { };
let store = element.store;

Can be either a Store instance or a configuration object that will be turned into a Store. The Store is used to populate the set of items that will be rendered in the DataView. See the DataView intro documentation for more information about the relationship between Store and DataView.

Defaults to:

undefined

activeChildTabIndex : Number

immutable imm

<ExtGrid activeChildTabIndex="10" />

let element = document.body.querySelector('ExtGrid');
element.activeChildTabIndex = 10;
let activeChildTabIndex = element.activeChildTabIndex;

DOM tabIndex attribute to set on the active Focusable child of this container when using the "Roaming tabindex" technique.

Defaults to:

0

activeItem : <ExtComponent/> / Object / String / Number

<ExtGrid activeItem="value" />

let element = document.body.querySelector('ExtGrid');
element.activeItem = 'value';
let activeItem = element.activeItem;

The item from the cfg-items collection that will be active first. This is usually only meaningful in a Ext.layout.Card, where only one item can be active at a time. If passed a string, it will be assumed to be a Ext.ComponentQuery selector. A number will reference an index or a <ExtComponent/> instance may be passed as well. An object config will be created as a new component.

Defaults to:

0

alignSelf : String

<ExtGrid alignSelf="value" />

let element = document.body.querySelector('ExtGrid');
element.alignSelf = 'value';
let alignSelf = element.alignSelf;

Specifies the self alignment of this widget in a box layout

Defaults to:

null

allowFocusingDisabledChildren : Boolean

immutable imm

<ExtGrid allowFocusingDisabledChildren="true" />

let element = document.body.querySelector('ExtGrid');
element.allowFocusingDisabledChildren = true;
let allowFocusingDisabledChildren = element.allowFocusingDisabledChildren;

Set this to true to enable focusing disabled child items via keyboard.

Defaults to:

false

alwaysOnTop : Boolean / Number

<ExtGrid alwaysOnTop="true" />

let element = document.body.querySelector('ExtGrid');
element.alwaysOnTop = true;
let alwaysOnTop = element.alwaysOnTop;

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

ariaAttributes : Object

<ExtGrid ariaAttributes="{ }" />

let element = document.body.querySelector('ExtGrid');
element.ariaAttributes = { };
let ariaAttributes = element.ariaAttributes;

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

ariaDescribedBy : String

immutable imm

<ExtGrid ariaDescribedBy="value" />

let element = document.body.querySelector('ExtGrid');
element.ariaDescribedBy = 'value';
let ariaDescribedBy = element.ariaDescribedBy;

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

immutable imm

<ExtGrid ariaLabel="value" />

let element = document.body.querySelector('ExtGrid');
element.ariaLabel = 'value';
let ariaLabel = element.ariaLabel;

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

immutable imm

<ExtGrid ariaLabelledBy="value" />

let element = document.body.querySelector('ExtGrid');
element.ariaLabelledBy = 'value';
let ariaLabelledBy = element.ariaLabelledBy;

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.

ariaRole : String

readonly ro

<ExtGrid ariaRole="value" />

let element = document.body.querySelector('ExtGrid');
let ariaRole = element.ariaRole;

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

associatedData : Boolean / Object

<ExtGrid associatedData="true" />

let element = document.body.querySelector('ExtGrid');
element.associatedData = true;
let associatedData = element.associatedData;

Set this config to false to limit rendering data to just the record's data or to an object to describe the desired associated data. This data is used to satisfy the itemTpl. The default of true will gather all associated data that is currently loaded. This can be expensive. If only a small amount of the available data is needed, this config can speed up the rendering process.

For example, if an OrderItem needs the Item data but not its parent Order, this config can be set like so:

 associatedData: {
     item: true
 }

Given the above, only the item association (to the Item record) will be gathered into the render data.

For more details, see getData.

Defaults to:

true

Available since: 6.5.0

autoDestroy : Boolean

<ExtGrid autoDestroy="true" />

let element = document.body.querySelector('ExtGrid');
element.autoDestroy = true;
let autoDestroy = element.autoDestroy;

If true, child items will be destroyed as soon as they are removed from this container.

Defaults to:

true

autoSize : Boolean

<ExtGrid autoSize="true" />

let element = document.body.querySelector('ExtGrid');
element.autoSize = true;
let autoSize = element.autoSize;

May be set to false for improved layout performance if auto-sizing is not required.

Some versions of Safari, both desktop and mobile, have very slow performance if the application has deeply nested containers due to the following WebKit bug: https://bugs.webkit.org/show_bug.cgi?id=150445

Applications that experience performance issues in the affected versions of Safari may need to turn off autoSizing globally for all <ExtContainer/> instances by placing the following override in the application's "overrides" directory:

Ext.define('MyApp.overrides.Container', {
    override: 'Ext.Container',
    config: {
        autoSize: false
    }
});

Once auto-sizing support has turned off by default, it can be selectively turned back on only on those container instances that explicitly need auto-sizing behavior by setting autoSize to true.

This option can also be used to allow items to be sized in percentage units as a workaround for the following browser bug: https://bugs.webkit.org/show_bug.cgi?id=137730

To illustrate, the following example should render a 200px by 200px green box (the container) with a yellow box inside of it (the child item). The child item's height and width are both set to '50%' so the child should render exactly 100px by 100px in size.

Ext.create({
    xtype: 'container',
    renderTo: Ext.getBody(),
    height: 200,
    width: 200,
    style: 'background: green',
    items: [{
        xtype: 'component',
        style: 'background: yellow',
        height: '50%',
        width: '50%'
    }]
});

All browsers except for Safari render the previous example correctly, but Safari does not assign a height to the component. To make percentage-sized items work in Safari, simply set autoSize to false on the container.

Since the underlying implementation works by absolutely positioning the container's body element, this option can only be used when the container is not "shrink wrapping" the content in either direction. When autoSize is set to false, shrink wrapped dimension(s) will collapse to 0.

Defaults to:

null

axisLock : Boolean

<ExtGrid axisLock="true" />

let element = document.body.querySelector('ExtGrid');
element.axisLock = true;
let axisLock = element.axisLock;

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

bind : Object / String

<ExtGrid bind="value" />

let element = document.body.querySelector('ExtGrid');
element.bind = 'value';
let bind = element.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

bodyCls : String / String[]

<ExtGrid bodyCls="value" />

let element = document.body.querySelector('ExtGrid');
element.bodyCls = 'value';
let bodyCls = element.bodyCls;

The CSS class to add to this container's body element.

Defaults to:

null

Available since: 7.0

border : Boolean

<ExtGrid border="true" />

let element = document.body.querySelector('ExtGrid');
element.border = true;
let border = element.border;

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

bottom : Number / String

<ExtGrid bottom="value" />

let element = document.body.querySelector('ExtGrid');
element.bottom = 'value';
let bottom = element.bottom;

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

bufferSize : Number

<ExtGrid bufferSize="10" />

let element = document.body.querySelector('ExtGrid');
element.bufferSize = 10;
let bufferSize = element.bufferSize;

The number of items an infinite list will render beyond those immediately visible.

To prevent the rendering of items while scrolling, these extra items are rendered out of view. When the scroller approaches within minimumBufferSize of the end of the rendered range, the extra items trailing the scroll will be repositioned (and reconfigured) ahead of the scroll.

Defaults to:

20

centered : Boolean

<ExtGrid centered="true" />

let element = document.body.querySelector('ExtGrid');
element.centered = true;
let centered = element.centered;

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

cls : String / String[]

<ExtGrid cls="value" />

let element = document.body.querySelector('ExtGrid');
element.cls = 'value';
let cls = element.cls;

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 <ExtContainer/>).

Defaults to:

null

collapseDefaults : Ext.dataview.ListCollapser / Object

<ExtGrid collapseDefaults="{ }" />

let element = document.body.querySelector('ExtGrid');
element.collapseDefaults = { };
let collapseDefaults = element.collapseDefaults;

This config object supplies default for the collapsible config. When that config is simply true, this is the complete config object for the group collapser.

NOTE: This config cannot be changed after instantiation. Instead, change the collapsible config.

Defaults to:

{
    xclass: 'Ext.dataview.ListCollapser'
}

Available since: 7.0

collapsible : Ext.dataview.ListCollapser / Object / Boolean

<ExtGrid collapsible="true" />

let element = document.body.querySelector('ExtGrid');
element.collapsible = true;
let collapsible = element.collapsible;

This object configures group collapse. It is only applicable when grouped. Set to false to disable group collapsibility. The default value of true uses the collapseDefaults config for the final collapser configuration object. If this config is an object, it is merged with collapseDefaults giving this object's properties priority over the defaults.

Defaults to:

true

Available since: 7.0

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

<ExtGrid constrainAlign="value" />

let element = document.body.querySelector('ExtGrid');
element.constrainAlign = 'value';
let constrainAlign = element.constrainAlign;

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

containsFocus : Boolean

readonly ro

<ExtGrid containsFocus="true" />

let element = document.body.querySelector('ExtGrid');
let containsFocus = element.containsFocus;

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

contentEl : Ext.dom.Element / HTMLElement / String

<ExtGrid contentEl="value" />

let element = document.body.querySelector('ExtGrid');
element.contentEl = 'value';
let contentEl = element.contentEl;

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

controller : String / Object / Ext.app.ViewController

<ExtGrid controller="value" />

let element = document.body.querySelector('ExtGrid');
element.controller = 'value';
let controller = element.controller;

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

data : Object

<ExtGrid data="{ }" />

let element = document.body.querySelector('ExtGrid');
element.data = { };
let data = element.data;

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

defaultBindProperty : String

readonly ro

<ExtGrid defaultBindProperty="value" />

let element = document.body.querySelector('ExtGrid');
element.defaultBindProperty = 'value';
let defaultBindProperty = element.defaultBindProperty;

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:

'store'

defaultFocus : String

<ExtGrid defaultFocus="value" />

let element = document.body.querySelector('ExtGrid');
element.defaultFocus = 'value';
let defaultFocus = element.defaultFocus;

Specifies a child Component to receive focus when this Container's method-focus method is called. Should be a valid Ext.ComponentQuery selector.

Defaults to:

null

defaultListenerScope : Boolean

<ExtGrid defaultListenerScope="true" />

let element = document.body.querySelector('ExtGrid');
element.defaultListenerScope = true;
let defaultListenerScope = element.defaultListenerScope;

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

defaults : Object

<ExtGrid defaults="{ }" />

let element = document.body.querySelector('ExtGrid');
element.defaults = { };
let defaults = element.defaults;

A set of default configurations to apply to all child Components in this Container. It's often useful to specify defaults when creating more than one items with similar configurations. For example here we can specify that each child is a panel and avoid repeating the xtype declaration for each one:

Ext.create({
    xtype: 'container',
    defaults: {
        xtype: 'panel'
    },
    items: [
        {
            html: 'Panel 1'
        },
        {
            html: 'Panel 2'
        }
    ]
});

Defaults to:

null

deferEmptyText : Boolean

<ExtGrid deferEmptyText="true" />

let element = document.body.querySelector('ExtGrid');
element.deferEmptyText = true;
let deferEmptyText = element.deferEmptyText;

Set to false to not defer emptyText being applied until the store's first load.

Defaults to:

true

deselectOnContainerClick : Boolean

<ExtGrid deselectOnContainerClick="true" />

let element = document.body.querySelector('ExtGrid');
element.deselectOnContainerClick = true;
let deselectOnContainerClick = element.deselectOnContainerClick;

When set to true, tapping on the DataView's background (i.e. not on an item in the DataView) will deselect any currently selected items.

Defaults to:

true

destroyed : Boolean

readonly ro

<ExtGrid destroyed="true" />

let element = document.body.querySelector('ExtGrid');
element.destroyed = true;
let destroyed = element.destroyed;

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

Defaults to:

false

disableSelection : Boolean

<ExtGrid disableSelection="true" />

let element = document.body.querySelector('ExtGrid');
element.disableSelection = true;
let disableSelection = element.disableSelection;

Set to true to disable selection styling. This only affects the presentation of the selection not the internal selection state.

Defaults to:

false

disabled : Boolean

<ExtGrid disabled="true" />

let element = document.body.querySelector('ExtGrid');
element.disabled = true;
let disabled = element.disabled;

Whether or not this component is disabled

Defaults to:

null

disclosureProperty : String

<ExtGrid disclosureProperty="value" />

let element = document.body.querySelector('ExtGrid');
element.disclosureProperty = 'value';
let disclosureProperty = element.disclosureProperty;

A property to check on each record to display the disclosure on a per record basis. This property must be false to prevent the disclosure from being displayed on the item.

Defaults to:

'disclosure'

displayed : Boolean

<ExtGrid displayed="true" />

let element = document.body.querySelector('ExtGrid');
element.displayed = true;
let displayed = element.displayed;

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

docked : String

<ExtGrid docked="value" />

let element = document.body.querySelector('ExtGrid');
element.docked = 'value';
let docked = element.docked;

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

draggable : Boolean / Object / Ext.drag.Source

<ExtGrid draggable="true" />

let element = document.body.querySelector('ExtGrid');
element.draggable = true;
let draggable = element.draggable;

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

emptyItemText : String

<ExtGrid emptyItemText="value" />

let element = document.body.querySelector('ExtGrid');
element.emptyItemText = 'value';
let emptyItemText = element.emptyItemText;

The text to render when the rendering of the item via itemTpl produces no text.

Defaults to:

'\xa0'

emptyText : String / Boolean

<ExtGrid emptyText="true" />

let element = document.body.querySelector('ExtGrid');
element.emptyText = true;
let emptyText = element.emptyText;

The text to display in the view when there is no data to display. Set this to true to display the default message.

Defaults to:

null

emptyTextDefaults : Object / <ExtComponent/>

<ExtGrid emptyTextDefaults="{ }" />

let element = document.body.querySelector('ExtGrid');
element.emptyTextDefaults = { };
let emptyTextDefaults = element.emptyTextDefaults;

This component config object is used to create the emptyText component.

Defaults to:

{
    xtype: 'emptytext'
}

Available since: 6.5.0

emptyTextProperty : String

immutable imm

<ExtGrid emptyTextProperty="value" />

let element = document.body.querySelector('ExtGrid');
element.emptyTextProperty = 'value';
let emptyTextProperty = element.emptyTextProperty;

The config to set on the emptyText component to contain the desired text.

Defaults to:

'html'

Available since: 6.5.0

factoryConfig : Object

readonly ro

<ExtGrid factoryConfig="{ }" />

let element = document.body.querySelector('ExtGrid');
element.factoryConfig = { };
let factoryConfig = element.factoryConfig;

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

flex : Number / String / Object

<ExtGrid flex="value" />

let element = document.body.querySelector('ExtGrid');
element.flex = 'value';
let flex = element.flex;

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

floated : Boolean

<ExtGrid floated="true" />

let element = document.body.querySelector('ExtGrid');
element.floated = true;
let floated = element.floated;

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

floatingCls : String

readonly ro

<ExtGrid floatingCls="value" />

let element = document.body.querySelector('ExtGrid');
element.floatingCls = 'value';
let floatingCls = element.floatingCls;

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

Defaults to:

Ext.baseCSSPrefix + 'floating'

focusCls : String

immutable imm

<ExtGrid focusCls="value" />

let element = document.body.querySelector('ExtGrid');
element.focusCls = 'value';
let focusCls = element.focusCls;

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

Defaults to:

'x-focused'

focusClsEl : Ext.dom.Element

readonly ro

<ExtGrid focusClsEl="value" />

let element = document.body.querySelector('ExtGrid');
element.focusClsEl = 'value';
let focusClsEl = element.focusClsEl;

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

focusEl : Ext.dom.Element

readonly ro

<ExtGrid focusEl="value" />

let element = document.body.querySelector('ExtGrid');
element.focusEl = 'value';
let focusEl = element.focusEl;

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'

focusable : Boolean

readonly ro

<ExtGrid focusable="true" />

let element = document.body.querySelector('ExtGrid');
element.focusable = true;
let focusable = element.focusable;

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:

true

focusableContainer : Boolean

immutable imm

<ExtGrid focusableContainer="true" />

let element = document.body.querySelector('ExtGrid');
element.focusableContainer = true;
let focusableContainer = element.focusableContainer;

Enable or disable navigation with arrow keys for this FocusableContainer. This option may be useful with nested FocusableContainers, when only the root container should handle keyboard events.

Defaults to:

false

focusableContainerEl : String / Ext.dom.Element

readonly ro

<ExtGrid focusableContainerEl="value" />

let element = document.body.querySelector('ExtGrid');
element.focusableContainerEl = 'value';
let focusableContainerEl = element.focusableContainerEl;

The name of the element that FocusableContainer should bind its keyboard handler to. Similar to ariaEl, this name is resolved to the Ext.dom.Element instance after rendering.

Defaults to:

"el"

fullscreen : Boolean

immutable imm

<ExtGrid fullscreen="true" />

let element = document.body.querySelector('ExtGrid');
element.fullscreen = true;
let fullscreen = element.fullscreen;

Force the component to take up 100% width and height available, by adding it to Ext.Viewport.

groupFooter : Object / <ExtItemheader/>

<ExtGrid groupFooter="{ }" />

let element = document.body.querySelector('ExtGrid');
element.groupFooter = { };
let groupFooter = element.groupFooter;

The counterpart to groupHeader, this config controls the footer that is displayed below each group in a grouped list.

Footers are typically hidden when a group is collapsed but this can be changed using the footer option:

 {
     xtype: 'list',
     collapsible: {
         footer: true  // show footers when collapsed
     }
 }

Defaults to:

null

Available since: 6.5.0

grouped : Boolean

<ExtGrid grouped="true" />

let element = document.body.querySelector('ExtGrid');
element.grouped = true;
let grouped = element.grouped;

Set to false turn off all grouping. This setting is only meaningful if the underlying store has a grouper.

Defaults to:

true

hasFocus : Boolean

readonly ro

<ExtGrid hasFocus="true" />

let element = document.body.querySelector('ExtGrid');
let hasFocus = element.hasFocus;

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

Defaults to:

false

hasListeners : Object

readonly ro

<ExtGrid hasListeners="{ }" />

let element = document.body.querySelector('ExtGrid');
let hasListeners = element.hasListeners;

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);
 }

height : Number / String

<ExtGrid height="value" />

let element = document.body.querySelector('ExtGrid');
element.height = 'value';
let height = element.height;

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

hidden : Boolean

<ExtGrid hidden="true" />

let element = document.body.querySelector('ExtGrid');
element.hidden = true;
let hidden = element.hidden;

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

Defaults to true for floated Components.

Defaults to:

null

hideAnimation : String / Mixed

<ExtGrid hideAnimation="value" />

let element = document.body.querySelector('ExtGrid');
element.hideAnimation = 'value';
let hideAnimation = element.hideAnimation;

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

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

<ExtGrid hideMode="value" />

let element = document.body.querySelector('ExtGrid');
element.hideMode = 'value';
let hideMode = element.hideMode;

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

• 'clip' : Hide using clip.
• 'display' : Hide using display.
• 'offsets' : Hide using positioning offsets.
• 'opacity' : Hide using opacity.
• 'visibility' : Hide using visibility.

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

hideOnMaskTap : Boolean

<ExtGrid hideOnMaskTap="true" />

let element = document.body.querySelector('ExtGrid');
element.hideOnMaskTap = true;
let hideOnMaskTap = element.hideOnMaskTap;

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

html : String / Ext.dom.Element / HTMLElement

<ExtGrid html="value" />

let element = document.body.querySelector('ExtGrid');
element.html = 'value';
let html = element.html;

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

Defaults to:

null

id : String

immutable imm

<ExtGrid id="value" />

let element = document.body.querySelector('ExtGrid');
element.id = 'value';
let id = element.id;

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 <ExtContainer/> 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.

inactiveChildTabIndex : Number

immutable imm

<ExtGrid inactiveChildTabIndex="10" />

let element = document.body.querySelector('ExtGrid');
element.inactiveChildTabIndex = 10;
let inactiveChildTabIndex = element.inactiveChildTabIndex;

DOM tabIndex attribute to set on inactive Focusable children of this container when using the "Roaming tabindex" technique. This value rarely needs to be changed from its default.

Defaults to:

-1

indexBar : Boolean / Object / <ExtIndexbar/>

<ExtGrid indexBar="true" />

let element = document.body.querySelector('ExtGrid');
element.indexBar = true;
let indexBar = element.indexBar;

Set to true to render an alphabet IndexBar docked on the right. This can also be a config object for the <ExtIndexbar/> component.

Defaults to:

null

inheritUi : Boolean / String

readonly ro

<ExtGrid inheritUi="true" />

let element = document.body.querySelector('ExtGrid');
element.inheritUi = true;
let inheritUi = element.inheritUi;

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

inline : Boolean / Object

<ExtGrid inline="true" />

let element = document.body.querySelector('ExtGrid');
element.inline = true;
let inline = element.inline;

When set to true the items within the DataView will have their display set to inline-block and be arranged horizontally. By default the items will wrap to the width of the DataView. Passing an object with { wrap: false } will turn off this wrapping behavior and overflowed items will need to be scrolled to horizontally.

Defaults to:

null

innerCls : String

<ExtGrid innerCls="value" />

let element = document.body.querySelector('ExtGrid');
element.innerCls = 'value';
let innerCls = element.innerCls;

A string to add to the immediate parent element of the inner items of this container. That is, items that are not docked, positioned or floated. In some containers, positioned items may be in this same element.

Defaults to:

null

Available since: 6.5.0

isContainer : Boolean

readonly ro

<ExtGrid isContainer="true" />

let element = document.body.querySelector('ExtGrid');
element.isContainer = true;
let isContainer = element.isContainer;

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

Defaults to:

true

isDataView : Boolean

readonly ro

<ExtGrid isDataView="true" />

let element = document.body.querySelector('ExtGrid');
element.isDataView = true;
let isDataView = element.isDataView;

true in this class to identify an object this type, or subclass thereof.

Defaults to:

true

isObservable : Boolean

readonly ro

<ExtGrid isObservable="true" />

let element = document.body.querySelector('ExtGrid');
element.isObservable = true;
let isObservable = element.isObservable;

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

Defaults to:

true

itemButtonMode : Boolean

<ExtGrid itemButtonMode="true" />

let element = document.body.querySelector('ExtGrid');
element.itemButtonMode = true;
let itemButtonMode = element.itemButtonMode;

True to cause items to act like buttons for interaction styling. in ButtonMode items will maintain pressed state whenever pressed down. they will not remove this state for tap distance cancellation or mouse out.

Defaults to:

false

itemCls : String

<ExtGrid itemCls="value" />

let element = document.body.querySelector('ExtGrid');
element.itemCls = 'value';
let itemCls = element.itemCls;

An additional CSS class to apply to items within the DataView.

Defaults to:

null

itemContentCls : String

<ExtGrid itemContentCls="value" />

let element = document.body.querySelector('ExtGrid');
element.itemContentCls = 'value';
let itemContentCls = element.itemContentCls;

A class to add to the element that immediate wraps the item content produced by the itemTpl (the "inner-html" element).

Defaults to:

null

Available since: 6.5.0

itemDataMap : Object

<ExtGrid itemDataMap="{ }" />

let element = document.body.querySelector('ExtGrid');
element.itemDataMap = { };
let itemDataMap = element.itemDataMap;

This object allows you to map Ext.data.Model fields to specific configs on component items.

The itemDataMap object's keys describe the target objects to receive data from the associated record. These keys are either '#' (for the item itself) or a reference to a component contained in the item.

For each target listed in itemDataMap, the value is another map describing the config name (in the key) and the data field name (as the value).

For example:

 itemDataMap: {
     '#': {
         title: 'fullName'
     },
     text: {
         html: 'name'
     }
 }

The above is equivalent to:

 item.setTitle(item.getRecord().get('fullName'));
 item.lookup('text').setHtml(item.getRecord().get('name'));

For more complex mapping of data to item, you should use the data binding as described in the class documentation.

Defaults to:

null

Available since: 6.5.0

itemId : String

<ExtGrid itemId="value" />

let element = document.body.querySelector('ExtGrid');
element.itemId = 'value';
let itemId = element.itemId;

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

itemInnerCls : String

<ExtGrid itemInnerCls="value" />

let element = document.body.querySelector('ExtGrid');
element.itemInnerCls = 'value';
let itemInnerCls = element.itemInnerCls;

A class to add to the inner element of items.

Defaults to:

null

Available since: 6.5.0

itemRipple : Boolean / Object

<ExtGrid itemRipple="true" />

let element = document.body.querySelector('ExtGrid');
element.itemRipple = true;
let itemRipple = element.itemRipple;

Defaults to:

null

Available since: 6.5.0

Properties

color : String

The background color of the ripple. Default ripple Ext.Widget#ripple settings for each item in the data view

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

itemTpl : String / String[] / Ext.XTemplate

<ExtGrid itemTpl="value" />

let element = document.body.querySelector('ExtGrid');
element.itemTpl = 'value';
let itemTpl = element.itemTpl;

The tpl to use for each of the items displayed in this DataView. This template produces HTML and can use the follow CSS class names to influence the response to tapping/clicking child elements:

• x-no-ripple - Disables itemRipple (primarily for theme-material)
• x-item-no-select - Disables item selection
• x-item-no-tap - Disables all click or tap processing

For example:

 itemTpl: '<div>' +
              '...' +
              '<div class="x-item-no-select x-fa fa-gear"></div>' +
              '...' +
          '</div>'

Because this template produces HTML from record data it can expose applications to security issues if user-provided data is not properly encoded. For example, in previous releases this template was:

 itemTpl: '<div>{text}</div>'

If the 'text' field contained HTML scripts, these would be evaluated into the application. The itemTpl in version 6.5 is now:

 itemTpl: '<div>{text:htmlEncode}</div>'

Defaults to:

'<div>{text:htmlEncode}</div>'

keyMap : Object

<ExtGrid keyMap="{ }" />

let element = document.body.querySelector('ExtGrid');
element.keyMap = { };
let keyMap = element.keyMap;

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.

keyMapEnabled : Boolean

<ExtGrid keyMapEnabled="true" />

let element = document.body.querySelector('ExtGrid');
element.keyMapEnabled = true;
let keyMapEnabled = element.keyMapEnabled;

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 <ExtComponent/> at the proper time, this is not something application code normally handles.

Defaults to:

null

lastKeyMapEvent : Ext.event.Event

readonly ro

<ExtGrid lastKeyMapEvent="value" />

let element = document.body.querySelector('ExtGrid');
element.lastKeyMapEvent = 'value';
let lastKeyMapEvent = element.lastKeyMapEvent;

The last key event processed is cached on the component for use in subsequent event handlers.

Available since: 6.6.0

layout : Object / String

<ExtGrid layout="value" />

let element = document.body.querySelector('ExtGrid');
element.layout = 'value';
let layout = element.layout;

Configuration for this Container's layout. Example:

Ext.create({
    xtype: 'container',
    layout: {
        type: 'hbox',
        align: 'middle'
    },
    items: [{
        xtype: 'panel',
        flex: 1,
        bodyStyle: {
            background: "#000",
            color:"#fff"
        }
    }, {
       xtype: 'panel',
       flex: 2,
       bodyStyle: {
           background: "#f00",
           color:"#fff"
       }
    }]
});

Defaults to:

'auto'

left : Number / String

<ExtGrid left="value" />

let element = document.body.querySelector('ExtGrid');
element.left = 'value';
let left = element.left;

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

listeners : Object

<ExtGrid listeners="{ }" />

let element = document.body.querySelector('ExtGrid');
element.listeners = { };
let listeners = element.listeners;

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 <ExtComponent/>

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'); }
        }
    }
});

loadingHeight : Number

<ExtGrid loadingHeight="10" />

let element = document.body.querySelector('ExtGrid');
element.loadingHeight = 10;
let loadingHeight = element.loadingHeight;

If specified, gives an explicit height for a floated data view when it is showing the loadingText, if that is specified. This is useful to prevent the view's height from collapsing to zero when the loading mask is applied and there are no other contents in the data view.

Defaults to:

null

loadingText : String / Boolean

<ExtGrid loadingText="true" />

let element = document.body.querySelector('ExtGrid');
element.loadingText = true;
let loadingText = element.loadingText;

A string to display during data load operations. This text will be displayed in a loading div and the view's contents will be cleared while loading, otherwise the view's contents will continue to display normally until the new data is loaded and the contents are replaced.

Note: For virtual stores, the load mask will be shown frequently as the user scrolls. To inhibit that, set loadingText to the empty string.

Defaults to:

'Loading...'

margin : Number / String

<ExtGrid margin="value" />

let element = document.body.querySelector('ExtGrid');
element.margin = 'value';
let margin = element.margin;

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

markDirty : Boolean

<ExtGrid markDirty="true" />

let element = document.body.querySelector('ExtGrid');
element.markDirty = true;
let markDirty = element.markDirty;

true to mark items as dirty when the underlying record has been modified.

By default there is no special styling for dirty items in data views and <ExtList/>. When this config is set to true each item's element will have a CSS class name of x-mark-dirty added to it. When the underlying record for an item has been modified the item will have the x-dirty CSS class.

<ExtGrid/> style "dirty" cells using a red triangle icon in the corner of the cell. See $gridcell-dirty-icon

Defaults to:

false

Available since: 6.5.1

masked : Boolean / String / Object / <ExtMask/> / <ExtLoadmask/>

<ExtGrid masked="true" />

let element = document.body.querySelector('ExtGrid');
element.masked = true;
let masked = element.masked;

A configuration to allow you to mask this container.

If the value is a string, it will be used as the message config for an <ExtLoadmask/>.

For more precise control over the mask, you can optionally pass an object block with and xtype of loadmask, and an optional message value to display a loading mask. Please refer to the <ExtLoadmask/> component to see other configurations.

Ext.create({
    xtype: 'container',
    fullscreen: true,
    html: 'Hello World',
    masked: {
        xtype: 'loadmask',
        message: 'My Message'
    }
});

Alternatively, you can just call the setter at any time with true/false to show/hide the mask:

setMasked(true); //show the mask
setMasked(false); //hides the mask

There are also two convenient methods, method-mask and unmask, to allow you to mask and unmask this container at any time.

Remember, the Ext.Viewport is always a container, so if you want to mask your whole application at anytime, can call:

Ext.Viewport.setMasked({
    xtype: 'loadmask',
    message: 'Hello'
});

Defaults to:

null

maxHeight : Number / String

<ExtGrid maxHeight="value" />

let element = document.body.querySelector('ExtGrid');
element.maxHeight = 'value';
let maxHeight = element.maxHeight;

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

maxItemCache : Number

<ExtGrid maxItemCache="10" />

let element = document.body.querySelector('ExtGrid');
element.maxItemCache = 10;
let maxItemCache = element.maxItemCache;

The number of components to cache when no longer needed (as opposed to calling destroy on them).

Defaults to:

20

maxWidth : Number / String

<ExtGrid maxWidth="value" />

let element = document.body.querySelector('ExtGrid');
element.maxWidth = 'value';
let maxWidth = element.maxWidth;

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

minHeight : Number / String

<ExtGrid minHeight="value" />

let element = document.body.querySelector('ExtGrid');
element.minHeight = 'value';
let minHeight = element.minHeight;

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

minWidth : Number / String

<ExtGrid minWidth="value" />

let element = document.body.querySelector('ExtGrid');
element.minWidth = 'value';
let minWidth = element.minWidth;

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

minimumBufferDistance : Number

<ExtGrid minimumBufferDistance="10" />

let element = document.body.querySelector('ExtGrid');
element.minimumBufferDistance = 10;
let minimumBufferDistance = element.minimumBufferDistance;

The minimum number of items beyond the visible area of an infinite list to allow before repositioning items on the opposite side to balance the visible area inside the rendered range.

Defaults to:

5

modal : Boolean

<ExtGrid modal="true" />

let element = document.body.querySelector('ExtGrid');
element.modal = true;
let modal = element.modal;

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

modelValidation : Boolean

immutable imm

<ExtGrid modelValidation="true" />

let element = document.body.querySelector('ExtGrid');
element.modelValidation = true;
let modelValidation = element.modelValidation;

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

immutable imm

<ExtGrid name="value" />

let element = document.body.querySelector('ExtGrid');
element.name = 'value';
let name = element.name;

Name for the widget to be used with Ext.Container#lookupName et al.

Defaults to:

null

nameHolder : Boolean

immutable imm

<ExtGrid nameHolder="true" />

let element = document.body.querySelector('ExtGrid');
element.nameHolder = true;
let nameHolder = element.nameHolder;

When true child components are tracked by their name property and can be retrieved using the lookupName method.

Defaults to:

false

nameable : Boolean

immutable imm

<ExtGrid nameable="true" />

let element = document.body.querySelector('ExtGrid');
element.nameable = true;
let nameable = element.nameable;

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

Defaults to:

false

onItemDisclosure : Boolean / Function / String / Object

<ExtGrid onItemDisclosure="true" />

let element = document.body.querySelector('ExtGrid');
element.onItemDisclosure = true;
let onItemDisclosure = element.onItemDisclosure;

Set to true to display a disclosure icon on each list item. The list will then fire the disclose event, and the event can be stopped before childtap. By setting this config to a function, the function passed will be called when the disclosure is tapped. This can be either a function object or the name of a Ext.app.ViewController method.

Finally you can specify an object with a scope and handler property defined. This will also be bound to the tap event listener and is useful when you want to change the scope of the handler.

Defaults to:

null

padding : Number / String

<ExtGrid padding="value" />

let element = document.body.querySelector('ExtGrid');
element.padding = 'value';
let padding = element.padding;

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

pinFooters : Boolean

<ExtGrid pinFooters="true" />

let element = document.body.querySelector('ExtGrid');
element.pinFooters = true;
let pinFooters = element.pinFooters;

Whether or not to pin footers on bottom of item groups while scrolling.

Defaults to:

false

Available since: 6.5.0

pinHeaders : Boolean

<ExtGrid pinHeaders="true" />

let element = document.body.querySelector('ExtGrid');
element.pinHeaders = true;
let pinHeaders = element.pinHeaders;

Whether or not to pin headers on top of item groups while scrolling. Only applicable for infinite lists.

Defaults to:

true

pinnedFooter : Object

<ExtGrid pinnedFooter="{ }" />

let element = document.body.querySelector('ExtGrid');
element.pinnedFooter = { };
let pinnedFooter = element.pinnedFooter;

A config object for the pinned footer. Only applicable when pinFooters and grouped are true.

Defaults to:

null

Available since: 6.5.0

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

<ExtGrid plugins="{ }" />

let element = document.body.querySelector('ExtGrid');
element.plugins = { };
let plugins = element.plugins;

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 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

pressedDelay : Number

<ExtGrid pressedDelay="10" />

let element = document.body.querySelector('ExtGrid');
element.pressedDelay = 10;
let pressedDelay = element.pressedDelay;

The amount of delay between the tapstart and adding the pressedCls.

Defaults to:

100

preventSelectionOnDisclose : Boolean

<ExtGrid preventSelectionOnDisclose="true" />

let element = document.body.querySelector('ExtGrid');
element.preventSelectionOnDisclose = true;
let preventSelectionOnDisclose = element.preventSelectionOnDisclose;

When true item selection is prevented when the user taps a disclose icon.

Defaults to:

true

preventSelectionOnTool : Boolean

<ExtGrid preventSelectionOnTool="true" />

let element = document.body.querySelector('ExtGrid');
element.preventSelectionOnTool = true;
let preventSelectionOnTool = element.preventSelectionOnTool;

When true item selection is prevented when the user taps on a tool. This can be overridden on specific tools by placing the preventSelection property on the tool:

 tools: [{
     type: 'gear',
     preventSelection: false
 }]

Defaults to:

true

Available since: 6.5.0

publishes : String / String[] / Object

<ExtGrid publishes="value" />

let element = document.body.querySelector('ExtGrid');
element.publishes = 'value';
let publishes = element.publishes;

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
}

record : Ext.data.Model

<ExtGrid record="value" />

let element = document.body.querySelector('ExtGrid');
element.record = 'value';
let record = element.record;

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

reference : String

immutable imm

<ExtGrid reference="value" />

let element = document.body.querySelector('ExtGrid');
element.reference = 'value';
let reference = element.reference;

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

referenceHolder : Boolean

immutable imm

<ExtGrid referenceHolder="true" />

let element = document.body.querySelector('ExtGrid');
element.referenceHolder = true;
let referenceHolder = element.referenceHolder;

If true, this container will be marked as being a point in the hierarchy where references to items with a specified reference config will be held. The container will automatically become a referenceHolder if a controller is specified.

See the introductory docs for Ext.container.Container for more information about references & reference holders.

Defaults to:

false

refreshCounter : Number

readonly ro

<ExtGrid refreshCounter="10" />

let element = document.body.querySelector('ExtGrid');
let refreshCounter = element.refreshCounter;

The number of refreshes this DataView has had.

Defaults to:

0

relative : Boolean

<ExtGrid relative="true" />

let element = document.body.querySelector('ExtGrid');
element.relative = true;
let relative = element.relative;

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

rendered : Boolean

readonly ro

<ExtGrid rendered="true" />

let element = document.body.querySelector('ExtGrid');
let rendered = element.rendered;

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.

resetFocusPosition : Boolean

immutable imm

<ExtGrid resetFocusPosition="true" />

let element = document.body.querySelector('ExtGrid');
element.resetFocusPosition = true;
let resetFocusPosition = element.resetFocusPosition;

When true, FocusableContainer will reset last focused position whenever focus leaves the container. Subsequent tabbing into the container will always focus the first eligible child item.

When false, subsequent tabbing into the container will focus the child item that was last focused before.

Defaults to:

false

restoreFocus : Boolean

readonly ro

<ExtGrid restoreFocus="true" />

let element = document.body.querySelector('ExtGrid');
element.restoreFocus = true;
let restoreFocus = element.restoreFocus;

By default, using the TAB key to reenter a grid restores focus to the cell which was last focused.

Setting this to false means that TAB from above focuses the first rendered cell and TAB from below focuses the last rendered cell.

Be aware that due to buffered rendering, the last row of a 1,000,000 row grid may not be available to receive immediate focus.

Defaults to:

true

right : Number / String

<ExtGrid right="value" />

let element = document.body.querySelector('ExtGrid');
element.right = 'value';
let right = element.right;

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

ripple : Boolean / Object / String

<ExtGrid ripple="true" />

let element = document.body.querySelector('ExtGrid');
element.ripple = true;
let ripple = element.ripple;

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.

rowLines : Boolean

<ExtGrid rowLines="true" />

let element = document.body.querySelector('ExtGrid');
element.rowLines = true;
let rowLines = element.rowLines;

Set this to false to suppress the borders in between the items in this list. By default the presence of borders between items is determined by the stylesheet.

Defaults to:

true

scrollDock : 'start' / 'emd'

immutable imm

<ExtGrid scrollDock="value" />

let element = document.body.querySelector('ExtGrid');
element.scrollDock = 'value';
let scrollDock = element.scrollDock;

This property is placed on the child items added to this container. The value placed on the child items determines the position of that item with respect to the data items.

 Ext.Viewport.add({
     xtype: 'dataview',
     itemTpl: '{firstName}',
     data: [
         { firstName: 'Peter'},
         { firstName: 'Raymond'},
         { firstName: 'Egon'},
         { firstName: 'Winston'}
     ],
     items: [{
          xtype: 'component',
          html: 'Always At End!',
          scrollDock: 'end'
     }]
 });

Note, a value of 'top' is equivalent to 'start' while 'bottom' is equivalent to 'end'. The 'top' and 'bottom' values originated from the <ExtList/> class.

selection : Ext.data.Model

immutable imm readonly ro

<ExtGrid selection="value" />

let element = document.body.querySelector('ExtGrid');
let selection = element.selection;

The selected record.

session : Boolean / Object / Ext.data.Session

<ExtGrid session="true" />

let element = document.body.querySelector('ExtGrid');
element.session = true;
let session = element.session;

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

shadow : Boolean

<ExtGrid shadow="true" />

let element = document.body.querySelector('ExtGrid');
element.shadow = true;
let shadow = element.shadow;

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

shareableName : Boolean

immutable imm

<ExtGrid shareableName="true" />

let element = document.body.querySelector('ExtGrid');
element.shareableName = true;
let shareableName = element.shareableName;

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

<ExtGrid shim="true" />

let element = document.body.querySelector('ExtGrid');
element.shim = true;
let shim = element.shim;

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

showAnimation : String / Mixed

<ExtGrid showAnimation="value" />

let element = document.body.querySelector('ExtGrid');
element.showAnimation = 'value';
let showAnimation = element.showAnimation;

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

stateId : String

<ExtGrid stateId="value" />

let element = document.body.querySelector('ExtGrid');
element.stateId = 'value';
let stateId = element.stateId;

The unique id for this object to use for state management purposes.

Defaults to:

null

stateful : Boolean / Object / String[]

<ExtGrid stateful="true" />

let element = document.body.querySelector('ExtGrid');
element.stateful = true;
let stateful = element.stateful;

This config specifies the config properties that will be persisted using the Ext.state.Provider. If this config is set to true, the configs specified by statefulDefaults will be assumed.

 stateful: true

Otherwise, this config can be an array of strings of the properties to save:

 stateful: [
     'width',
     'height',
     'collapsed'
 ]

The above is equivalent to:

 stateful: {
     width: true,
     height: true,
     collapsed: true
 }

Note: To be truly stateful, an id or stateId must also be assigned.

A stateful object will save its state when any of these config properties change value.

Defaults to:

false

style : String / Object

<ExtGrid style="value" />

let element = document.body.querySelector('ExtGrid');
element.style = 'value';
let style = element.style;

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

tabIndex : Number

<ExtGrid tabIndex="10" />

let element = document.body.querySelector('ExtGrid');
element.tabIndex = 10;
let tabIndex = element.tabIndex;

DOM tabIndex attribute for this component's focusEl.

Defaults to:

0

template : Array

readonly ro

<ExtGrid template="value" />

let element = document.body.querySelector('ExtGrid');
element.template = 'value';
let template = element.template;

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:

[
    {
        reference: 'bodyElement',
        cls: Ext.baseCSSPrefix + 'body-el',
        uiCls: 'body-el',
        children: [
            {
                // This el is width:100% and flex:1 (for full height)
                reference: 'outerCt',
                className: Ext.baseCSSPrefix + 'list-outer-ct',
                children: [
                    {
                        // This el is just width:100% or explicitly sized of hscroll
                        reference: 'innerCt',
                        className: Ext.baseCSSPrefix + 'list-inner-ct'
                    }
                ]
            }
        ]
    }
]

toFrontOnShow : Boolean

<ExtGrid toFrontOnShow="true" />

let element = document.body.querySelector('ExtGrid');
element.toFrontOnShow = true;
let toFrontOnShow = element.toFrontOnShow;

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

Defaults to:

true

tooltip : String / Object

<ExtGrid tooltip="value" />

let element = document.body.querySelector('ExtGrid');
element.tooltip = 'value';
let tooltip = element.tooltip;

The tooltip for this component - can be a string to be used as innerHTML (html tags are accepted) or <ExtTooltip/> 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

top : Number / String

<ExtGrid top="value" />

let element = document.body.querySelector('ExtGrid');
element.top = 'value';
let top = element.top;

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

touchAction : Object

<ExtGrid touchAction="{ }" />

let element = document.body.querySelector('ExtGrid');
element.touchAction = { };
let touchAction = element.touchAction;

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

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

<ExtGrid tpl="value" />

let element = document.body.querySelector('ExtGrid');
element.tpl = 'value';
let tpl = element.tpl;

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

tplWriteMode : String

<ExtGrid tplWriteMode="value" />

let element = document.body.querySelector('ExtGrid');
element.tplWriteMode = 'value';
let tplWriteMode = element.tplWriteMode;

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'

triggerCtEvent : 'tap' / 'singletap'

<ExtGrid triggerCtEvent="value" />

let element = document.body.querySelector('ExtGrid');
element.triggerCtEvent = 'value';
let triggerCtEvent = element.triggerCtEvent;

Determines what type of touch event is recognized as a touch on the container.

Defaults to:

'tap'

triggerEvent : 'childtap' / 'childsingletap' / 'childdoubletap' / 'childswipe' / 'childtaphold' / 'childlongpress'

<ExtGrid triggerEvent="value" />

let element = document.body.querySelector('ExtGrid');
element.triggerEvent = 'value';
let triggerEvent = element.triggerEvent;

Determines what type of touch event causes an item to be selected.

Defaults to:

'childtap'

twoWayBindable : String / String[] / Object

<ExtGrid twoWayBindable="value" />

let element = document.body.querySelector('ExtGrid');
element.twoWayBindable = 'value';
let twoWayBindable = element.twoWayBindable;

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
}

ui : String / String[]

<ExtGrid ui="value" />

let element = document.body.querySelector('ExtGrid');
element.ui = 'value';
let ui = element.ui;

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

userCls : String / String[]

<ExtGrid userCls="value" />

let element = document.body.querySelector('ExtGrid');
element.userCls = 'value';
let userCls = element.userCls;

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

userSelectable : Boolean / String / Object

<ExtGrid userSelectable="true" />

let element = document.body.querySelector('ExtGrid');
element.userSelectable = true;
let userSelectable = element.userSelectable;

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,       // allow the element to be user selectable
     bodyElement: true    // allow the component's body element to be user selectable
 }

Defaults to:

false

Available since: 6.5.1

variableHeights : Boolean

<ExtGrid variableHeights="true" />

let element = document.body.querySelector('ExtGrid');
element.variableHeights = true;
let variableHeights = element.variableHeights;

Set to true if the items in this list do not all have the same height. This is false by default to avoid measure each row to determine its height.

Defaults to:

false

Available since: 6.5.0

viewModel : String / Object / Ext.app.ViewModel

<ExtGrid viewModel="value" />

let element = document.body.querySelector('ExtGrid');
element.viewModel = 'value';
let viewModel = element.viewModel;

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

weight : Number

<ExtGrid weight="10" />

let element = document.body.querySelector('ExtGrid');
element.weight = 10;
let weight = element.weight;

This value controls this item's order in a weighted <ExtContainer/> (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

width : Number / String

<ExtGrid width="value" />

let element = document.body.querySelector('ExtGrid');
element.width = 'value';
let width = element.width;

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

x : Number

<ExtGrid x="10" />

let element = document.body.querySelector('ExtGrid');
element.x = 10;
let x = element.x;

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

xtype : String

immutable imm

<ExtGrid xtype="value" />

let element = document.body.querySelector('ExtGrid');
element.xtype = 'value';
let xtype = element.xtype;

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 <ExtComponent/> like so:

Ext.define('PressMeButton', {
    extend: 'Ext.button.Button',
    xtype: '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

<ExtGrid y="10" />

let element = document.body.querySelector('ExtGrid');
element.y = 10;
let y = element.y;

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

zIndex : Number

<ExtGrid zIndex="10" />

let element = document.body.querySelector('ExtGrid');
element.zIndex = 10;
let zIndex = element.zIndex;

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

add ( newItems ) : Ext.Component/Ext.Component[]

let element = document.body.querySelector('ExtGrid');
let add = element.add(newItems);

Adds one or more Components to this Container. Example:

var myPanel = Ext.create({
    xtype: 'panel',
    html : 'This will be added to a Container'
});

var items = myContainer.add([myPanel]); // Array returned
var item  = myContainer.add(myPanel);   // One item is returned

Parameters

Returns

addAfterListener

let element = document.body.querySelector('ExtGrid');
element.addAfterListener();

Alias for onAfter.

addBeforeListener