DWR DWRUtil.js 内置方法小结

DWRUtil 小结2007-09-11 15:44$(); 
功能 : 相当于 document.getElementById(id); 
参数 : id 或 name 属性值 ; 
例 : 
<script> 
         Var ele=$(txt_test); 
         Var str=DWRUtil.toDescriptiveString(ele,1) 
         DWRUtil.debug(str); 
</script>

DWRUtil.getValue(); 
功能 : 获得指定元素 value 值 
参数 : id 或 name 属性值 ; 
注意 : 该函数只能用于有 value 属性的元素 
例 : 
<script> 
         var val=DWRUtil.getValue(“txt_test”); 
         DWRUtil.debug(val); 
</script>

DWRUtil.getValues(); 
功能 : 获得一组指定元素的 value 值 ; 
参数 :id 或 name 构成的数组对象 
例 : 
<script> 
         Var arr_=DWRUtil.getValues({“txt_name”:null,”txt_pswd”:null}); 
         Var str=DWRUtil.toDescriptiveString(arr,1) 
         DWRUtil.debug(str); 
</script>

DWRUtil.setValue(); 
功能 : 设置指定元素的 value 值 
参数 : id 或 name 属性值 
例 :
<script> 
         DWRUtil.setValue(“txt_test”,”wiley”); 
</script>

DWRUtil.setValues(); 
功能 : 设置一组指定元素的值 
参数 : id 或 name 构成的数组对象 
例 :
<script> 
         DWRUtil.setValues({“txt_name”:”wiley”,”txt_pswd”:”wiley”}); 
</script>

DWRUtil.getText(); 
功能 : 获得 select 元素的文本值 
参数 : id 或 name 属性值 
例 : 
<script> 
         Var txt=DWRUtil.getText (“sel_test”); 
         Var val=DWRUtil.getValue(“sel_test”); 
         DWRUtil.debug(“Text:”+txt+”/tValue:”+val); 
</script>

DWRUtil.addRows(); 
功能 : 指定表格添加行 
格式 :DWRUtil.addRows(id,items, functions); 
参数 : 
第一个参数 :table 或 tbody 的 id 属性值 
第二个参数 : 数组或链表 ( 可能用词不是很适合 ) 
第三个参数 : 函数链表 
例: 
<script> 
         Var arr_={“wiley’s blog”,”wiley 中国 ”}; 
         DWRUtil.addRows(“tby_test”,arr_,[function(arr_){return arr_}]); 
</script>

<script> 
         Var items=[{“name”:”wiley 中国 ”,”add”:”wiley-cn.com”}]; 
         DWRUtil.addRows(“tby_test”,items,[function(item){return item.name}, function(item){return item.add}]); 
</script>

DWRUtil.romoveAllRows(); 
功能 : 删除指定表格行 
参数 :table 或 tbody 的 id 属性值 
<script> 
         DWRUtil.romoveAllRows(“tby_test”);// 每次添加前将原有数据行删除 , 防止数据重叠 
         Var items=[{“name”:”wiley 中国 ”,”add”:”wiley-cn.com”}]; 
         DWRUtil.addRows(“tby_test”,items,[function(item){return item.name}, function(item){return item.add}]); 
</script>

DWRUtil.addOptions(); 
功能 : 添加 select 元素的 option 子元素 
格式 :DWRUtil.addOption(id,items) 或 DWRUtil.addOption(id,items,valueProp,textProp); 
参数 : 
第一个参数 :select 的 id 或 name 属性值 
第二个参数 : 数组或链表 ( 填充数据 ) 
第三、四个参数 : 链表节点的属性 , 第三个填充 value 值，第四个填充 text 值 
    <script> 
         Var arr_={“wiley”,”wiley 中国 ”}; 
         DWRUtil.addRows(“sel_test”,arr_);// 此时 value 与 text 值相同 
         DWRUtil.romoveAllOptions(“sel_test”); 
         Var items=[{“name”:”wiley 中国 ”,”add”:”wiley-cn.com”}]; 
         DWRUtil.addRows(“sel_test”,”add”,”name”);// 此时 value 与 text 不相同 
</script>

DWRUtil.romoveAllOptions(); 
功能 : 删除指定 select 元素的 option 子元素 
参数 :select 元素的 id 或 name 属性值 
例 : 前面例子有用到

DWRUtil.debug(); 
功能 : 等价于 alert() 
例 : 前面例子有用到

DWRUtil.toDescriptiveString(); 
功能：将对象序列化成字符串 , 主要用于调试 
带debug信息的toString，第一个为将要debug的对象，第二个参数为处理等级。等级如下：

     0: Single line of debug 单行调试  
     1: Multi-line debug that does not dig into child objects 不分析子元素的多行调试  
     2: Multi-line debug that digs into the 2nd layer of child objects 最多分析到第二层子元素的多行调试

     <input type="text" id="text">
     DWRUtil.toDescrīptiveString("text",0);

DWRUtil.useLoadingMessage();
    功能：当发出ajax请求后,页面显示的提示等待信息;
    例：
    function searchUser(){
        var loadinfo = "loading....."
        regUser.queryAllUser(userList);
        DWRUtil.useLoadingMessage(loadinfo);  
     }