DWR util.js 學習筆記
util.js包含一些有用的函數function,用於在客戶端頁面調用，它可以和dwr分開，獨立營用於你的系統中。
主要功能如下：
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、$()函數
IE5.0 不支持
$ = document.getElementById
取得form表單值
var name = $("name");
***************************************************************************************
2、用於填充 select 下拉框 option
a、如果你想在更新select 時，想保存原來的數據，即在原來的select中添加新的option：
var sel = DWRUtil.getValue(id);
DWRUtil.removeAllOptions(id);
DWRUtil.addOptions(id,...);
DWRUtil.setValue(id,sel);
demo:比如你想添加一個option：“--請選擇--”
DWRUtil.addOptions(id,["--請選擇--"]);
DWRUtil.addOptions()有5中方式：
@ Simple Array Example: 簡單數組
例如:
Array array = new Array[ 'Africa', 'America', 'Asia', 'Australasia', 'Europe' ]；
DWRUtil.addOptions("demo1",array);
@ Simple Object Array Example 簡單數組,元素爲beans
這種情況下,你需要指定要顯示 beans 的 property 以及 對應的 bean 值
例如:
public class Person {
private String name;
private Integer id;
pirvate String address;
public void set(){……}
public String get(){……}
}
DWRUtil.addOptions("demo2",array,'id','name');
其中id指向及bean的id屬性，在optiong中對應value，name指向bean的name屬性，對應下拉框中顯示的哪個值.
@ Advanced Object Array Example 基本同上
DWRUtil.addOptions( "demo3",
[{ name:'Africa', id:'AF' },
{ name:'America', id:'AM' },
{ name:'Asia', id:'AS' },
{ name:'Australasia', id:'AU' },
{ name:'Europe', id:'EU' }
],'id','name');
@ Map Example 用制定的map來填充 options:
如果 server 返回 Map,呢麼這樣處理即可：
DWRUtil.addOptions( "demo3",map);
其中 value 對應 map keys，text 對應 map values；
@ <ul> and <ol> list editing
DWRUtil.addOptions() 函數不但可以填出select,開可以填出<ul>和<ol>這樣的heml元素
***************************************************************************************
3、addRows and removeAllRows 填充表格
DWR 提供2個函數來操作 table；
----------------------------
DWRUtil.addRows(); 添加行
----------------------------
DWRUtil.removeAllRows(id); 刪除指定id的table
----------------------------
下面着重看一下 addRows() 函數：
DWRUtil.addRows(id, array, cellfuncs, [options]);
其中id 對應 table 的 id(更適合tbodye，推薦使用 tbodye)
array 是server端服務器的返回值，比如list，map等等
cellfuncs 及用返回值來天春表格
[options] 用來設置表格樣式，它有2個內部函數來設置單元格樣式(rowCreator、cellCreator)。
比如: server端返回list，而list中存放的是下面這個 bean：
public class Person {
private String name;
private Integer id;
pirvate String address;
public void set(){……}
public String get(){……}
}
下面用 DWRUtil.addRows();
/**************************************************************************************/
function userList(data){
//var delButton = "<input type='button'/>";
//var editButton = "<input type='button'/>";
var cellfuncs = [
function(data){return data.id;},
function(data){return data.userName;},
function(data){return data.userTrueName;},
function(data){return data.birthday;},
function(data){
var idd = data.id;
var delButton = document.createElement("<INPUT TYPE='button' οnclick='delPerson("+ idd +")'>");
delButton.setAttribute("id","delete");
delButton.setAttribute("value","delete");
return delButton;
},
function(data){
var idd = data.id;
var editButton = document.createElement("<INPUT TYPE='button' οnclick='editPerson("+ idd +")'>");
editButton.setAttribute("name","edit");
editButton.setAttribute("value","edit");
return editButton;
}
];
DWRUtil.removeAllRows('tabId');
DWRUtil.addRows('tabId', data,cellfuncs,{
rowCreator:function(options) {
var row = document.createElement("tr");
var index = options.rowIndex * 50;
row.setAttribute("id",options.rowData.id);
row.style.collapse = "separate";
row.style.color = "rgb(" + index + ",0,0)";
return row;
},
cellCreator:function(options) {
var td = document.createElement("td");
var index = 255 - (options.rowIndex * 50);
//td.style.backgroundColor = "rgb(" + index + ",255,255)";
td.style.backgroundColor = "menu";
td.style.fontWeight = "bold";
td.style.align = "center";
return td;
}
});
document.getElementById("bt").style.display = "none";
}
待續…………………………………………
/**************************************************************************************/
/**************************************************************************************/
/**************************************************************************************/
4、getText 取得text屬性值
DWRUtil.getText(id): 用來獲得 option 中的文本
比如：
<select id="select">
<option value="1"> 蘋果 </option>
<option value="2" select> 香蕉 </option>
<option value="3"> 鴨梨 </option>
</select>
調用 DWRUtil.getText("select"); 將返回 "香蕉" 字段；
DWRUtil.getText(id)；僅僅是用來獲得 select 文本值，其他不適用。
/**************************************************************************************/
5、DWRUtil.getValue(id): 用來獲得 form 表單值
有如下幾種情況：
Text area (id="textarea"): DWRUtil.getValue("textarea")將返回 Text area的值;
Selection list (id="select"): DWRUtil.getValue("select") 將返回 Selection list 的值;
Text input (id="text"): DWRUtil.getValue("text") 將返回 Text input 的值;
Password input (id="password"): DWRUtil.getValue("text") 將返回 Password input 的值;
Form button (id="formbutton"): DWRUtil.getValue("formbutton") 將返回 Form button 的值;
Fancy button (id="button"): DWRUtil.getValue("formbutton") 將返回 Fancy button 的值;
/**************************************************************************************/
6、getValues 取得form多個值
批量獲得頁面表單的值,組合成數組的形式,返回 name/value;
例如: form():
<input type="textarea" id="textarea" value="1111"/>
<input type="text" id="text" value="2222"/>
<input type="password" id= "password" value="3333"/>
<select id="select">
<option value="1"> 蘋果 </option>
<option value="4444" select> 香蕉 </option>
<option value="3"> 鴨梨 </option>
</select>
<input type="button" id="button" value="5555"/>
那麼: DWRUtil.getValues({textarea:null,select:null,text:null,password:null,button:null})
將返回 ^^^^^^^^^^^^^^^^{textarea:1111,select:4444,text:2222,password:3333,button:5555}
/**************************************************************************************/
7、DWRUtil.onReturn 防止當在文本框中輸入後，直接按回車就提交表單。
<input type="text" οnkeypress="DWRUtil.onReturn(event, submitFunction)"/>
<input type="button" οnclick="submitFunction()"/>
/**************************************************************************************/
8、DWRUtil.selectRange(ele, start, end);
在一個input box裏選一個範圍
DWRUtil.selectRange("sel-test", $("start").value, $("end").value);
比如:<input type="text" id="sel-test" value="012345678901234567890">
DWRUtil.selectRange("sel-test", 2, 15); 結果 文本框中的值"2345678901234"將被選中'
/**************************************************************************************/
9、DWRUtil.setValue(id,value);
爲指定的id元素,設置一個新值;
/**************************************************************************************/
10、DWRUtil.setValues({
name: "fzfx88",
password: "1234567890"
}
); 同上,批量更新表單值.
/**************************************************************************************/
11、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。toDescriptiveString("text",0);
/**************************************************************************************/
12、DWRUtil.useLoadingMessage();
當發出ajax請求後,頁面顯示的提示等待信息;
function searchUser(){
var loadinfo = "loading....."
try{
regUser.queryAllUser(userList);
DWRUtil.useLoadingMessage(loadinfo);
}catch(e){
}
}
/**************************************************************************************/