Client-side Firing

In general, an AU request is caused by a widget event (Event) that is going to be sent to the server. It happens when a widget event is targeting a widget that is created at the server, or with the toServer option (specified in Event.opts). In additions, you could invoke Au.fire() explicitly to fire an AU request to the server.

Fire Event to Widget

An event can be fired to a widget by use of Widget.fire(String, Object, Map, int) and Widget.fireX(Event, int). For example,

onCloseClick: function () {
 this.fire('onClose');
}

The event will be propagated to the widget's parent, parent's parent and so on. zk.Widget#fire fires a client event (an instance of zk.Event), and the client event is converted to an AU request if all the following conditions are satisfied.

• The widget is a peer of a component, that is, it was created automatically to represent a component. Notice that inServer indicates if a widget is a peer of a component.
• The event propagation is not stopped (i.e., zk.Widget#stop not set.
• The event is listened by a server-side listener (org.zkoss.zk.ui.Listener), or it is an important event.

Version History

Version	Date	Content