dwr2.0 中 util.js脚本提供的实用方法调用说明

The original website:http://longdick.iteye.com/blog/429839

 

1、addRows 增添数据行到指定的table
方法基本语法：dwr.util.addRows(id, array, cellfuncs, [options]);
* id:table 的 id (最好是一个tbody的id)
* array: 需要被填充到table里的数据对象，可以是数组，集合等对象，每一个数组元素对应table的一行
* cellfuncs: function数组 每个元素对应table某一列数据的取得方式
* options: 包含几个属性的对象（可选）

options：
# 属性rowCreator: 一个function,默认返回document.createElement("tr")，可以编辑返回自定义的tr（比如不同的样式）
# 属性cellCreator: 一个function，默认返回document.createElement("td")，可以编辑返回自定义的tr（比如不同的样式）
# 属性escapeHtml: 是否转义<,>,&,",'

当所有call back function 都需要转义，则可以使用dwr.util.setEscapeHtml(false)

2、removeAllRows 把指定table的所有行都移除
方法基本语法：dwr.util.removeAllRows(id)；
* id:table 的 id (最好是一个tbody的id)


3、byId
　你可以把它看成是document.getElementById()的替代版，如果指定的id有多个匹配项，就会返回一个element数组
方法基本语法：dwr.util.byId(id)
另：在引入util.js的环境下，你还可以使用$(id)代替document.getElementById()，但是为了不和Prototype相冲突，还是建议各位使用 byId。

4、getValue 取得html 页面元素的value
方法基本语法：dwr.util.getValue(id)；

5、getText
用法和getValue方法相同，唯一的不同在于getText是用来取得下拉框列表的Text值，而非Value

6、getValues
方法基本语法：dwr.util.getValues(object) ；
参数是一个拥有多个属性的javascript object，属性名称是html页面元素的id，属性value为html页面元素的value，该方法不返回任何东西，而是改变了object的属性值。


7、setValue 设置html 页面元素的value
方法基本语法：dwr.util.setValue(id, value [, options]) ；
如果id参数指定的页面元素是select列表，该列表与value参数值相匹配的option选项会处于选中状态。

8、setValues
方法基本语法：dwr.util.setValues(object) ；
参数是一个拥有多个属性的javascript object，属性名称是html页面元素的id，属性value为html页面元素的value

9、addOptions
方法基本语法：dwr.util.addOptions(...); 有多种调用方式：
# dwr.util.addOptions(id,["first","second","third"]) id参数指定的页面元素可以是ol、ul或select，String数组将被set到id指定的页面元素
# dwr.util.addOptions(id,[{name:"first"，value:"1"},{name:"second"，value:"2"},{name:"third"，value:"3"}],"value","name")
这种方式只对应select的情形，如上所述，Object数组里每个元素的value属性值将被set到option的value里，name属性将被set到option的text里。
如果没有第四个参数，将会把value属性值同时set到option的value和text里。
# dwr.util.addOptions(id，{first:"1",second:"1",third:"3"})
这种方式也只对应select的情形，第二个参数是一个Object，属性名set到option的value里，属性值set到option的text里

10、removeAllOptions
方法基本语法：dwr.util.removeAllOptions(id)；
除去所有动态加载的Options或列表项，与addOptions配合使用


11、onReturn
方法基本语法：dwr.util.onReturn(event, func）
当输入回车时，调用func名指定的方法

12、useLoadingMessage
方法基本语法：dwr.util.useLoadingMessage();
显示一个正在加载的图片。必须在页面loaded以后调用