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);
}