@qooxdoo/framework 7.0.0-beta.5 → 7.0.0-beta.9

package/source/class/qx/module/Event.js

@@ -26,28 +26,24 @@
  * @group (Core)
  */
 qx.Bootstrap.define("qx.module.Event", {
-  statics :
-  {
+  statics: {
     /**
      * Event normalization registry
      *
      * @internal
      */
-    __normalizations : {},
+    __normalizations: {},
 
     /**
      * Registry of event hooks
      * @internal
      */
-    __hooks : {
-      on : {},
-      off : {}
+    __hooks: {
+      on: {},
+      off: {}
     },
 
-
-
-    __isReady : false,
-
+    __isReady: false,
 
     /**
      * Executes the given function once the document is ready.
@@ -55,7 +51,7 @@ qx.Bootstrap.define("qx.module.Event", {
      * @attachStatic {qxWeb}
      * @param callback {Function} callback function
      */
-    ready : function(callback) {
+    ready(callback) {
       // DOM is already ready
       if (document.readyState === "complete") {
         window.setTimeout(callback, 1);
@@ -63,27 +59,32 @@ qx.Bootstrap.define("qx.module.Event", {
       }
 
       // listen for the load event so the callback is executed no matter what
-      var onWindowLoad = function()
-      {
+      var onWindowLoad = function () {
         qx.module.Event.__isReady = true;
         callback();
       };
 
       qxWeb(window).on("load", onWindowLoad);
 
-      var wrappedCallback = function() {
+      var wrappedCallback = function () {
         qxWeb(window).off("load", onWindowLoad);
         callback();
       };
 
       // Listen for DOMContentLoaded event if available (no way to reliably detect
       // support)
-      if (qxWeb.env.get("engine.name") !== "mshtml" || qxWeb.env.get("browser.documentmode") > 8) {
-        qx.bom.Event.addNativeListener(document, "DOMContentLoaded", wrappedCallback);
-      }
-      else {
+      if (
+        qxWeb.env.get("engine.name") !== "mshtml" ||
+        qxWeb.env.get("browser.documentmode") > 8
+      ) {
+        qx.bom.Event.addNativeListener(
+          document,
+          "DOMContentLoaded",
+          wrappedCallback
+        );
+      } else {
         // Continually check to see if the document is ready
-        var timer = function() {
+        var timer = function () {
           // onWindowLoad already executed
           if (qx.module.Event.__isReady) {
             return;
@@ -95,8 +96,7 @@ qx.Bootstrap.define("qx.module.Event", {
             if (document.body) {
               wrappedCallback();
             }
-          }
-          catch(error) {
+          } catch (error) {
             window.setTimeout(timer, 100);
           }
         };
@@ -105,7 +105,6 @@ qx.Bootstrap.define("qx.module.Event", {
       }
     },
 
-
     /**
      * Registers a normalization function for the given event types. Listener
      * callbacks for these types will be called with the return value of the
@@ -119,13 +118,12 @@ qx.Bootstrap.define("qx.module.Event", {
      * asterisk (<code>*</code>) to normalize all event types
      * @param normalizer {Function} Normalizer function
      */
-    $registerEventNormalization : function(types, normalizer)
-    {
+    $registerEventNormalization(types, normalizer) {
       if (!qx.lang.Type.isArray(types)) {
         types = [types];
       }
       var registry = qx.module.Event.__normalizations;
-      for (var i=0,l=types.length; i<l; i++) {
+      for (var i = 0, l = types.length; i < l; i++) {
         var type = types[i];
         if (qx.lang.Type.isFunction(normalizer)) {
           if (!registry[type]) {
@@ -136,7 +134,6 @@ qx.Bootstrap.define("qx.module.Event", {
       }
     },
 
-
     /**
      * Unregisters a normalization function from the given event types.
      *
@@ -144,13 +141,12 @@ qx.Bootstrap.define("qx.module.Event", {
      * @param types {String[]} List of event types
      * @param normalizer {Function} Normalizer function
      */
-    $unregisterEventNormalization : function(types, normalizer)
-    {
+    $unregisterEventNormalization(types, normalizer) {
       if (!qx.lang.Type.isArray(types)) {
         types = [types];
       }
       var registry = qx.module.Event.__normalizations;
-      for (var i=0,l=types.length; i<l; i++) {
+      for (var i = 0, l = types.length; i < l; i++) {
         var type = types[i];
         if (registry[type]) {
           qx.lang.Array.remove(registry[type], normalizer);
@@ -158,19 +154,16 @@ qx.Bootstrap.define("qx.module.Event", {
       }
     },
 
-
     /**
      * Returns all registered event normalizers
      *
      * @attachStatic {qxWeb, $getEventNormalizationRegistry}
      * @return {Map} Map of event types/normalizer functions
      */
-    $getEventNormalizationRegistry : function()
-    {
+    $getEventNormalizationRegistry() {
       return qx.module.Event.__normalizations;
     },
 
-
     /**
      * Registers an event hook for the given event types.
      *
@@ -180,13 +173,12 @@ qx.Bootstrap.define("qx.module.Event", {
      * @param unregisterHook {Function?} Hook function to be called on event deregistration
      * @internal
      */
-    $registerEventHook : function(types, registerHook, unregisterHook)
-    {
+    $registerEventHook(types, registerHook, unregisterHook) {
       if (!qx.lang.Type.isArray(types)) {
         types = [types];
       }
       var onHooks = qx.module.Event.__hooks.on;
-      for (var i=0,l=types.length; i<l; i++) {
+      for (var i = 0, l = types.length; i < l; i++) {
         var type = types[i];
         if (qx.lang.Type.isFunction(registerHook)) {
           if (!onHooks[type]) {
@@ -199,7 +191,7 @@ qx.Bootstrap.define("qx.module.Event", {
         return;
       }
       var offHooks = qx.module.Event.__hooks.off;
-      for (var i=0,l=types.length; i<l; i++) {
+      for (var i = 0, l = types.length; i < l; i++) {
         var type = types[i];
         if (qx.lang.Type.isFunction(unregisterHook)) {
           if (!offHooks[type]) {
@@ -210,7 +202,6 @@ qx.Bootstrap.define("qx.module.Event", {
       }
     },
 
-
     /**
      * Unregisters a hook from the given event types.
      *
@@ -220,13 +211,12 @@ qx.Bootstrap.define("qx.module.Event", {
      * @param unregisterHook {Function?} Hook function to be called on event deregistration
      * @internal
      */
-    $unregisterEventHook : function(types, registerHook, unregisterHook)
-    {
+    $unregisterEventHook(types, registerHook, unregisterHook) {
       if (!qx.lang.Type.isArray(types)) {
         types = [types];
       }
       var onHooks = qx.module.Event.__hooks.on;
-      for (var i=0,l=types.length; i<l; i++) {
+      for (var i = 0, l = types.length; i < l; i++) {
         var type = types[i];
         if (onHooks[type]) {
           qx.lang.Array.remove(onHooks[type], registerHook);
@@ -236,7 +226,7 @@ qx.Bootstrap.define("qx.module.Event", {
         return;
       }
       var offHooks = qx.module.Event.__hooks.off;
-      for (var i=0,l=types.length; i<l; i++) {
+      for (var i = 0, l = types.length; i < l; i++) {
         var type = types[i];
         if (offHooks[type]) {
           qx.lang.Array.remove(offHooks[type], unregisterHook);
@@ -244,7 +234,6 @@ qx.Bootstrap.define("qx.module.Event", {
       }
     },
 
-
     /**
      * Returns all registered event hooks
      *
@@ -252,15 +241,12 @@ qx.Bootstrap.define("qx.module.Event", {
      * @return {Map} Map of event types/registration hook functions
      * @internal
      */
-    $getEventHookRegistry : function()
-    {
+    $getEventHookRegistry() {
       return qx.module.Event.__hooks;
     }
   },
 
-
-  members :
-  {
+  members: {
     /**
      * Registers a listener for the given event type on each item in the
      * collection. This can be either native or custom events.
@@ -274,8 +260,8 @@ qx.Bootstrap.define("qx.module.Event", {
      * phase if true
      * @return {qxWeb} The collection for chaining
      */
-    on : function(type, listener, context, useCapture) {
-      for (var i=0; i < this.length; i++) {
+    on(type, listener, context, useCapture) {
+      for (var i = 0; i < this.length; i++) {
         var el = this[i];
         var ctx = context || qxWeb(el);
 
@@ -287,11 +273,11 @@ qx.Bootstrap.define("qx.module.Event", {
         if (hooks[type]) {
           typeHooks = typeHooks.concat(hooks[type]);
         }
-        for (var j=0, m=typeHooks.length; j<m; j++) {
+        for (var j = 0, m = typeHooks.length; j < m; j++) {
           typeHooks[j](el, type, listener, context);
         }
 
-        var bound = function(el, event) {
+        var bound = function (el, event) {
           // apply normalizations
           var registry = qx.module.Event.__normalizations;
           // generic
@@ -301,7 +287,7 @@ qx.Bootstrap.define("qx.module.Event", {
             normalizations = normalizations.concat(registry[type]);
           }
 
-          for (var x=0, y=normalizations.length; x<y; x++) {
+          for (var x = 0, y = normalizations.length; x < y; x++) {
             event = normalizations[x](event, el, type);
           }
           // call original listener with normalized event
@@ -319,7 +305,8 @@ qx.Bootstrap.define("qx.module.Event", {
 
         el.$$lastlistenerId = el.$$emitter.on(type, bound, ctx);
         // save the useCapture for removing
-        el.$$emitter.getEntryById(el.$$lastlistenerId).useCapture = !!useCapture;
+        el.$$emitter.getEntryById(el.$$lastlistenerId).useCapture =
+          !!useCapture;
 
         if (!el.__listener) {
           el.__listener = {};
@@ -341,7 +328,6 @@ qx.Bootstrap.define("qx.module.Event", {
       return this;
     },
 
-
     /**
      * Unregisters event listeners for the given type from each element in the
      * collection.
@@ -354,10 +340,10 @@ qx.Bootstrap.define("qx.module.Event", {
      * phase if true
      * @return {qxWeb} The collection for chaining
      */
-    off : function(type, listener, context, useCapture) {
-      var removeAll = (listener === null && context === null);
+    off(type, listener, context, useCapture) {
+      var removeAll = listener === null && context === null;
 
-      for (var j=0; j < this.length; j++) {
+      for (var j = 0; j < this.length; j++) {
         var el = this[j];
 
         // continue if no listeners are available
@@ -375,23 +361,37 @@ qx.Bootstrap.define("qx.module.Event", {
           }
         }
 
-        for (var i=0, l=types.length; i<l; i++) {
+        for (var i = 0, l = types.length; i < l; i++) {
           for (var id in el.__listener[types[i]]) {
             var storedListener = el.__listener[types[i]][id];
-            if (removeAll || storedListener == listener || storedListener.original == listener) {
+            if (
+              removeAll ||
+              storedListener == listener ||
+              storedListener.original == listener
+            ) {
               // get the stored context
-              var hasStoredContext = typeof el.__ctx !== "undefined" && el.__ctx[id];
+              var hasStoredContext =
+                typeof el.__ctx !== "undefined" && el.__ctx[id];
               var storedContext;
               if (!context && hasStoredContext) {
                 storedContext = el.__ctx[id];
               }
               // remove the listener from the emitter
-              var result = el.$$emitter.off(types[i], storedListener, storedContext || context);
+              var result = el.$$emitter.off(
+                types[i],
+                storedListener,
+                storedContext || context
+              );
 
               // check if it's a bound listener which means it was a native event
               if (removeAll || storedListener.original == listener) {
                 // remove the native listener
-                qx.bom.Event.removeNativeListener(el, types[i], storedListener, useCapture);
+                qx.bom.Event.removeNativeListener(
+                  el,
+                  types[i],
+                  storedListener,
+                  useCapture
+                );
               }
 
               // BUG #9184
@@ -414,11 +414,10 @@ qx.Bootstrap.define("qx.module.Event", {
           if (hooks[type]) {
             typeHooks = typeHooks.concat(hooks[type]);
           }
-          for (var k=0, m=typeHooks.length; k<m; k++) {
+          for (var k = 0, m = typeHooks.length; k < m; k++) {
             typeHooks[k](el, type, listener, context);
           }
         }
-
       }
 
       return this;
@@ -432,7 +431,7 @@ qx.Bootstrap.define("qx.module.Event", {
      * @param type {String?} Event type. All listeners will be removed if this is undefined.
      * @return {qxWeb} The collection for chaining
      */
-    allOff : function(type) {
+    allOff(type) {
       return this.off(type || null, null, null);
     },
 
@@ -441,9 +440,14 @@ qx.Bootstrap.define("qx.module.Event", {
      * @param id {Number} The id of the listener to remove
      * @return {qxWeb} The collection for chaining.
      */
-    offById : function(id) {
+    offById(id) {
       var entry = this[0].$$emitter.getEntryById(id);
-      return this.off(entry.name, entry.listener.original, entry.ctx, entry.useCapture);
+      return this.off(
+        entry.name,
+        entry.listener.original,
+        entry.ctx,
+        entry.useCapture
+      );
     },
 
     /**
@@ -455,8 +459,8 @@ qx.Bootstrap.define("qx.module.Event", {
      * callback function.
      * @return {qxWeb} The collection for chaining
      */
-    emit : function(type, data) {
-      for (var j=0; j < this.length; j++) {
+    emit(type, data) {
+      for (var j = 0; j < this.length; j++) {
         var el = this[j];
         if (el.$$emitter) {
           el.$$emitter.emit(type, data);
@@ -465,7 +469,6 @@ qx.Bootstrap.define("qx.module.Event", {
       return this;
     },
 
-
     /**
      * Attaches a listener for the given event that will be executed only once.
      *
@@ -476,9 +479,9 @@ qx.Bootstrap.define("qx.module.Event", {
      * Default: The element on which the listener was registered
      * @return {qxWeb} The collection for chaining
      */
-    once : function(type, listener, context) {
+    once(type, listener, context) {
       var self = this;
-      var wrappedListener = function(data) {
+      var wrappedListener = function (data) {
         self.off(type, wrappedListener, context);
         listener.call(this, data);
       };
@@ -486,7 +489,6 @@ qx.Bootstrap.define("qx.module.Event", {
       return this;
     },
 
-
     /**
      * Checks if one or more listeners for the given event type are attached to
      * the first element in the collection.
@@ -500,10 +502,12 @@ qx.Bootstrap.define("qx.module.Event", {
      * @param context {Object?} Context object listener to check for.
      * @return {Boolean} <code>true</code> if one or more listeners are attached
      */
-    hasListener : function(type, listener, context) {
-      if (!this[0] || !this[0].$$emitter ||
-        !this[0].$$emitter.getListeners()[type])
-      {
+    hasListener(type, listener, context) {
+      if (
+        !this[0] ||
+        !this[0].$$emitter ||
+        !this[0].$$emitter.getListeners()[type]
+      ) {
         return false;
       }
 
@@ -514,9 +518,11 @@ qx.Bootstrap.define("qx.module.Event", {
           if (attachedListeners[i].listener == listener) {
             hasListener = true;
           }
-          if (attachedListeners[i].listener.original &&
-              attachedListeners[i].listener.original == listener) {
-            hasListener =  true;
+          if (
+            attachedListeners[i].listener.original &&
+            attachedListeners[i].listener.original == listener
+          ) {
+            hasListener = true;
           }
 
           if (hasListener) {
@@ -534,7 +540,6 @@ qx.Bootstrap.define("qx.module.Event", {
       return this[0].$$emitter.getListeners()[type].length > 0;
     },
 
-
     /**
      * Copies any event listeners that are attached to the elements in the
      * collection to the provided target element
@@ -542,7 +547,7 @@ qx.Bootstrap.define("qx.module.Event", {
      * @internal
      * @param target {Element} Element to attach the copied listeners to
      */
-    copyEventsTo : function(target) {
+    copyEventsTo(target) {
       // Copy both arrays to make sure the original collections are not manipulated.
       // If e.g. the 'target' array contains a DOM node with child nodes we run into
       // problems because the 'target' array is flattened within this method.
@@ -552,23 +557,23 @@ qx.Bootstrap.define("qx.module.Event", {
       // get all children of source and target
       for (var i = source.length - 1; i >= 0; i--) {
         var descendants = source[i].getElementsByTagName("*");
-        for (var j=0; j < descendants.length; j++) {
+        for (var j = 0; j < descendants.length; j++) {
           source.push(descendants[j]);
         }
       }
 
-      for (var i = targetCopy.length -1; i >= 0; i--) {
+      for (var i = targetCopy.length - 1; i >= 0; i--) {
         var descendants = targetCopy[i].getElementsByTagName("*");
-        for (var j=0; j < descendants.length; j++) {
+        for (var j = 0; j < descendants.length; j++) {
           targetCopy.push(descendants[j]);
         }
       }
       // make sure no emitter object has been copied
-      targetCopy.forEach(function(el) {
+      targetCopy.forEach(function (el) {
         el.$$emitter = null;
       });
 
-      for (var i=0; i < source.length; i++) {
+      for (var i = 0; i < source.length; i++) {
         var el = source[i];
         if (!el.$$emitter) {
           continue;
@@ -586,8 +591,6 @@ qx.Bootstrap.define("qx.module.Event", {
       }
     },
 
-
-
     /**
      * Bind one or two callbacks to the collection.
      * If only the first callback is defined the collection
@@ -599,8 +602,7 @@ qx.Bootstrap.define("qx.module.Event", {
      * @param callbackOut {Function?} callback when hovering out
      * @return {qxWeb} The collection for chaining
      */
-    hover : function(callbackIn, callbackOut) {
-
+    hover(callbackIn, callbackOut) {
       this.on("pointerover", callbackIn, this);
 
       if (qx.lang.Type.isFunction(callbackOut)) {
@@ -610,7 +612,6 @@ qx.Bootstrap.define("qx.module.Event", {
       return this;
     },
 
-
     /**
      * Adds a listener for the given type and checks if the target fulfills the selector check.
      * If the check is successful the callback is executed with the target and event as arguments.
@@ -625,19 +626,18 @@ qx.Bootstrap.define("qx.module.Event", {
      * @param context {Object?} optional context object to call the callback
      * @return {qxWeb} The collection for chaining
      */
-    onMatchTarget : function(eventType, target, callback, context) {
-
+    onMatchTarget(eventType, target, callback, context) {
       context = context !== undefined ? context : this;
 
-      var listener = function(e){
-
+      var listener = function (e) {
         var eventTarget = qxWeb(e.getTarget());
         if (eventTarget.is(target)) {
           callback.call(context, eventTarget, qxWeb.object.clone(e));
         } else {
-          var targetToMatch = typeof target == "string" ? this.find(target) : qxWeb(target);
-          for(var i = 0, l = targetToMatch.length; i < l; i++) {
-            if(eventTarget.isChildOf(qxWeb(targetToMatch[i]))) {
+          var targetToMatch =
+            typeof target == "string" ? this.find(target) : qxWeb(target);
+          for (var i = 0, l = targetToMatch.length; i < l; i++) {
+            if (eventTarget.isChildOf(qxWeb(targetToMatch[i]))) {
               callback.call(context, eventTarget, qxWeb.object.clone(e));
               break;
             }
@@ -647,12 +647,12 @@ qx.Bootstrap.define("qx.module.Event", {
 
       // make sure to store the infos for 'offMatchTarget' at each element of the collection
       // to be able to remove the listener separately
-      this.forEach(function(el) {
+      this.forEach(function (el) {
         var matchTarget = {
-          type : eventType,
-          listener : listener,
-          callback : callback,
-          context : context
+          type: eventType,
+          listener: listener,
+          callback: callback,
+          context: context
         };
 
         if (!el.$$matchTargetInfo) {
@@ -666,7 +666,6 @@ qx.Bootstrap.define("qx.module.Event", {
       return this;
     },
 
-
     /**
      * Removes a listener for the given type and selector check.
      *
@@ -679,27 +678,26 @@ qx.Bootstrap.define("qx.module.Event", {
      * @param context {Object?} optional context object to remove
      * @return {qxWeb} The collection for chaining
      */
-    offMatchTarget : function(eventType, target, callback, context) {
-
+    offMatchTarget(eventType, target, callback, context) {
       context = context !== undefined ? context : this;
 
-      this.forEach(function(el) {
-
-        if (el.$$matchTargetInfo && qxWeb.type.get(el.$$matchTargetInfo) == "Array") {
-
+      this.forEach(function (el) {
+        if (
+          el.$$matchTargetInfo &&
+          qxWeb.type.get(el.$$matchTargetInfo) == "Array"
+        ) {
           var infos = el.$$matchTargetInfo;
 
-          for (var i=infos.length - 1; i>=0; i--) {
-
+          for (var i = infos.length - 1; i >= 0; i--) {
             var entry = infos[i];
-            if (entry.type == eventType &&
-                entry.callback == callback &&
-                entry.context == context) {
-
+            if (
+              entry.type == eventType &&
+              entry.callback == callback &&
+              entry.context == context
+            ) {
               this.off(eventType, entry.listener);
               infos.splice(i, 1);
             }
-
           }
 
           if (infos.length === 0) {
@@ -712,17 +710,16 @@ qx.Bootstrap.define("qx.module.Event", {
     }
   },
 
-
-  defer : function(statics) {
+  defer(statics) {
     qxWeb.$attachAll(this);
     // manually attach internal $-methods as they are ignored by the previous method-call
     qxWeb.$attachStatic({
-      "$registerEventNormalization" : statics.$registerEventNormalization,
-      "$unregisterEventNormalization" : statics.$unregisterEventNormalization,
-      "$getEventNormalizationRegistry" : statics.$getEventNormalizationRegistry,
-      "$registerEventHook" : statics.$registerEventHook,
-      "$unregisterEventHook" : statics.$unregisterEventHook,
-      "$getEventHookRegistry" : statics.$getEventHookRegistry
+      $registerEventNormalization: statics.$registerEventNormalization,
+      $unregisterEventNormalization: statics.$unregisterEventNormalization,
+      $getEventNormalizationRegistry: statics.$getEventNormalizationRegistry,
+      $registerEventHook: statics.$registerEventHook,
+      $unregisterEventHook: statics.$unregisterEventHook,
+      $getEventHookRegistry: statics.$getEventHookRegistry
     });
   }
 });