样例:
<window xmlns:w="client" apply="demoComposer"> <button label="仅修改客户端" w:onClick="zk.Widget.$(jq('$txtUsername')).setValue('sun4love');zk.log('setValue方法修改完毕');"/> <button label="修改值并通知服务器端" w:onClick="zk.Widget.$(jq('$txtUsername')).smartUpdate('value','sun4love');zk.log('smartUpdate方法修改完毕');"/> <button label="服务器端获值" forward="onGetUsername"/> <textbox id="txtUsername" value="hello!"/> </window>
private Textbox txtUsername public void onGetUsername(){ System.out.println( txtUsername.getValue()); }
通常情况下我们这样修改txtUsername的值zk.Widget.$(jq("$txtUsername")).setValue("sun4love");
但当我们点击 服务器端获值 按钮的时候,非常遗憾,获得值仍然是hello!,而不是sun4love
这是因为setValue方法并没有告诉服务器端txtUsername的值有所改变,服务器端仅记得上次的值而已,
所以我们必须通知服务器端值的改变才可以,在今天之前我是通过zAu.send(new zk.Event(txtUsername,"onBlur"));实现的,非常麻烦,今天群内朋友PM 问了相关问题,我又看看看jsdoc(zk-jsdocXXX.zip)发现widget的smartUpdate方法,
smartUpdate的说明:Smart-updates a property of the peer component associated with this widget, running at the server, with the specified value.
意思是说Smart-updates 是每个组件相关widget的一个属性,运行于服务器端,
方法签名:smartUpdate(String name, Object value, int timeout)
name是组件标签的属性名,本例是value,Object value是sun4love
注意:从zk5.0.7开始,zk默认禁止smartUpdate,如果启用这里有两个方法
1,启用单一组件实例的smartUpdate功能
<window> <custom-attribute org.zkoss.zk.ui.updateByClient="true"/> ... </window>
2,启用某一组件所有实例的smartUpdate 启用配置见这里
<component> <component-name>button</component-name> <extends>button</extends> <custom-attribute> <attribute-name>org.zkoss.zk.ui.updateByClient</attribute-name> <attribute-value>true</attribute-value> </custom-attribute> </component>
Great thanks,PM and zhongji