src/cm/media/js/lib/yui/yui3.0.0/releasenotes/README.event-custom
author Yves-Marie Haussonne <ymh.work+github@gmail.com>
Fri, 09 May 2014 18:35:26 +0200
changeset 656 a84519031134
parent 0 40c8f766c9b8
permissions -rw-r--r--
add link to "privacy policy" in the header test
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
0
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     1
YUI Custom Events
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     2
    Custom event system
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     3
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     4
3.0.0
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     5
    - Broken into core base and complex modules.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     6
    - broadcast works for simple events.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     7
    - If configured to return an event handle, the return value
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     8
      will always be a single object, regardless of how many listeners
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
     9
      were attached.  Previously, multiple listeners provided an array
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    10
      of detach handles.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    11
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    12
3.0.0beta1
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    13
    - Implemented the broadcast flag.  broadcast = 1: local, accessible
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    14
      via Y.on('prefix:event'). broadcast = 2: global, accessible
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    15
      via Y.on or globally via Y.Global.on('prefix:event).  Broadcast 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    16
      listeners cannot effect the defaultFn or host subscribers (so
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    17
      are in effect, after listeners), although this is still possible
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    18
      by added either Y or Y.Global as event targets.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    19
    - Moved custom event out of event package
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    20
    - EventTarget accepts a prefix configuration.  This is used
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    21
      in all exposed methods to handle shortcuts to event names,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    22
      e.g., 'click' and 'menu:click' are the same if the prefix
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    23
      is 'menu'
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    24
    - Exposed methods are 'on' for the before moment, 'after' for
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    25
      the after moment, and 'detach' for unsubscribe.  subscribe,
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    26
      before, unsubscribe, and corresponding methods are deprecated.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    27
    - Event type accepts a event category which can be used to
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    28
      detach events.  
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    29
      Y.on('category|prefix:event', fn);
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    30
      Y.detach('category|prefix:event');
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    31
      Y.detach('category|*');
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    32
    - Added 'chain' config to events that makes the return value the 
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    33
      event target rather than a detach handle.  Use with the detach
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    34
      category prefix.
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    35
    - The type parameter can be an object containing multiple events to attach
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    36
      Y.on( { 'event1': fn1, 'event2': fn2 }
40c8f766c9b8 import from internal svn r 4007
raph
parents:
diff changeset
    37
    - Y.fire payload for event facades can be another facade or a custom event.