Specify Stubonly for Client-only Components"
Line 15: | Line 15: | ||
== Values of Stubonly: true, false and inherit == | == Values of Stubonly: true, false and inherit == | ||
− | The default value of the <tt>stubonly</tt> property is <tt>inherit</tt> that is the same as its parent, if any, or <tt>false</tt>, if no parent at all. Thus, if a component's <tt>stubonly</tt> is specified with <tt>true</tt>, all its descendants are stub-only too. For example, only <tt>textbox</tt> is not stub-only | + | The default value of the <tt>stubonly</tt> property is <tt>inherit</tt> that is the same as its parent, if any, or <tt>false</tt>, if no parent at all. Thus, if a component's <tt>stubonly</tt> is specified with <tt>true</tt>, all its descendants are stub-only too, unless <tt>false</tt> is specified explicitly. For example, in the following example, only <tt>textbox</tt> is not stub-only, while <tt>hbox</tt>, <tt>splitter</tt>, <tt>listbox</tt>, |
+ | <tt>listitem</tt> and labels are all stub-only. | ||
<source lang="xml"> | <source lang="xml"> |
Revision as of 10:42, 9 August 2010
This documentation is for an older version of ZK. For the latest one, please click here.
Overview
[since 5.0.4][ZK EE]
It is common that the states of some components are not required to maintain at the server. A typical example is that an application might use some components, such as hbox, for layout and won't access it again after rendered. To minimize the memory footprint, ZK supports a special property called stubonly (Component.setStubonly(String)). Once specified with true, its states won't be maintained at the server (and all states are maintained at the client). For example,
<hbox stubonly="true">
</hbox>
Values of Stubonly: true, false and inherit
The default value of the stubonly property is inherit that is the same as its parent, if any, or false, if no parent at all. Thus, if a component's stubonly is specified with true, all its descendants are stub-only too, unless false is specified explicitly. For example, in the following example, only textbox is not stub-only, while hbox, splitter, listbox, listitem and labels are all stub-only.
<hbox stubonly="true">
a stub-only label
<textbox stubonly="false"/>
<splitter/>
<listbox>
<listitem label="also stubonly"/>
</listbox>
</hbox>
Limitation
Invalidation and Smart Updates
Event Handling
Client-side Programming