EL Expression"

From Documentation
Line 77: Line 77:
 
<textbox value="@bind(vm.myname)"/>
 
<textbox value="@bind(vm.myname)"/>
 
</source>
 
</source>
However, if the expression only contains first-term<ref>first-term is a variable that comes from a variable resolver, and you couldn't save value back by EL directly</ref>, the 'load from' will still work, but the 'save to' is not allowed to perform. In following example, the value '''myname''' is loaded to textbox, but after edited the value, you will get a EL expection when saving value back.
+
However, if the expression only contains first-term<ref>first-term is a variable that comes from a variable resolver, and you couldn't save value back by EL directly</ref>, the 'load from' will still work, but the 'save to' is not allowed to perform. In following example, the value '''myname''' is loaded to textbox, but after edited the value, you will get an EL exception when saving value back.
 
<source lang="xml">
 
<source lang="xml">
 
<textbox value="@bind(myname)"/>
 
<textbox value="@bind(myname)"/>

Revision as of 00:39, 3 March 2012


EL Expression in Data Binding

In ZK bind annotation, we adopt EL expression to specify a binding target and reference an implicit object. The binding target is mostly a ViewModel's (nested) properties. You can use EL expression in a ZUL which is described in the section ZK Developer's Reference/UI Composing/ZUML/EL Expressions. But using EL in ZK bind annotation is a little bit different in format and evaluation.

Basic Format

All ZK bind annotation has the general format:

@[Annotation]( value=[EL-expression], [arbitraryKey]=[EL-expression] )


It starts from a "@" symbol followed by an annotation's name like "id" or "bind". Inside parentheses we can write multiple key-value pairs separated with a comma. The key is a self-defined name (not an EL expression), and it's like a key in a Map. The value is an EL expression but is not enclosed with "${" and "}". The default key name is "value". If you only write a EL expression without specifying its key name, it's implicit set to key named "value". Hence we usually omit this default key name when writing ZK bind annotation. In most case, we can just write a annotation as follows:

@[Annotation]( [EL-expression])

We just need to write one key-value pair and omit default key name. We often use multiple key-value pairs for passing parameters to command, converter, and validator.

Although all ZK bind annotation has the general format, the way how a binder parse and evaluates the EL expression is different among different annotations. We'll describe the differences in the following sections.

Run-time Evaluation

A binder usually evaluates an EL expression each time when it wants to access the target object. Hence The evaluation result might be different from time to time.

Command binding according to run-time value

<button label="Cmd" onClick="@command(vm.checked?'command1':'command2')" />

<groupbox visible="@load(not empty vm.selected)" />
  • When clicking the button, the binder executes a command upon value of "vm.checked".


Indirect reference

<label value="@bind(vm.person[vm.currentField])"/>
  • If evaluation result of vm.currentField is firstName, the binder loads vm.person.firstName. So which property of vm.person that a binder loads depends on vm.currentField's evaluation result.


Call Methods

You can use EL expression to call a method in a ViewModel.

Call concat() of a ViewModel

<label value="@load(vm.concat(vm.foo,'postfix'))"/>

Tips

As ZK bind annotation is mainly composed of key-value pairs (key=value), "=" (equal mark) is not allowed to be used in EL expression. You should replace it with "eq" and "!=" with "ne". But you still can use ">" and "<". For example:

<image src="@load(vm.picture ne null ? 'images/'.concat(vm.picture) : 'images/NoImage.png')"/>

<label value="@bind(vm.age>18?'true':'false')"/>

Limitation

Can't save to variable

An expression could represent a 'load from' and also a 'save to' (More detail about load/save-binding at ZK Developer's Reference/MVVM/Data_Binding/Property_Binding). In following example, the value of vm.myname is loaded to textbox and after edited the textbox, the value of textbox is saved to vm.myname.

<textbox value="@bind(vm.myname)"/>

However, if the expression only contains first-term[1], the 'load from' will still work, but the 'save to' is not allowed to perform. In following example, the value myname is loaded to textbox, but after edited the value, you will get an EL exception when saving value back.

<textbox value="@bind(myname)"/>

  1. first-term is a variable that comes from a variable resolver, and you couldn't save value back by EL directly

Version History

Last Update : 2012/03/03


Version Date Content
6.0.0 February 2012 The MVVM was introduced.


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