add extjs 6.0.1 sources

[extjs.git] / extjs / modern / modern / overrides / Widget.js

/**\r
 *\r
 */\r
Ext.define('Ext.overrides.Widget', {\r
    override: 'Ext.Widget',\r
    \r
    mixins: [\r
        'Ext.mixin.Traversable'\r
    ],\r
\r
    config: {\r
        /**\r
         * @cfg {Number} flex\r
         * The flex of this item *if* this item item is inside a {@link Ext.layout.HBox} or {@link Ext.layout.VBox}\r
         * layout.\r
         *\r
         * You can also update the flex of a component dynamically using the {@link Ext.layout.FlexBox#setItemFlex}\r
         * method.\r
         */\r
        flex: {\r
            evented: true,\r
            $value: null\r
        },\r
\r
        /**\r
         * @cfg {String} id\r
         * The **unique id of this component instance.**\r
         *\r
         * It should not be necessary to use this configuration except for singleton objects in your application. Components\r
         * created with an id may be accessed globally using {@link Ext#getCmp Ext.getCmp}.\r
         *\r
         * Instead of using assigned ids, use the {@link #itemId} config, and {@link Ext.ComponentQuery ComponentQuery}\r
         * which provides selector-based searching for Sencha Components analogous to DOM querying. The\r
         * {@link Ext.Container} class contains {@link Ext.Container#down shortcut methods} to query\r
         * its descendant Components by selector.\r
         *\r
         * Note that this id will also be used as the element id for the containing HTML element that is rendered to the\r
         * page for this component. This allows you to write id-based CSS rules to style the specific instance of this\r
         * component uniquely, and also to select sub-elements using this component's id as the parent.\r
         *\r
         * **Note**: to avoid complications imposed by a unique id also see `{@link #itemId}`.\r
         *\r
         * Defaults to an auto-assigned id.\r
         */\r
\r
        /**\r
         * @cfg {String} itemId\r
         * An itemId can be used as an alternative way to get a reference to a component when no object reference is\r
         * available. Instead of using an `{@link #id}` with {@link Ext#getCmp}, use `itemId` with\r
         * {@link Ext.Container#getComponent} which will retrieve `itemId`'s or {@link #id}'s. Since `itemId`'s are an\r
         * index to the container's internal MixedCollection, the `itemId` is scoped locally to the container - avoiding\r
         * potential conflicts with {@link Ext.ComponentManager} which requires a **unique** `{@link #id}`.\r
         *\r
         * Also see {@link #id}, {@link Ext.Container#query}, {@link Ext.Container#down} and {@link Ext.Container#child}.\r
         *\r
         * @accessor\r
         */\r
        itemId: undefined\r
    },\r
\r
    constructor: function(config) {\r
        this.callParent([config]);\r
        this.initBindable();\r
    },\r
\r
    applyFlex: function(flex) {\r
        if (flex) {\r
            flex = Number(flex);\r
\r
            if (isNaN(flex)) {\r
                flex = null;\r
            }\r
        }\r
        else {\r
            flex = null;\r
        }\r
\r
        return flex;\r
    },\r
\r
    applyItemId: function(itemId) {\r
        return itemId || this.getId();\r
    },\r
\r
    render: function(container, insertBeforeElement) {\r
        this.renderTo(container, insertBeforeElement);\r
    },\r
\r
    renderTo: function(container, insertBeforeElement) {\r
        var dom = this.renderElement.dom,\r
            containerDom = Ext.getDom(container),\r
            insertBeforeChildDom;\r
\r
        if (Ext.isNumber(insertBeforeChildDom)) {\r
            insertBeforeElement = containerDom.childNodes[insertBeforeElement];\r
        }\r
        insertBeforeChildDom = Ext.getDom(insertBeforeElement);\r
\r
        if (containerDom) {\r
            if (insertBeforeChildDom) {\r
                containerDom.insertBefore(dom, insertBeforeChildDom);\r
            }\r
            else {\r
                containerDom.appendChild(dom);\r
            }\r
\r
            this.setRendered(Boolean(dom.offsetParent));\r
        }\r
    },\r
\r
    destroy: function() {\r
        var me = this,\r
            parent = me.getParent();\r
\r
        if (parent && parent.remove) {\r
            parent.remove(me, false);\r
        }\r
\r
        me.callParent();\r
    },\r
    \r
    isInnerItem: function() {\r
        return true;\r
    },\r
    \r
    isCentered: function() {\r
        return false;\r
    },\r
\r
    isDocked: function() {\r
        return Boolean(this.getDocked());\r
    },\r
    \r
    isFloating: function() {\r
        return false;\r
    },\r
    \r
    getDocked: function() {\r
        return this._docked;\r
    },\r
\r
    /**\r
     * @private\r
     */\r
    onAdded: function(parent, instanced) {\r
        var me = this,\r
            inheritedState = me.inheritedState,\r
            currentParent = me.parent;\r
\r
        if (currentParent && currentParent !== parent) {\r
            currentParent.remove(me, false);\r
        }\r
\r
        me.parent = parent;\r
\r
        me.onInheritedAdd(parent, instanced);\r
    },\r
\r
    onRemoved: function(destroying) {\r
        if (!destroying) {\r
            this.removeBindings();\r
        }\r
\r
        this.onInheritedRemove(destroying);\r
\r
        this.parent = null;\r
    },\r
\r
    setLayoutSizeFlags: Ext.emptyFn,\r
\r
    /**\r
     * @private\r
     * @param {Boolean} rendered\r
     */\r
    setRendered: function(rendered) {\r
        var wasRendered = this.rendered;\r
\r
        if (rendered !== wasRendered) {\r
            this.rendered = rendered;\r
\r
            return true;\r
        }\r
\r
        return false;\r
    },\r
\r
    updateLayout: function() {\r
        // If size monitoring for widgets has improvements to not\r
        // need to do this anymore, core/Widget will need this to be\r
        // declared as an emptyFn to preserve toolkit compat\r
        var parent = this.getParent(),\r
            scrollable;\r
\r
        if (parent) {\r
            scrollable = parent.getScrollable();\r
            if (scrollable) {\r
                scrollable.refresh();\r
            }\r
        }\r
    }\r
});