...
Instance parameters support the following pre-defined variables: ${username}, ${viewName} and ${instanceName}
Events
Events are an important component of the views framework. Events allow the view to interact with the framework on lifecycle changes (i.e. "framework eventsFramework Events") . such as deploy, create and destroy. As well, once a user has collection of views available, eventing allows the views to communicate with other views (i.e. "view eventsView Events").
Framework Events
To register to receive framework events, in the view.xml
, specify a <view-class>this.is.my.view-clazz</view-class>
which is a class that implements the View interface.
Event | Description |
---|---|
onDeploy() | Called when a view is deployed. |
onCreate() | Called when a view instance is created. |
onDestroy() | Called when a view instance is destroy. |
To register to receive framework events, in the view.xml
, specify a <view-class>this.is.my.view-clazz</view-class>
which is a class that implements the View interface.
View Events
Views Events
Views can pass events between views. Obtain From the view context, you can obtain the ViewController object that allows you to register listeners for view events and to fire events for other listeners.
...
.
...
Registering View Event Listeners
A view can register an event Listener (via the ViewController) for other views by view name, or by view name + version. When an Event is fired from the source view, all registered listeners will receive the event.
Info |
---|
Typically, a view implementation will register event listeners during the |
Firing and Receiving View Events
- Obtain the view controller and register a listener.
viewContext.getViewController().registerListener(...);
- Fire the event.
viewContext.getViewController().fireEvent(...);
- The framework will notify all registered listeners. The listener implementation can process the event as appropriate.
listener.notify(...)