util.js包含一些有用的函数function,用于在客户端页面调用,它可以和dwr分开,独立营用于你的系统中。
这些功能函数在下面这个网址都有示例,这里只是把他们用中文解释,方便查找.
http://getahead.ltd.uk/dwr/browser/util
主要功能如下:
1、$() 获得页面参数值
2、addOptions and removeAllOptions 初始化下拉框
3、addRows and removeAllRows 填充表格
4、getText 取得text属性值
5、getValue 取得form表单值
6、getValues 取得form多个值
7、onReturn
8、selectRange
9、setValue
10、setValues
11、toDescriptiveString
12、useLoadingMessage
13、Submission box
1。$();
功能 : 相当于 document.getElementById(id);
参数 : id 或 name 属性值 ;
例 :
<script>
Var ele=$(txt_test);
Var str=DWRUtil.toDescriptiveString(ele,1)
DWRUtil.debug(str);
</script>
2。DWRUtil.getValue();
功能 : 获得指定元素 value 值
参数 : id 或 name 属性值 ;
注意 : 该函数只能用于有 value 属性的元素
例 :
<script>
var val=DWRUtil.getValue(“txt_test”);
DWRUtil.debug(val);
</script>
3。 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>
4。DWRUtil.setValue();
功能 : 设置指定元素的 value 值
参数 : id 或 name 属性值
例 :
<script>
DWRUtil.setValue(“txt_test”,”wiley”);
</script>
5。 DWRUtil.setValues();
功能 : 设置一组指定元素的值
参数 : id 或 name 构成的数组对象
例 :
<script>
DWRUtil.setValues({“txt_name”:”wiley”,”txt_pswd”:”wiley”});
</script>
6。 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>
7。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>
8。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>
9。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>
10。DWRUtil.romoveAllOptions();
功能 : 删除指定 select 元素的 option 子元素
参数 :select 元素的 id 或 name 属性值
例 : 前面例子有用到
11。DWRUtil.debug();
功能 : 等价于 alert()
例 : 前面例子有用到
12。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);
13。DWRUtil.useLoadingMessage();
功能:当发出ajax请求后,页面显示的提示等待信息;
例:
function searchUser(){
var loadinfo = "loading....."
regUser.queryAllUser(userList);
DWRUtil.useLoadingMessage(loadinfo);
}