Util.js文件
Util.js文件包含了一些工具函数,来帮助人们使用JavaScript数据(例如从服务器返回的数据)来更新Web页面。可以再DWR框架以外使用它,因为它不依赖于DWR的其他部分,并可以下载整个DWR框架或者单独下载。
Util.js文件包含了下面几个基本函数,分别为getValue[s](), setValue[s](), getText(), addRows(), removeAllRows(). addoptions()和removeAllOptions()。其中getValues[s]()函数可以操作大部分HTML页面元素(除了table, list和image); getText()函数可以操作select list, 要修改table可以用addRows()和removeAllRows()函数;要修改列表(select列表和ul、ol列表)可以用addOptions()和removeAllOptions()函数。Util.js文件中其他函数如下表:
函数名称 | 说明 |
$() | 它是合法的JavaScript名字,是从Protoype库“偷”来的。从大略上讲,$=document.getElementById。因为在Ajax程序中,会需要些很多这样的语句,所以使用$()函数会更简洁。通过制定的ID来查找当前HTML文档中的元素,如果传递给它多个参数,它会返回找到的元素的数组。所有非String类型的参数会被原封不动地返回。这个函数的灵感来自于Protoype库,但是它可以在更多的浏览器上运行。 |
addoptions(selected , array) | 会创建一堆<option>, 每个<option>的文字和值都是数组元素中的值 |
addRows(id, array, cellfuncs, [options]) | 它会向名为ID的表格添加表格行。每个array数组的元素将被创建一个行。Cellfuncs函数为array中每个元素内的字段(列)处理单元格,并根据cellfunc函数对字段的处理方法,遍历array数据元素内的各个字段而创建 |
getText(id) | 和getValue(id)函数很相似,除了它是为<select>列表设计的。可能需要取得显示的文字,而不是当前选项的值 |
getValue(id) | 是setValue()函数的对应的“读版本”。它可以从HTML页面元素中取出其中的值,而不用管这个元素是<select>列表还是一个<div>;这个函数能操作大多数HTML页面元素,包括<select>(去除当前选项的值,而不是文字)、 <input>元素(包括<textarea>)、<div>和<span> |
getValues() | 和getValue()函数非常相似,除了输入的是包含name/value对的JavaScript对象。name是HTML页面元素的id, value会被更改为这些id对象元素的内容。这个函数不会返回对象,它只更改传递给它的值 |
setValue(id, value) | 根据第一个参数中指定的id找到相应元素,并根据第二个参数改变其中的值。这个函数能操作大多数HTML页面元素,包括<select>(去除当前选项的值而不是文字)、<input>元素(包括<textarea>)、<div>和<span>. setValues()和setValue()函数非常相似,除了输入的是包含name/value对的JavaScript对象。name是HTML页面元素的id, value是想要设置给相应的元素的值 |
toDescriptiveString() | 比默认的toString()函数更好。第一个参数是要调试的对象,第二个参数是可选的,用来指定内容深入的层次,其中,0表示单行调试;1表示多行调试,但不深入到子对象;2表示多行调试,深入到第二层子对象,依此类推。一般调试到第二级是最佳的。还有第三个参数,用于定义初始缩进。这个函数不应该被用于调试程序之外,因为以后可能会有变化 |
转自图书《Ajax+Jsp网站开发从入门到精通》