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

The original website:/article/4172072.html

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以后调用