@SelectorParam
Syntax
@SelectorParam
@SelectorParam("#componentId")
@SelectorParam("tagName")
@SelectorParam(".className")
@SelectorParam(":root")
@SelectorParam("button[label='Submit']")
@SelectorParam("window > button")
For selector syntax, please refer to SelectorComposer
Description
Target: A method's parameter (for initial and command methods)
Purpose: To specify that a method's parameter should be retrieved from view component of the binder.
The value element is the selector for finding components. It uses Selectors to select the components. The base component of the selector is the view component of the binder, the component which uses ViewModel.
If the parameter type is a Collection, binder passes the result directly. Otherwise it passes the first result or null if there is no result.
Since 9.5.0
The value can be omitted if name is the same as the annotated parameter.
@SelectorParam String tagName
Example
<vbox apply="org.zkoss.bind.BindComposer" viewModel="@id('vm') @init('foo.SelectorParamVM')">
<hbox><label id="message"/></hbox>
<hbox><label /></hbox>
<hbox><label /></hbox>
<hbox><label /></hbox>
<button id="cmd" label="cmd" onClick="@command('cmd')"/>
</vbox>
Example to pass components by selector
public class SelectorParamVM {
@Command
public void cmd(@SelectorParam LinkedList<Label> label,
@SelectorParam("#message") Label msg) {
for (int i = 0; i < label.size(); i++) {
label.get(i).setValue("Command " + i);
}
msg.setValue("msg in command");
}
}