Class CustomEvent
The CustomEvent class lets you define events for your application
that can be subscribed to by one or more independent component.
Constructor
CustomEvent
(
type
,
o
)
- Parameters:
-
type
<String>
The type of event, which is passed to the callback
when the event fires
-
o
<object>
configuration object
Properties
If 0, this event does not broadcast. If 1, the YUI instance is notified
every time this event fires. If 2, the YUI instance and the YUI global
(if event is enabled on the global) are notified every time this event
fires.
Specifies whether or not a subscriber can stop the event propagation
via stopPropagation(), stopImmediatePropagation(), or halt()
Default Value: true
The context the the event will fire from by default. Defaults to the YUI
instance.
The default function to execute after event listeners
have fire, but only if the default action was not
prevented.
If set to true, the custom event will deliver an EventFacade object
that is similar to a DOM event object.
Default Value: false
This event has fired if true
Default Value: false;
An array containing the arguments the custom event
was last fired with.
This event should only fire one time if true, and if
it has fired, any new subscribers should be notified
immediately.
Default Value: false;
host
- EventTarget
Specifies the host for this custom event. This is used
to enable event bubbling
Specifies whether or not this event's default function
can be cancelled by a subscriber by executing preventDefault()
on the event facade
Default Value: true
Flag for preventDefault that is modified during fire().
if it is not 0, the default behavior for this event
The function to execute if a subscriber calls
preventDefault
Specifies whether this event should be queued when the host is actively
processing an event. This will effect exectution order of the callbacks
for the various events.
Default Value: false
Supports multiple options for listener signatures in order to
port YUI 2 apps.
Default Value: 9
By default all custom events are logged in the debug build, set silent
to true to disable debug outpu for this event.
Flag for stopPropagation that is modified during fire()
1 means to stop propagation to bubble targets. 2 means
to also stop additional subscribers on this target.
The function to execute if a subscriber calls
stopPropagation or stopImmediatePropagation
The subscribers to this event
type
- string
The type of event, returned to subscribers when the event fires
Methods
private
void
_delete
(
subscriber
)
- Parameters:
-
subscriber
<object>
object
private
void
_notify
(
s
,
args
)
Notify a single subscriber
- Parameters:
-
s
<Subscriber>
the subscriber
-
args
<Array>
the arguments array to apply to the listener
EventHandle|EventTarget
after
(
fn
)
Listen for this event after the normal subscribers have been notified and
the default behavior has been applied. If a normal subscriber prevents the
default behavior, it also prevents after listeners from firing.
- Parameters:
-
fn
<Function>
The function to execute
- Returns:
EventHandle|EventTarget
- unsubscribe handle or a
chainable event target depending on the 'chain' config.
void
applyConfig
(
o
,
force
)
Apply configuration properties. Only applies the CONFIG whitelist
- Parameters:
-
o
<object>
hash of properties to apply
-
force
<boolean>
if true, properties that exist on the event
will be overwritten.
int|EventTarget
detach
(
fn
,
context
)
Detach listeners.
- Parameters:
-
fn
<Function>
The subscribed function to remove, if not supplied
all will be removed
-
context
<Object>
The context object passed to subscribe.
- Returns:
int|EventTarget
- returns a chainable event target
or the number of subscribers unsubscribed.
int
detachAll
(
)
Removes all listeners
- Returns:
int
- The number of listeners unsubscribed
boolean
fire
(
arguments
)
Notifies the subscribers. The callback functions will be executed
from the context specified when the event was created, and with the
following parameters:
- The type of event
- All of the arguments fire() was executed with as an array
- The custom object (if any) that was passed into the subscribe()
method
- Parameters:
-
arguments
<Object*>
an arbitrary set of parameters to pass to
the handler.
- Returns:
boolean
- false if one of the subscribers returned false,
true otherwise
void
halt
(
immediate
)
Stops the event propagation and prevents the default
event behavior.
- Parameters:
-
immediate
<boolean>
if true additional listeners
on the current target will not be executed
void
log
(
msg
,
cat
)
Logger abstraction to centralize the application of the silent flag
- Parameters:
-
msg
<string>
message to log
-
cat
<string>
log category
EventHandle|EventTarget
on
(
fn
)
Listen for this event
- Parameters:
-
fn
<Function>
The function to execute
- Returns:
EventHandle|EventTarget
- unsubscribe handle or a
chainable event target depending on the 'chain' config.
void
preventDefault
(
)
Prevents the execution of this event's defaultFn
void
stopImmediatePropagation
(
)
Stops propagation to bubble targets, and prevents any remaining
subscribers on the current target from executing.
void
stopPropagation
(
)
Stop propagation to bubble targets
EventHandle|EventTarget
subscribe
(
fn
)
Listen for this event
- Parameters:
-
fn
<Function>
The function to execute
- Returns:
EventHandle|EventTarget
- unsubscribe handle or a
chainable event target depending on the 'chain' config.
Deprecated use on
boolean|EventTarget
unsubscribe
(
fn
,
context
)
Detach listeners.
- Parameters:
-
fn
<Function>
The subscribed function to remove, if not supplied
all will be removed
-
context
<Object>
The context object passed to subscribe.
- Returns:
boolean|EventTarget
- returns a chainable event target
or a boolean for legacy detach support.
Deprecated use detach
int
unsubscribeAll
(
)
Removes all listeners
- Returns:
int
- The number of listeners unsubscribed
Deprecated use detachAll