From Documentation

(Difference between revisions)
Jump to: navigation, search
(Values of Stubonly: true, false and inherit)
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 in the following example.
+
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





Contents


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



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