goog.events.Listenable
A listenable interface. A listenable is an object with the ability to dispatch/broadcast events to "event listeners" registered via listen/listenOnce.
The interface allows for an event propagation mechanism similar
to one offered by native browser event targets, such as
capture/bubble mechanism, stopping propagation, and preventing
default actions. Capture/bubble mechanism depends on the ancestor
tree constructed via #getParentEventTarget
; this tree
must be directed acyclic graph. The meaning of default action(s)
in preventDefault is specific to a particular use case.
Implementations that do not support capture/bubble or can not have
a parent listenable can simply not implement any ability to set the
parent listenable (and have #getParentEventTarget
return
null).
Implementation of this class can be used with or independently from goog.events.
Implementation must call #addImplementation(implClass)
.