ZK Developer's Reference/MVVM/Data Binding/Reference Binding

This page is under construction, so we cannot guarantee the accuracy of the content!

Since 6.0.1

Make an expression reference

Reference binding allows us to make a reference for a EL expression with a custom name. The reference could be referred in another EL expression (Have to nested in the component has this reference binding). Typically we use reference binding to make expression shorter or modularize the view.

Steps to use this feature:

1. Bind a custom attribute on a component with @ref .
2. Use the custom attribute in other EL expression that nested in children component

---

Basic usage example

<window apply="org.zkoss.bind.BindComposer" 
	viewModel="@id('vm') @init('foo.MyVM')">
	<vlayout p="@ref(vm.person)">
		<hlayout>
			First Name: <textbox value="@bind(p.firstName)" />
		</hlayout>
		<hlayout>
			Last Name: <textbox value="@bind(p.lastName)" />
		</hlayout>
	</vlayout>
</window>

In above example, we add a reference to vm.person with name p to the vlayout. So, inside the vlayout, the p could be used by other EL expression.

Moudlarize view example

<window apply="org.zkoss.bind.BindComposer" 
	viewModel="@id('vm') @init('foo.MyVM')">
	<include p="@ref(vm.person1)" src="person.zul"/>
	<include p="@ref(vm.person2)" src="person.zul"/>
</window>

Moudlarize view example - person.zul

<vlayout>
	<hlayout>
		First Name: <textbox value="@bind(p.firstName)"/>
	</hlayout>
	<hlayout>
		Last Name: <textbox value="@bind(p.lastName)"/>
	</hlayout>
</vlayout>

In above example, we have a veiw - person.zul which binds components to p.firstName and p.lastName. This view could be reused by other view that provides a reference p.

Version History

Version	Date	Content
6.0.1	May 2012	The new reference-binding feature.