/** * Provides a registry of all Components (instances of {@link Ext.Component} or any subclass * thereof) on a page so that they can be easily accessed by {@link Ext.Component component} * {@link Ext.Component#id id} (see {@link #get}, or the convenience method * {@link Ext#getCmp Ext.getCmp}). * * This object also provides a registry of available Component *classes* indexed by a * mnemonic code known as the Component's {@link Ext.Component#xtype xtype}. The `xtype` * provides a way to avoid instantiating child Components when creating a full, nested * config object for a complete Ext page. * * A child Component may be specified simply as a *config object* as long as the correct * `{@link Ext.Component#xtype xtype}` is specified so that if and when the Component * needs rendering, the correct type can be looked up for lazy instantiation. * * @singleton */Ext.define('Ext.ComponentManager', { alternateClassName: 'Ext.ComponentMgr', singleton: true, count: 0, referencesDirty: true, referenceRepairs: 0, typeName: 'xtype', /** * @private */ constructor: function(config) { var me = this; Ext.apply(me, config); me.all = {}; me.byInstanceId = {}; me.holders = {}; me.names = {}; me.references = {}; me.onAvailableCallbacks = {}; }, /** * Creates a new Component from the specified config object using the config object's * `xtype` to determine the class to instantiate. * * @param {Object} config A configuration object for the Component you wish to create. * @param {String} [defaultType] The `xtype` to use if the config object does not * contain a `xtype`. (Optional if the config contains a `xtype`). * @return {Ext.Component} The newly instantiated Component. */ create: function (config, defaultType) { if (typeof config === 'string') { return Ext.widget(config); } if (config.isComponent) { return config; } if ('xclass' in config) { return Ext.create(config.xclass, config); } return Ext.widget(config.xtype || defaultType, config); }, /** * Returns an item by id. * @param {String} id The id of the item * @return {Object} The item, undefined if not found. */ get: function(id) { return this.all[id]; }, register: function(component) { var me = this, id = component.getId(), onAvailableCallbacks = me.onAvailableCallbacks; //<debug> if (id === undefined) { Ext.raise('Component id is undefined. Please ensure the component has an id.'); } if (id in me.all) { Ext.raise('Duplicate component id "' + id + '"'); } if (component.$iid in me.byInstanceId) { Ext.raise('Duplicate component instance id "' + component.$iid + '"'); } //</debug> me.all[id] = component; me.byInstanceId[component.$iid] = component; if (component.reference) { me.references[id] = component; } if (component.name && component.nameable) { me.names[id] = component; } if (component.nameHolder || component.referenceHolder) { me.holders[id] = component; } ++me.count; if (!me.hasFocusListener) { me.installFocusListener(); } onAvailableCallbacks = onAvailableCallbacks && onAvailableCallbacks[id]; if (onAvailableCallbacks && onAvailableCallbacks.length) { me.notifyAvailable(component); } }, unregister: function (component) { var me = this, all = me.all, byInstanceId = me.byInstanceId, holders = me.holders, references = me.references, names = me.names, id = component.getId(); if (id in holders) { // Helps IE since delete may just mark the entry as "free" and not // release the object by clearing the entry value. // TODO find out when IE fixed this holders[id] = null; delete holders[id]; } if (id in names) { names[id] = null; delete names[id]; } if (id in references) { references[id] = null; delete references[id]; } all[id] = null; delete all[id]; id = component.$iid; byInstanceId[id] = null; delete byInstanceId[id]; --me.count; }, markReferencesDirty: function() { var me = this, holders = me.holders, key; if (!me.referencesDirty) { // Clear all collections (no stale entries) for (key in holders) { holders[key].refs = holders[key].nameRefs = null; } me.referencesDirty = true; } }, fixReferences: function() { var me = this, references = me.references, names = me.names, key; if (me.referencesDirty) { ++me.referenceRepairs; for (key in references) { references[key]._fixReference(); } for (key in names) { names[key]._fixName(); } me.referencesDirty = false; } }, /** * Registers a function that will be called (a single time) when an item with the specified id is added to the manager. * This will happen on instantiation. * @param {String} id The item id * @param {Function} fn The callback function. Called with a single parameter, the item. * @param {Object} scope The scope ('this' reference) in which the callback is executed. * Defaults to the item. */ onAvailable : function(id, fn, scope){ var me = this, callbacks = me.onAvailableCallbacks, all = me.all, item; if (id in all) { //if already an instance, callback immediately item = all[id]; fn.call(scope || item, item); } else if (id) { // otherwise, queue for dispatch if (!Ext.isArray(callbacks[id])) { callbacks[id] = [ ]; } callbacks[id].push( function(item) { fn.call(scope || item, item);} ); } }, /** * @private */ notifyAvailable : function(item) { var callbacks = this.onAvailableCallbacks[item && item.getId()] || []; while (callbacks.length) { (callbacks.shift())(item); } }, /** * Executes the specified function once for each item in the collection. * @param {Function} fn The function to execute. * @param {String} fn.key The key of the item * @param {Number} fn.value The value of the item * @param {Number} fn.length The total number of items in the collection ** Removed * in 5.0 ** * @param {Boolean} fn.return False to cease iteration. * @param {Object} scope The scope to execute in. Defaults to `this`. */ each: function(fn, scope){ return Ext.Object.each(this.all, fn, scope); }, /** * Gets the number of items in the collection. * @return {Number} The number of items in the collection. */ getCount: function() { return this.count; }, /** * Returns an array of all components * @return {Array} */ getAll: function() { return Ext.Object.getValues(this.all); }, /** * Return the currently active (focused) Component * * @return {Ext.Component/null} Active Component, or null * @private */ getActiveComponent: function() { return Ext.Component.from(Ext.dom.Element.getActiveElement()); }, // Deliver focus events to Component onGlobalFocus: function(e) { var me = this, event = e.event, toComponent = event.toComponent = Ext.Component.from(e.toElement), fromComponent = event.fromComponent = Ext.Component.from(e.fromElement), commonAncestor = me.getCommonAncestor(fromComponent, toComponent), targetComponent; // Focus moves *within* a component should not cause component focus leave/enter if (toComponent !== fromComponent) { if (fromComponent && !fromComponent.destroyed && !fromComponent.isDestructing()) { if (fromComponent.handleBlurEvent) { fromComponent.handleBlurEvent(e); } // Call onFocusLeave on the component axis from which focus is exiting for (targetComponent = fromComponent; targetComponent && targetComponent !== commonAncestor; targetComponent = targetComponent.getRefOwner()) { if (!(targetComponent.destroyed || targetComponent.destroying)) { e.type = 'focusleave'; targetComponent.onFocusLeave(event); } } } if (toComponent && !toComponent.destroyed && !toComponent.isDestructing()) { if (toComponent.handleFocusEvent) { toComponent.handleFocusEvent(e); } // Call onFocusEnter on the component axis to which focus is entering for (targetComponent = toComponent; targetComponent && targetComponent !== commonAncestor; targetComponent = targetComponent.getRefOwner()) { e.type = 'focusenter'; targetComponent.onFocusEnter(event); } } } for (targetComponent = commonAncestor; targetComponent; targetComponent = targetComponent.getRefOwner()) { if (!(targetComponent.destroying || targetComponent.destroyed)) { targetComponent.onFocusMove(e); } } }, getCommonAncestor: function(compA, compB) { if (compA === compB) { return compA; } while (compA && !(compA.isAncestor(compB) || compA === compB)) { compA = compA.getRefOwner(); } return compA; }, privates: { installFocusListener: function() { var me = this; Ext.on('focus', me.onGlobalFocus, me); me.hasFocusListener = true; }, clearAll: function() { this.all = {}; this.names = {}; this.references = {}; this.onAvailableCallbacks = {}; }, /** * Find the Widget or Component to which the given Element belongs. * * @param {Ext.dom.Element/HTMLElement} el The element from which to start to find * an owning Component. * @param {Ext.dom.Element/HTMLElement} [limit] The element at which to stop upward * searching for an owning Component, or the number of Components to traverse before * giving up. Defaults to the document's HTML element. * @param {String} [selector] An optional {@link Ext.ComponentQuery} selector to * filter the target. * @return {Ext.Widget/Ext.Component} The widget, component or `null`. * * @private * @since 6.5.0 */ from: function(el, limit, selector) { if (el && el.isEvent) { el = el.target; } var target = Ext.getDom(el), cache = this.all, depth = 0, topmost, cmpId, cmp; if (typeof limit !== 'number') { topmost = Ext.getDom(limit); limit = Number.MAX_VALUE; } while (target && target.nodeType === 1 && depth < limit && target !== topmost) { cmpId = target.getAttribute('data-componentid') || target.id; if (cmpId) { cmp = cache[cmpId]; if (cmp && (!selector || Ext.ComponentQuery.is(cmp, selector))) { return cmp; } // Increment depth on every *Component* found, not Element depth++; } target = target.parentNode; } return null; } }},function () { var ComponentManager = Ext.ComponentManager; // Backwards compat ComponentManager.fromElement = ComponentManager.from; /** * This is shorthand reference to {@link Ext.ComponentManager#get}. * Looks up an existing {@link Ext.Component Component} by {@link Ext.Component#id id} * * @method getCmp * @param {String} id The component {@link Ext.Component#id id} * @return {Ext.Component} The Component, `undefined` if not found, or `null` if a * Class was found. * @member Ext */ Ext.getCmp = function(id) { return ComponentManager.get(id); }; Ext.iidToCmp = function (iid) { return ComponentManager.byInstanceId[iid] || null; }; Ext.doEv = function(node, e) { var cmp, method, event; // The event here is a raw browser event, so don't pass the event directly // since from expects an Ext.event.Event cmp = Ext.Component.from(e.target); if (cmp && !cmp.destroying && !cmp.destroyed && cmp.getEventHandlers) { method = cmp.getEventHandlers()[e.type]; if (method && cmp[method]) { event = new Ext.event.Event(e); return cmp[method](event); } } return true; };});