yui / yui3

0
@@ -79,8 +79,8 @@ YUI.add('plugin', function(Y) {
0
          * @param {Object} config Configuration object with property name/value pairs.
0
          */
0
         initializer : function(config) {
0
-            this._handles = [];
0
             if (!this.get("host")) { Y.log('No host defined for plugin ' + this, 'warn', 'Plugin');}
0
+            this._handles = [];
0
             Y.log('Initializing: ' + this.constructor.NAME, 'info', 'Plugin');
0
         },
0
 
0
@@ -106,24 +106,20 @@ YUI.add('plugin', function(Y) {
0
          *
0
          * @method doBefore
0
          *
0
-         * @param sFn {String} The event to listen for, or method to inject logic before.
0
+         * @param strMethod {String} The event to listen for, or method to inject logic before.
0
          * @param fn {Function} The handler function. For events, the "on" moment listener. For methods, the function to execute before the given method is executed.
0
          * @param context {Object} An optional context to call the handler with. The default context is the plugin instance.
0
          * @return handle {EventHandle} The detach handle for the handler.
0
          */
0
-        doBefore: function(sFn, fn, context) {
0
-            var host = this.get("host"),
0
-                handle;
0
-
0
-            context = context || this;
0
+        doBefore: function(strMethod, fn, context) {
0
+            var host = this.get("host"), handle;
0
 
0
-            if (sFn in host) { // method
0
-                handle = Y.Do.before(fn, host, sFn, context);
0
+            if (strMethod in host) { // method
0
+                handle = this.beforeHostMethod(strMethod, fn, context);
0
             } else if (host.on) { // event
0
-                handle = host.on(sFn, fn, context);
0
+                handle = this.onHostEvent(strMethod, fn, context);
0
             }
0
 
0
-            this._handles.push(handle);
0
             return handle;
0
         },
0
 
0
@@ -133,23 +129,87 @@ YUI.add('plugin', function(Y) {
0
          *
0
          * @method doAfter
0
          *
0
-         * @param sFn {String} The event to listen for, or method to inject logic after.
0
+         * @param strMethod {String} The event to listen for, or method to inject logic after.
0
          * @param fn {Function} The handler function. For events, the "after" moment listener. For methods, the function to execute after the given method is executed.
0
          * @param context {Object} An optional context to call the handler with. The default context is the plugin instance.
0
-         * @return handle {EventHandle} The detach handle for the handler.
0
+         * @return handle {EventHandle} The detach handle for the listener.
0
          */
0
-        doAfter: function(sFn, fn, context) {
0
-            var host = this.get("host"),
0
-                handle;
0
+        doAfter: function(strMethod, fn, context) {
0
+            var host = this.get("host"), handle;
0
 
0
-            context = context || this;
0
-
0
-            if (sFn in host) { // method
0
-                handle = Y.Do.after(fn, host, sFn, context);
0
+            if (strMethod in host) { // method
0
+                handle = this.afterHostMethod(strMethod, fn, context);
0
             } else if (host.after) { // event
0
-                handle = host.after(sFn, fn, context);
0
+                handle = this.afterHostEvent(strMethod, fn, context);
0
             }
0
 
0
+            return handle;
0
+        },
0
+
0
+        /**
0
+         * Listens for the "on" moment of events fired by the host object.
0
+         *
0
+         * Listeners attached through this method will be detached when the plugin is unplugged.
0
+         * 
0
+         * @method onHostEvent
0
+         * @param {String | Object} type The event type.
0
+         * @param {Function} fn The listener.
0
+         * @param {Object} context The execution context. Defaults to the plugin instance.
0
+         * @return handle {EventHandle} The detach handle for the listener. 
0
+         */
0
+        onHostEvent : function(type, fn, context) {
0
+            var handle = this.get("host").after(type, fn, context || this);
0
+            this._handles.push(handle);
0
+            return handle;
0
+        },
0
+
0
+        /**
0
+         * Listens for the "after" moment of events fired by the host object.
0
+         *
0
+         * Listeners attached through this method will be detached when the plugin is unplugged.
0
+         * 
0
+         * @method afterHostEvent
0
+         * @param {String | Object} type The event type.
0
+         * @param {Function} fn The listener.
0
+         * @param {Object} context The execution context. Defaults to the plugin instance.
0
+         * @return handle {EventHandle} The detach handle for the listener. 
0
+         */
0
+        afterHostEvent : function(type, fn, context) {
0
+            var handle = this.get("host").after(type, fn, context || this);
0
+            this._handles.push(handle);
0
+            return handle;
0
+        },
0
+
0
+        /**
0
+         * Injects a function to be executed before a given method on host object.
0
+         *
0
+         * The function will be detached when the plugin is unplugged.
0
+         *
0
+         * @method beforeHostMethod
0
+         * @param {String} The name of the method to inject the function before.
0
+         * @param {Function} fn The function to inject.
0
+         * @param {Object} context The execution context. Defaults to the plugin instance.
0
+         * @return handle {EventHandle} The detach handle for the injected function. 
0
+         */
0
+        beforeHostMethod : function(strMethod, fn, context) {
0
+            var handle = Y.Do.before(fn, this.get("host"), strMethod, context || this);
0
+            this._handles.push(handle);
0
+            return handle;
0
+        },
0
+
0
+        /**
0
+         * Injects a function to be executed after a given method on host object.
0
+         *
0
+         * The function will be detached when the plugin is unplugged.
0
+         *
0
+         * @method afterHostMethod
0
+         * @param {String} The name of the method to inject the function after.
0
+         * @param {Function} fn The function to inject.
0
+         * @param {Object} context The execution context. Defaults to the plugin instance.
0
+         * @return handle {EventHandle} The detach handle for the injected function. 
0
+         */
0
+        afterHostMethod : function(strMethod, fn, context) {
0
+            var handle = Y.Do.after(fn, this.get("host"), strMethod, context || this);
0
             this._handles.push(handle);
0
             return handle;
0
         },

0
@@ -1 +1 @@
0
-YUI.add("plugin",function(B){function A(C){A.superclass.constructor.apply(this,arguments);}A.ATTRS={host:{writeOnce:true}};A.NAME="plugin";A.NS="plugin";B.extend(A,B.Base,{_handles:null,initializer:function(C){this._handles=[];},destructor:function(){if(this._handles){for(var D=0,C=this._handles.length;D<C;D++){this._handles[D].detach();}}},doBefore:function(G,D,C){var E=this.get("host"),F;C=C||this;if(G in E){F=B.Do.before(D,E,G,C);}else{if(E.on){F=E.on(G,D,C);}}this._handles.push(F);return F;},doAfter:function(G,D,C){var E=this.get("host"),F;C=C||this;if(G in E){F=B.Do.after(D,E,G,C);}else{if(E.after){F=E.after(G,D,C);}}this._handles.push(F);return F;},toString:function(){return this.constructor.NAME+"["+this.constructor.NS+"]";}});B.namespace("Plugin").Base=A;},"@VERSION@",{requires:["base-base"]});
0
\ No newline at end of file
0
+YUI.add("plugin",function(B){function A(C){A.superclass.constructor.apply(this,arguments);}A.ATTRS={host:{writeOnce:true}};A.NAME="plugin";A.NS="plugin";B.extend(A,B.Base,{_handles:null,initializer:function(C){this._handles=[];},destructor:function(){if(this._handles){for(var D=0,C=this._handles.length;D<C;D++){this._handles[D].detach();}}},doBefore:function(G,D,C){var E=this.get("host"),F;if(G in E){F=this.beforeHostMethod(G,D,C);}else{if(E.on){F=this.onHostEvent(G,D,C);}}return F;},doAfter:function(G,D,C){var E=this.get("host"),F;if(G in E){F=this.afterHostMethod(G,D,C);}else{if(E.after){F=this.afterHostEvent(G,D,C);}}return F;},onHostEvent:function(E,D,C){var F=this.get("host").after(E,D,C||this);this._handles.push(F);return F;},afterHostEvent:function(E,D,C){var F=this.get("host").after(E,D,C||this);this._handles.push(F);return F;},beforeHostMethod:function(F,D,C){var E=B.Do.before(D,this.get("host"),F,C||this);this._handles.push(E);return E;},afterHostMethod:function(F,D,C){var E=B.Do.after(D,this.get("host"),F,C||this);this._handles.push(E);return E;},toString:function(){return this.constructor.NAME+"["+this.constructor.NS+"]";}});B.namespace("Plugin").Base=A;},"@VERSION@",{requires:["base-base"]});
0
\ No newline at end of file

0
@@ -104,24 +104,20 @@ YUI.add('plugin', function(Y) {
0
          *
0
          * @method doBefore
0
          *
0
-         * @param sFn {String} The event to listen for, or method to inject logic before.
0
+         * @param strMethod {String} The event to listen for, or method to inject logic before.
0
          * @param fn {Function} The handler function. For events, the "on" moment listener. For methods, the function to execute before the given method is executed.
0
          * @param context {Object} An optional context to call the handler with. The default context is the plugin instance.
0
          * @return handle {EventHandle} The detach handle for the handler.
0
          */
0
-        doBefore: function(sFn, fn, context) {
0
-            var host = this.get("host"),
0
-                handle;
0
+        doBefore: function(strMethod, fn, context) {
0
+            var host = this.get("host"), handle;
0
 
0
-            context = context || this;
0
-
0
-            if (sFn in host) { // method
0
-                handle = Y.Do.before(fn, host, sFn, context);
0
+            if (strMethod in host) { // method
0
+                handle = this.beforeHostMethod(strMethod, fn, context);
0
             } else if (host.on) { // event
0
-                handle = host.on(sFn, fn, context);
0
+                handle = this.onHostEvent(strMethod, fn, context);
0
             }
0
 
0
-            this._handles.push(handle);
0
             return handle;
0
         },
0
 
0
@@ -131,23 +127,87 @@ YUI.add('plugin', function(Y) {
0
          *
0
          * @method doAfter
0
          *
0
-         * @param sFn {String} The event to listen for, or method to inject logic after.
0
+         * @param strMethod {String} The event to listen for, or method to inject logic after.
0
          * @param fn {Function} The handler function. For events, the "after" moment listener. For methods, the function to execute after the given method is executed.
0
          * @param context {Object} An optional context to call the handler with. The default context is the plugin instance.
0
-         * @return handle {EventHandle} The detach handle for the handler.
0
+         * @return handle {EventHandle} The detach handle for the listener.
0
          */
0
-        doAfter: function(sFn, fn, context) {
0
-            var host = this.get("host"),
0
-                handle;
0
+        doAfter: function(strMethod, fn, context) {
0
+            var host = this.get("host"), handle;
0
 
0
-            context = context || this;
0
-
0
-            if (sFn in host) { // method
0
-                handle = Y.Do.after(fn, host, sFn, context);
0
+            if (strMethod in host) { // method
0
+                handle = this.afterHostMethod(strMethod, fn, context);
0
             } else if (host.after) { // event
0
-                handle = host.after(sFn, fn, context);
0
+                handle = this.afterHostEvent(strMethod, fn, context);
0
             }
0
 
0
+            return handle;
0
+        },
0
+
0
+        /**
0
+         * Listens for the "on" moment of events fired by the host object.
0
+         *
0
+         * Listeners attached through this method will be detached when the plugin is unplugged.
0
+         * 
0
+         * @method onHostEvent
0
+         * @param {String | Object} type The event type.
0
+         * @param {Function} fn The listener.
0
+         * @param {Object} context The execution context. Defaults to the plugin instance.
0
+         * @return handle {EventHandle} The detach handle for the listener. 
0
+         */
0
+        onHostEvent : function(type, fn, context) {
0
+            var handle = this.get("host").after(type, fn, context || this);
0
+            this._handles.push(handle);
0
+            return handle;
0
+        },
0
+
0
+        /**
0
+         * Listens for the "after" moment of events fired by the host object.
0
+         *
0
+         * Listeners attached through this method will be detached when the plugin is unplugged.
0
+         * 
0
+         * @method afterHostEvent
0
+         * @param {String | Object} type The event type.
0
+         * @param {Function} fn The listener.
0
+         * @param {Object} context The execution context. Defaults to the plugin instance.
0
+         * @return handle {EventHandle} The detach handle for the listener. 
0
+         */
0
+        afterHostEvent : function(type, fn, context) {
0
+            var handle = this.get("host").after(type, fn, context || this);
0
+            this._handles.push(handle);
0
+            return handle;
0
+        },
0
+
0
+        /**
0
+         * Injects a function to be executed before a given method on host object.
0
+         *
0
+         * The function will be detached when the plugin is unplugged.
0
+         *
0
+         * @method beforeHostMethod
0
+         * @param {String} The name of the method to inject the function before.
0
+         * @param {Function} fn The function to inject.
0
+         * @param {Object} context The execution context. Defaults to the plugin instance.
0
+         * @return handle {EventHandle} The detach handle for the injected function. 
0
+         */
0
+        beforeHostMethod : function(strMethod, fn, context) {
0
+            var handle = Y.Do.before(fn, this.get("host"), strMethod, context || this);
0
+            this._handles.push(handle);
0
+            return handle;
0
+        },
0
+
0
+        /**
0
+         * Injects a function to be executed after a given method on host object.
0
+         *
0
+         * The function will be detached when the plugin is unplugged.
0
+         *
0
+         * @method afterHostMethod
0
+         * @param {String} The name of the method to inject the function after.
0
+         * @param {Function} fn The function to inject.
0
+         * @param {Object} context The execution context. Defaults to the plugin instance.
0
+         * @return handle {EventHandle} The detach handle for the injected function. 
0
+         */
0
+        afterHostMethod : function(strMethod, fn, context) {
0
+            var handle = Y.Do.after(fn, this.get("host"), strMethod, context || this);
0
             this._handles.push(handle);
0
             return handle;
0
         },

0
@@ -77,8 +77,8 @@
0
          * @param {Object} config Configuration object with property name/value pairs.
0
          */
0
         initializer : function(config) {
0
-            this._handles = [];
0
             if (!this.get("host")) { Y.log('No host defined for plugin ' + this, 'warn', 'Plugin');}
0
+            this._handles = [];
0
             Y.log('Initializing: ' + this.constructor.NAME, 'info', 'Plugin');
0
         },
0
 
0
@@ -104,24 +104,20 @@
0
          *
0
          * @method doBefore
0
          *
0
-         * @param sFn {String} The event to listen for, or method to inject logic before.
0
+         * @param strMethod {String} The event to listen for, or method to inject logic before.
0
          * @param fn {Function} The handler function. For events, the "on" moment listener. For methods, the function to execute before the given method is executed.
0
          * @param context {Object} An optional context to call the handler with. The default context is the plugin instance.
0
          * @return handle {EventHandle} The detach handle for the handler.
0
          */
0
-        doBefore: function(sFn, fn, context) {
0
-            var host = this.get("host"),
0
-                handle;
0
-
0
-            context = context || this;
0
+        doBefore: function(strMethod, fn, context) {
0
+            var host = this.get("host"), handle;
0
 
0
-            if (sFn in host) { // method
0
-                handle = Y.Do.before(fn, host, sFn, context);
0
+            if (strMethod in host) { // method
0
+                handle = this.beforeHostMethod(strMethod, fn, context);
0
             } else if (host.on) { // event
0
-                handle = host.on(sFn, fn, context);
0
+                handle = this.onHostEvent(strMethod, fn, context);
0
             }
0
 
0
-            this._handles.push(handle);
0
             return handle;
0
         },
0
 
0
@@ -131,23 +127,87 @@
0
          *
0
          * @method doAfter
0
          *
0
-         * @param sFn {String} The event to listen for, or method to inject logic after.
0
+         * @param strMethod {String} The event to listen for, or method to inject logic after.
0
          * @param fn {Function} The handler function. For events, the "after" moment listener. For methods, the function to execute after the given method is executed.
0
          * @param context {Object} An optional context to call the handler with. The default context is the plugin instance.
0
-         * @return handle {EventHandle} The detach handle for the handler.
0
+         * @return handle {EventHandle} The detach handle for the listener.
0
          */
0
-        doAfter: function(sFn, fn, context) {
0
-            var host = this.get("host"),
0
-                handle;
0
+        doAfter: function(strMethod, fn, context) {
0
+            var host = this.get("host"), handle;
0
 
0
-            context = context || this;
0
-
0
-            if (sFn in host) { // method
0
-                handle = Y.Do.after(fn, host, sFn, context);
0
+            if (strMethod in host) { // method
0
+                handle = this.afterHostMethod(strMethod, fn, context);
0
             } else if (host.after) { // event
0
-                handle = host.after(sFn, fn, context);
0
+                handle = this.afterHostEvent(strMethod, fn, context);
0
             }
0
 
0
+            return handle;
0
+        },
0
+
0
+        /**
0
+         * Listens for the "on" moment of events fired by the host object.
0
+         *
0
+         * Listeners attached through this method will be detached when the plugin is unplugged.
0
+         * 
0
+         * @method onHostEvent
0
+         * @param {String | Object} type The event type.
0
+         * @param {Function} fn The listener.
0
+         * @param {Object} context The execution context. Defaults to the plugin instance.
0
+         * @return handle {EventHandle} The detach handle for the listener. 
0
+         */
0
+        onHostEvent : function(type, fn, context) {
0
+            var handle = this.get("host").after(type, fn, context || this);
0
+            this._handles.push(handle);
0
+            return handle;
0
+        },
0
+
0
+        /**
0
+         * Listens for the "after" moment of events fired by the host object.
0
+         *
0
+         * Listeners attached through this method will be detached when the plugin is unplugged.
0
+         * 
0
+         * @method afterHostEvent
0
+         * @param {String | Object} type The event type.
0
+         * @param {Function} fn The listener.
0
+         * @param {Object} context The execution context. Defaults to the plugin instance.
0
+         * @return handle {EventHandle} The detach handle for the listener. 
0
+         */
0
+        afterHostEvent : function(type, fn, context) {
0
+            var handle = this.get("host").after(type, fn, context || this);
0
+            this._handles.push(handle);
0
+            return handle;
0
+        },
0
+
0
+        /**
0
+         * Injects a function to be executed before a given method on host object.
0
+         *
0
+         * The function will be detached when the plugin is unplugged.
0
+         *
0
+         * @method beforeHostMethod
0
+         * @param {String} The name of the method to inject the function before.
0
+         * @param {Function} fn The function to inject.
0
+         * @param {Object} context The execution context. Defaults to the plugin instance.
0
+         * @return handle {EventHandle} The detach handle for the injected function. 
0
+         */
0
+        beforeHostMethod : function(strMethod, fn, context) {
0
+            var handle = Y.Do.before(fn, this.get("host"), strMethod, context || this);
0
+            this._handles.push(handle);
0
+            return handle;
0
+        },
0
+
0
+        /**
0
+         * Injects a function to be executed after a given method on host object.
0
+         *
0
+         * The function will be detached when the plugin is unplugged.
0
+         *
0
+         * @method afterHostMethod
0
+         * @param {String} The name of the method to inject the function after.
0
+         * @param {Function} fn The function to inject.
0
+         * @param {Object} context The execution context. Defaults to the plugin instance.
0
+         * @return handle {EventHandle} The detach handle for the injected function. 
0
+         */
0
+        afterHostMethod : function(strMethod, fn, context) {
0
+            var handle = Y.Do.after(fn, this.get("host"), strMethod, context || this);
0
             this._handles.push(handle);
0
             return handle;
0
         },