src/app/EventBus.js

   1 /*
   2
   3 This file is part of Ext JS 4
   4
   5 Copyright (c) 2011 Sencha Inc
   6
   7 Contact:  http://www.sencha.com/contact
   8
   9 GNU General Public License Usage
  10 This file may be used under the terms of the GNU General Public License version 3.0 as published by the Free Software Foundation and appearing in the file LICENSE included in the packaging of this file.  Please review the following information to ensure the GNU General Public License version 3.0 requirements will be met: http://www.gnu.org/copyleft/gpl.html.
  11
  12 If you are unsure which license is appropriate for your use, please contact the sales department at http://www.sencha.com/contact.
  13
  14 */
  15 /**
  16  * @class Ext.app.EventBus
  17  * @private
  18  *
  19  * Class documentation for the MVC classes will be present before 4.0 final, in the mean time please refer to the MVC
  20  * guide
  21  */
  22 Ext.define('Ext.app.EventBus', {
  23     requires: [
  24         'Ext.util.Event'
  25     ],
  26     mixins: {
  27         observable: 'Ext.util.Observable'
  28     },
  29
  30     constructor: function() {
  31         this.mixins.observable.constructor.call(this);
  32
  33         this.bus = {};
  34
  35         var me = this;
  36         Ext.override(Ext.Component, {
  37             fireEvent: function(ev) {
  38                 if (Ext.util.Observable.prototype.fireEvent.apply(this, arguments) !== false) {
  39                     return me.dispatch.call(me, ev, this, arguments);
  40                 }
  41                 return false;
  42             }
  43         });
  44     },
  45
  46     dispatch: function(ev, target, args) {
  47         var bus = this.bus,
  48             selectors = bus[ev],
  49             selector, controllers, id, events, event, i, ln;
  50
  51         if (selectors) {
  52             // Loop over all the selectors that are bound to this event
  53             for (selector in selectors) {
  54                 // Check if the target matches the selector
  55                 if (target.is(selector)) {
  56                     // Loop over all the controllers that are bound to this selector
  57                     controllers = selectors[selector];
  58                     for (id in controllers) {
  59                         // Loop over all the events that are bound to this selector on this controller
  60                         events = controllers[id];
  61                         for (i = 0, ln = events.length; i < ln; i++) {
  62                             event = events[i];
  63                             // Fire the event!
  64                             if (event.fire.apply(event, Array.prototype.slice.call(args, 1)) === false) {
  65                                 return false;
  66                             };
  67                         }
  68                     }
  69                 }
  70             }
  71         }
  72     },
  73
  74     control: function(selectors, listeners, controller) {
  75         var bus = this.bus,
  76             selector, fn;
  77
  78         if (Ext.isString(selectors)) {
  79             selector = selectors;
  80             selectors = {};
  81             selectors[selector] = listeners;
  82             this.control(selectors, null, controller);
  83             return;
  84         }
  85
  86         Ext.Object.each(selectors, function(selector, listeners) {
  87             Ext.Object.each(listeners, function(ev, listener) {
  88                 var options = {},
  89                     scope = controller,
  90                     event = Ext.create('Ext.util.Event', controller, ev);
  91
  92                 // Normalize the listener
  93                 if (Ext.isObject(listener)) {
  94                     options = listener;
  95                     listener = options.fn;
  96                     scope = options.scope || controller;
  97                     delete options.fn;
  98                     delete options.scope;
  99                 }
 100
 101                 event.addListener(listener, scope, options);
 102
 103                 // Create the bus tree if it is not there yet
 104                 bus[ev] = bus[ev] || {};
 105                 bus[ev][selector] = bus[ev][selector] || {};
 106                 bus[ev][selector][controller.id] = bus[ev][selector][controller.id] || [];
 107
 108                 // Push our listener in our bus
 109                 bus[ev][selector][controller.id].push(event);
 110             });
 111         });
 112     }
 113 });