src/cm/media/js/lib/yui/yui3.0.0/releasenotes/README.event-custom
changeset 0 40c8f766c9b8
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/src/cm/media/js/lib/yui/yui3.0.0/releasenotes/README.event-custom	Mon Nov 23 15:14:29 2009 +0100
@@ -0,0 +1,37 @@
+YUI Custom Events
+    Custom event system
+
+3.0.0
+    - Broken into core base and complex modules.
+    - broadcast works for simple events.
+    - If configured to return an event handle, the return value
+      will always be a single object, regardless of how many listeners
+      were attached.  Previously, multiple listeners provided an array
+      of detach handles.
+
+3.0.0beta1
+    - Implemented the broadcast flag.  broadcast = 1: local, accessible
+      via Y.on('prefix:event'). broadcast = 2: global, accessible
+      via Y.on or globally via Y.Global.on('prefix:event).  Broadcast 
+      listeners cannot effect the defaultFn or host subscribers (so
+      are in effect, after listeners), although this is still possible
+      by added either Y or Y.Global as event targets.
+    - Moved custom event out of event package
+    - EventTarget accepts a prefix configuration.  This is used
+      in all exposed methods to handle shortcuts to event names,
+      e.g., 'click' and 'menu:click' are the same if the prefix
+      is 'menu'
+    - Exposed methods are 'on' for the before moment, 'after' for
+      the after moment, and 'detach' for unsubscribe.  subscribe,
+      before, unsubscribe, and corresponding methods are deprecated.
+    - Event type accepts a event category which can be used to
+      detach events.  
+      Y.on('category|prefix:event', fn);
+      Y.detach('category|prefix:event');
+      Y.detach('category|*');
+    - Added 'chain' config to events that makes the return value the 
+      event target rather than a detach handle.  Use with the detach
+      category prefix.
+    - The type parameter can be an object containing multiple events to attach
+      Y.on( { 'event1': fn1, 'event2': fn2 }
+    - Y.fire payload for event facades can be another facade or a custom event.