Wire Variables"

From Documentation
m
Line 42: Line 42:
  
 
=Wire Variables defined in zscript=
 
=Wire Variables defined in zscript=
 
=ID Space=
 
 
For components that are inside of another ID space, you could use <code>id1$id2$id3</code> to access it. More precisely, it will cause GenericForwardComposer to look for <code>id1</code> in the same ID space as the applied component, and then look for, if found and it is another ID space, <code>id2</code>, and so on. For example, you could find the textbox by <code>inner$input</code>.
 
 
<source lang="xml">
 
<window apply="foo.MyComposer">
 
  <window id="inner">
 
        <textbox id="input"/>
 
...
 
</source>
 
 
Here is another example: suppose have two ZUL files:
 
 
{|
 
!width="350px"|'''Main file'''
 
!width="350px"|'''Included file - includeme.zul'''
 
|-
 
|
 
<source lang="xml">
 
<window id="mywindow" apply="MyComposer">
 
    <include id="i" src="includeme.zul" />
 
</window>
 
</source>
 
|
 
<source lang="xml">
 
  <textbox id="username" />
 
</source>
 
|}
 
 
To access the textbox "username" from "MyComposer", you could specify:
 
 
<source lang="java">
 
public class MyComposer extends GenericAutowireComposer {
 
    Textbox i$username;
 
    ...
 
}
 
</source>
 
  
 
=Version History=
 
=Version History=

Revision as of 08:56, 7 December 2011

Wiring Sequence

GenericForwardComposer will wire members defined in the composer. Here is the sequence:

  1. It searches any setters if its name matches any of the following
    1. Any fellow with the same name (Component.getFellow(String))
    2. Any variable defined in Page.addVariableResolver(VariableResolver) with the same name
    3. Any variable defined in zscript with the same name
    4. Any implicit object with the same name
  2. Then, it searches any field to see if it matches any fellow, any variable,... the same as the above.

Wire Components

CSS3 Selectors

Wire Variables defined Variable Resolver

Wire Spring-managed Beans

Because the variable resolver will be checked when wiring a variable, you could wire a managed bean by declaring a built-in variable resolved called DelegatingVariableResolver.

<?variable-resolver class="org.zkoss.zkplus.spring.DelegatingVariableResolver"?>
<window apply="foo.MyComposer">
...
    <textbox id="password"/>
...
    <button id="submit" label="Change"/>
</window>

Then, if a data member's name matches a Spring-managed bean, it will be wired automatically too. For example,

public class PasswordSetter extends GenericFowardComposer {
    private User user; //wired automatically if user is a spring-managed bean
    private Textbox password; //wired automatically if there is a textbox named password

    public void onClick@submit() {
        user.setPassword(password.getValue());
    }
}

Wire Variables defined in zscript

Version History

Last Update : 2011/12/07


Version Date Content
     



Last Update : 2011/12/07

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