The Fluid framework defines an event system which is used by many of its components. For an overview, see Infusion Event System. This page provides specific information for anyone implementing Fluid components in their user interface.
Fluid components fire events at interesting moments in their life cycle. Implementers can take advantage of this by attaching listeners to these events if they so desire. For example, the Uploader component fires an
afterUploadComplete event once a file upload has completed. Implementors could choose to attach a listener to this event that displays a "Complete" message to the users.
Each Fluid component defines its own events. Implementers must consult either the documentation for the component, or the source code, to determine what events a particular component will fire.
- In the documentation, the events are described in the "Supported Events" section of the API page for the component in question.
- In the source code, the default values for the supported events are defined in the
eventsobject passed to
Implementers can register listeners for events using the component creator function
options parameter. A
listeners object should be included in the
options object defining the listener function(s) for the desired event, for example:
Listeners may also be added and removed dynamically at any point in the component's lifecycle after it has been constructed, by accessing the event firers which are created under the top-level
that, under the name
events. For example, to achieve the same effect as the first member of the options block above, one could instead write
Note that it is usually easier and more reliable for component users to register listeners in the options block as shown above. More advanced information on the event system, mostly suitable for component developers, can be found at Events for Component Developers.
Note that the arguments supported by each event are defined by the component itself. Implementors must consult the documentation for the component.
By default, most Fluid component events are multi-cast (that is, the event is fired to all registered listeners), but some events may be one of the following two special types:
The event will fire to only one listener.
The event represents a "preventable" action.
The individual component API pages document which events are of these types.