ExtJS-4.2.6-src-926个类源码

/* This file is part of Ext JS 4.2 Copyright (c) 2011-2016 Sencha Inc Contact: http://www.sencha.com/contact Commercial Usage Licensees holding valid commercial licenses may use this file in accordance with the Commercial Software License Agreement provided with the Software or, alternatively, in accordance with the terms contained in a written agreement between you and Sencha. If you are unsure which license is appropriate for your use, please contact the sales department at http://www.sencha.com/contact. Build date: 2016-10-05 03:40:31 (283b2cb229d1bac39381235a0217583b24341c69) */ /** * An abstract base class which provides shared methods for Components across the Sencha product line. * * Please refer to sub class's documentation. * @private */ Ext.define('Ext.AbstractComponent', { /* Begin Definitions */ requires: [ 'Ext.ComponentQuery', 'Ext.ComponentManager', 'Ext.util.ProtoElement', 'Ext.dom.CompositeElement', 'Ext.PluginManager' ], mixins: { positionable: 'Ext.util.Positionable', observable: 'Ext.util.Observable', animate: 'Ext.util.Animate', elementCt: 'Ext.util.ElementContainer', renderable: 'Ext.util.Renderable', state: 'Ext.state.Stateful' }, // The "uses" property specifies class which are used in an instantiated AbstractComponent. // They do *not* have to be loaded before this class may be defined - that is what "requires" is for. uses: [ 'Ext.PluginManager', 'Ext.Element', 'Ext.DomHelper', 'Ext.XTemplate', 'Ext.ComponentLoader', 'Ext.EventManager', 'Ext.layout.Context', 'Ext.layout.Layout', 'Ext.layout.component.Auto', 'Ext.LoadMask', 'Ext.ZIndexManager' ], statics: { AUTO_ID: 1000, pendingLayouts: null, layoutSuspendCount: 0, /** * Cancels layout of a component. * @param {Ext.Component} comp */ cancelLayout: function(comp, isDestroying) { var context = this.runningLayoutContext || this.pendingLayouts; if (context) { context.cancelComponent(comp, false, isDestroying); } }, /** * Walk the DOM tree upwards and find the Component these elements belong to. * @private */ findComponentByElement: function(node) { var topmost = document.body, target = node, cmp; while (target && target.nodeType === 1 && target !== topmost) { cmp = Ext.getCmp(target.id); if (cmp) { return cmp; } target = target.parentNode; } return null; }, /** * Find a Component that the given Element belongs to. * * @param {Ext.dom.Element/HTMLElement} el * @return {Ext.Component/null} Component, or null * @private */ getComponentByElement: function(el) { var cmpIdAttr = Ext.Component.componentIdAttribute, cmpId; el = Ext.fly(el); if (!el) { return null; } cmpId = el.getAttribute(cmpIdAttr); if (cmpId) { return Ext.getCmp(cmpId); } else { return Ext.Component.findComponentByElement(el.dom); } }, /** * Performs all pending layouts that were scheduled while * {@link Ext.AbstractComponent#suspendLayouts suspendLayouts} was in effect. * @static */ flushLayouts: function () { var me = this, context = me.pendingLayouts; if (context && context.invalidQueue.length) { me.pendingLayouts = null; me.runningLayoutContext = context; Ext.override(context, { runComplete: function () { // we need to release the layout queue before running any of the // finishedLayout calls because they call afterComponentLayout // which can re-enter by calling doLayout/doComponentLayout. me.runningLayoutContext = null; var result = this.callParent(); // not "me" here! if (Ext.globalEvents.hasListeners.afterlayout) { Ext.globalEvents.fireEvent('afterlayout'); } return result; } }); context.run(); } }, /** * Resumes layout activity in the whole framework. * * {@link Ext#suspendLayouts} is alias of {@link Ext.AbstractComponent#suspendLayouts}. * * @param {Boolean} [flush=false] `true` to perform all the pending layouts. This can also be * achieved by calling {@link Ext.AbstractComponent#flushLayouts flushLayouts} directly. * @static */ resumeLayouts: function (flush) { if (this.layoutSuspendCount && ! --this.layoutSuspendCount) { if (flush) { this.flushLayouts(); } if (Ext.globalEvents.hasListeners.resumelayouts) { Ext.globalEvents.fireEvent('resumelayouts'); } } }, /** * Stops layouts from happening in the whole framework. * * It's useful to suspend the layout activity while updating multiple components and * containers: * * Ext.suspendLayouts(); * // batch of updates... * Ext.resumeLayouts(true); * * {@link Ext#suspendLayouts} is alias of {@link Ext.AbstractComponent#suspendLayouts}. * * See also {@link Ext#batchLayouts} for more abstract way of doing this. * * @static */ suspendLayouts: function () { ++this.layoutSuspendCount; }, /** * Updates layout of a component. * * @param {Ext.Component} comp The component to update. * @param {Boolean} [defer=false] `true` to just queue the layout if this component. * @static */ updateLayout: function (comp, defer) { var me = this, running = me.runningLayoutContext, pending; if (running) { running.queueInvalidate(comp); } else { pending = me.pendingLayouts || (me.pendingLayouts = new Ext.layout.Context()); pending.queueInvalidate(comp); if (!defer && !me.layoutSuspendCount && !comp.isLayoutSuspended()) { me.flushLayouts(); } } } }, /* End Definitions */ /** * @property {Boolean} isComponent * `true` in this class to identify an object as an instantiated Component, or subclass thereof. */ isComponent: true, /** * @private */ getAutoId: function() { this.autoGenId = true; return ++Ext.AbstractComponent.AUTO_ID; }, deferLayouts: false, /** * @cfg {String} 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 {@link Ext#getCmp Ext.getCmp}. * * id should be composed of only alphanumeric characters, dashes, and underscores. * Characters outside of (a-zA-Z0-9_-) have the potential to cause parsing errors. * * Instead of using assigned ids, use the {@link