From Documentation

Jump to: navigation, search


Not to Use zscript for Better Performance

It is convenient to use zscript in ZUML, but it comes with a price: slower performance. The degradation varies from one application from another. It is suggested to use zsript only for fast prototyping, POC, or small projects. For large website, it is suggested to use ZK MVC/ZK MVVM instead. For example, with ZK MVC

 <window apply="foo.MyComposer">

You can handle all events and components in foo.MyComposer. By the use of auto-wiring, it is straightforward to handle events and components.

Event Handler Is zscript

In addition to the zscript element, the event handler declared in a ZUL page is also interpreted at the runtime. For example,

  <button label="OK" onClick="doSomething()"/>

where doSomething() is interpreted as zscript. Thus, for better performance, they should be replaced too.

Turn off the use of zscript

[since 5.0.8]

If you decide not to use zscript at all, you could turn on the disable-script configuration as follows, such that an exception will be thrown if zscript is used.


Use the deferred Attribute

If you still need to write zscript codes, you can specify the deferred attribute to defer the evaluation of zscript codes as follows.

<zscript deferred="true">

By specifying the deferred attribute, the zscript codes it contains will not be evaluated when ZK renders a page. It means that the interpreter won't be loaded when ZK renders a page. This saves memory and speeds up page rendering.

In the following example, the interpreter is loaded only when the button is clicked:

<window id="w">
    <zscript deferred="true">
     void addMore() {
         new Label("More").setParent(w);
    <button label="Add" onClick="addMore()"/>

The deferred Attribute and the onCreate Event

It is worth to notice that, if the onCreate event listener is written in zscript, the deferred option mentioned in the previous section becomes useless. It is because the onCreate event is sent when the page is loaded. In other words, all deferred zscript will be evaluated when the page is loaded if the onCreate event listener is written in zscript as shown below.

<window onCreate="init()">

Rather, it is better to rewrite it as

<window use="my.MyWindow">

Then, prepare as shown below.

 package my;
 public class MyWindow extends Window {
     public void onCreate() { //to process the onCreate event

If you prefer to do the initialization right after the component (and all its children) is created, you can implement the AfterCompose interface as shown below. Note: the afterCompose method of the AfterCompose interface is evaluated at the Component Creation phase, while the onCreate event is evaluated in the Event Processing Phase.

 package my;
 public class MyWindow extends Window implements org.zkoss.zk.ui.ext.AfterCompose {
     public void afterCompose() { //to initialize the window

Use the forward Attribute

To simplify the event flow, ZK components usually send the events to the component itself, rather than the parent or other targets. For example, when an user clicks a button, the onClick event is sent to the button. However, developers may need to forward the event to the window component by the use of the onClick event listener as follows.

<window id="w" onOK='alert("on OK")'>
    <button label="OK" onClick='Events.postEvent("onOK", w, null)'/>

As suggested in the previous sections, the performance can be improved by not using zscript at all. Thus, you can rewrite the above code snippet either with EventListener or by specifying the forward attribute as follows.

<window apply="foo.MyComposer">
    <button label="OK" forward="onOK"/>

Version History

Last Update : 2015/9/3

Version Date Content

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.