@validator"

From Documentation
(Created page with "{{ZKDevelopersReferencePageHeader}} =Syntax= <tt> @validator(</tt> ''[EL-expression], [arbitraryKey]=[EL-expression] '' <tt>) </tt> = Description = '''Target Attribute:''' an...")
 
m ((via JWB))
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
{{ZKDevelopersReferencePageHeader}}
 
{{ZKDevelopersReferencePageHeader}}
 +
{{Deprecated | url=[http://books.zkoss.org/zk-mvvm-book/8.0/syntax/validator.html zk-mvvm-book/8.0/syntax/data_binding/validator]|}}
  
  
 
=Syntax=
 
=Syntax=
  
<tt> @validator(</tt> ''[EL-expression], [arbitraryKey]=[EL-expression] '' <tt>) </tt>
+
<code>@validator(</code> ''[EL-expression], [arbitraryKey]=[EL-expression] '' <code>)</code>
  
 
= Description =
 
= Description =
 
'''Target Attribute:''' any (except viewModel, validationMessages, form, and event attributes)
 
'''Target Attribute:''' any (except viewModel, validationMessages, form, and event attributes)
  
'''Purpose:''' It should be used with <tt> @bind </tt>, <tt> @load </tt>, <tt> @save </tt>. It applies a validator to validate data when saving to ViewModel.
+
'''Purpose:''' It should be used with <code>@bind</code>, <code>@load</code>, <code>@save</code>. It applies a validator to validate data when saving to ViewModel.
  
 
The evaluation result of EL expression should be a <javadoc> org.zkoss.bind.Validator </javadoc> object. You can append arbitrary arguments in key-value pair with comma separated to pass it to the Validator object. Built-in Validator is referenced by a string literal as its name.
 
The evaluation result of EL expression should be a <javadoc> org.zkoss.bind.Validator </javadoc> object. You can append arbitrary arguments in key-value pair with comma separated to pass it to the Validator object. Built-in Validator is referenced by a string literal as its name.
Line 26: Line 27:
 
'''Use built-in validator named beanValidator'''
 
'''Use built-in validator named beanValidator'''
 
<source lang="xml" >
 
<source lang="xml" >
<window id="win" apply="org.zkoss.bind.BindComposer" viewModel="@id('vm') @init(foo.MyViewModel)" ">
+
<window id="win" apply="org.zkoss.bind.BindComposer" viewModel="@id('vm') @init(foo.MyViewModel)">
 
     <textbox value="@bind(vm.user.lastName) @validator('beanValidator')" />
 
     <textbox value="@bind(vm.user.lastName) @validator('beanValidator')" />
 
</window>
 
</window>
Line 36: Line 37:
 
<datebox id="cdbox" value="@bind(fx.creationDate) @validator(vm.creationDateValidator)"/>
 
<datebox id="cdbox" value="@bind(fx.creationDate) @validator(vm.creationDateValidator)"/>
 
</source>
 
</source>
 +
 +
=Version History=
 +
 +
{| class='wikitable' | width="100%"
 +
! Version !! Date !! Content
 +
|-
 +
| 6.0.0
 +
| February 2012
 +
| The MVVM was introduced.
 +
|}
  
  
  
 
{{ZKDevelopersReferencePageFooter}}
 
{{ZKDevelopersReferencePageFooter}}

Latest revision as of 07:35, 8 July 2022

Stop.png This article is out of date, please refer to zk-mvvm-book/8.0/syntax/data_binding/validator for more up to date information.


Syntax

@validator( [EL-expression], [arbitraryKey]=[EL-expression] )

Description

Target Attribute: any (except viewModel, validationMessages, form, and event attributes)

Purpose: It should be used with @bind, @load, @save. It applies a validator to validate data when saving to ViewModel.

The evaluation result of EL expression should be a Validator object. You can append arbitrary arguments in key-value pair with comma separated to pass it to the Validator object. Built-in Validator is referenced by a string literal as its name.


[arbitraryKey]=[EL-expression]
It's key-value pairs basically. You can write multiple key-value pairs with different key names.
An EL expression without key is set to a default key named "value" implicitly.
Due to each annotation has different functions, some annotations may ignore key-value pair expression other than default key, e.g.@id.
[arbitraryKey]
It could be any name, it's used as a key for parameter related Java annotation in a ViewModel.

Example

Use built-in validator named beanValidator

<window id="win" apply="org.zkoss.bind.BindComposer" viewModel="@id('vm') @init(foo.MyViewModel)">
    <textbox value="@bind(vm.user.lastName) @validator('beanValidator')" />
</window>

Use custom validator

<datebox id="cdbox" value="@bind(fx.creationDate) @validator(vm.creationDateValidator)"/>

Version History

Version Date Content
6.0.0 February 2012 The MVVM was introduced.




Last Update : 2022/07/08

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