|
|
| Line 2: |
Line 2: |
| | | | |
| | __TOC__ | | __TOC__ |
| − | There are two kinds of events at the client side: widget events (<javadoc directory="jsdoc">zk.Event</javadoc>) and DOM events (<javadoc directory="jsdoc">jq.Event</javadoc>). A widget event is triggered by a widget or an application, while a DOM event is triggered by the browser.
| |
| | | | |
| − | = Widget Events =
| + | A DOM event (<javadoc directory="jsdoc">jq.Event</javadoc>) is the DOM-level event that is usually triggered by the browser. It is usually listened by the implementation of a widget, rather than the client application. |
| − | A widget event is the widget-level event. Like <javadoc>org.zkoss.zk.event.Event</javadoc> at the server side, the widget event is usually triggered to a widget (and an application) to notify a widget-level event, such as a window has been moved. | |
| − | | |
| − | A widget event will be ''propagated'' to the parent widget, parent's parent and so on, until stopped (<javadoc method="stop(_global_.Map)" directory="jsdoc">zk.Event</javadoc>). Then, if the event is required by the server, it will be sent to the server, and converted to an instance of <javadoc type="interface">org.zkoss.zk.au.AuRequest</javadoc> at the server<ref>For more information, please refer to the [[ZK Client-side Reference/Communication/AU Requests|AU Requests]] section.</ref>.
| |
| − | | |
| − | To fire a widget event, you could invoke <javadoc method="fire(_global_.String, zk.Object, _global_.Map, int)" directory="jsdoc">zk.Widget</javadoc> or <javadoc method="fireX(zk.Event, int)" directory="jsdoc">zk.Widget</javadoc>.
| |
| − | | |
| − | To listen a widget event, you could invoke <javadoc method="listen(_global_.Map, int)" directory="jsdoc">zk.Widget</javadoc>.
| |
| − | | |
| − | = DOM Events =
| |
| − | A DOM event (Event) is the DOM-level event that is usually triggered by the browser. It is usually listened by the implementation of a widget, rather than the client application.
| |
| | | | |
| | == How to Listen and Unlisten == | | == How to Listen and Unlisten == |