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

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

评论

1 楼 longdick 2009-08-08  

转载请注明出处，OK？