样例:
<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
最后更新 2011-09-24
2011-9-24 0:51:30 org.zkoss.zk.ui.AbstractComponent updateByClient:2553
警告: Ignore update of value=sun4love from client for class org.zkoss.zul.Textbox
你可能使用zk最新版本5.0.7或更新,最新版默认禁止smartUpdate方法,zk认为该操作存在一定的危险性,服务器端可以配置启用
这里有你的答案,页面尾部
http://books.zkoss.org/wiki/Small%20Talks/2011/May/New%20Features%20of%20ZK%205.0.7