prototype.js 教程二
1.4.2. 使用 Ajax.Updater 类
如果你的服务器的另一端返回的信息已经是HTML了，那么使用这个程序包中 Ajax.Updater 类将使你的生活变得更加得容易。用它你只需提供哪一个元素需要被AJAX请求返回的HTML填充就可以了，例子比我写说明的更清楚。
<script>
function getHTML()
{
var url = 'http://yourserver/app/getSomeHTML';
var pars = 'someParameter=ABC';
var myAjax = new Ajax.Updater('placeholder', url, {method: 'get', parameters: pars});
}
</script>
<input type=button value=GetHtml onclick="getHTML()">
<div id="placeholder"></div>
你可以看到，这段代码比前面的例子更加简洁，不包括 onComplete 方法，但是在构造方法中传入了一个元素id。 我们来稍稍修改一下代码来描述如何在客户端处理服务器段错误成为可能。
我们将加入更多的选项， 指定处理错误的一个方法。这个是用 onFailure 选项来完成的。
我们也指定了一个 placeholder 只有在成功请求之后才会被填充。为了完成这个目的我们修改了第一个参数从一个简单的元素id到一个带有两个属性的对象， success (一切OK的时候被用到) 和 failure (有地方出问题的时候被用到) 在下面的例子中没有用到failure属性，而仅仅在 onFailure 处使用了 reportError 方法。
<script>
function getHTML()
{
var url = 'http://yourserver/app/getSomeHTML';
var pars = 'someParameter=ABC';
var myAjax = new Ajax.Updater(
{success: 'placeholder'},
url,
{method: 'get', parameters: pars, onFailure: reportError});
}
function reportError(request)
{
alert('Sorry. There was an error.');
}
</script>
<input type=button value=GetHtml onclick="getHTML()">
<div id="placeholder"></div>
如果你的服务器逻辑是返回JavaScript 代码而不是单纯的 HTML 标记， Ajax.Updater对象可以执行那段JavaScript代码。为了使这个对象对待响应为JavaScript，你只需在最后参数的对象构造方法中简单加入evalScripts: true属性。
更完全的解释，请参照 Ajax.Updater 参考 和 Ajax选项参考 。
Table 2.2. Number 类的扩展
| 方法 | 类别 | 参数 | 描述 |
|---|---|---|---|
| toColorPart() | instance | (none) | 返回数字的十六进制描述， 当在HTML中转换为RGB颜色组件到HTML中使用的颜色。 |
Table 2.3. 对 Function 类的扩展
| 方法 | 类别 | 参数 | 描述 |
|---|---|---|---|
| bind(object) | instance | object: 拥有这个方法的对象 | 返回预先绑定在拥有该函数(=方法)的对象上的函数实例， 返回的方法将和原来的方法具有相同的参数。 |
| bindAsEventListener(object) | instance | object: 拥有这个方法的对象 | 返回预先绑定在拥有该函数(=方法)的对象上的函数实例， 返回的方法将把当前的事件对象作为它的参数。 |
让我们看看这些扩展的具体例子。
<input type=checkbox id=myChk value=1> Test?
<script>
//declaring the class
var CheckboxWatcher = Class.create();
//defining the rest of the class implmentation
CheckboxWatcher.prototype = {
initialize: function(chkBox, message) {
this.chkBox = $(chkBox);
this.message = message;
//assigning our method to the event
this.chkBox.onclick = this.showMessage.bindAsEventListener(this);
},
showMessage: function(evt) {
alert(this.message + ' (' + evt.type + ')');
}
};
var watcher = new CheckboxWatcher('myChk', 'Changed');
</script>
Table 2.4. String 类的扩展
| 方法 | 类别 | 参数 | 描述 |
|---|---|---|---|
| stripTags() | instance | (none) | 返回一个把所有的HTML或XML标记都移除的字符串。 |
| escapeHTML() | instance | (none) | 返回一个把所有的HTML标记回避掉的字符串。 |
| unescapeHTML() | instance | (none) | 和 escapeHTML()相反。 |
Table 2.5. document DOM 对象的扩展
| 方法 | 类别 | 参数 | 描述 |
|---|---|---|---|
| getElementsByClassName(className) | instance | className: 关联在元素上的CSS类名 | 返回给定的具有相同的CSS类名的所有元素。 |
Table 2.6. Event 对象的扩展
| 属性 | 类型 | 描述 |
|---|---|---|
| KEY_BACKSPACE | Number | 8: 常量，退格(Backspace)键的代码。 |
| KEY_TAB | Number | 9: 常量，Tab键的代码。 |
| KEY_RETURN | Number | 13: 常量，回车键的代码。 |
| KEY_ESC | Number | 27: 常量， Esc键的代码。 |
| KEY_LEFT | Number | 37: 常量，左箭头键的代码。 |
| KEY_UP | Number | 38: 常量，上箭头键的代码。 |
| KEY_RIGHT | Number | 39: 常量，右箭头键的代码。 |
| KEY_DOWN | Number | 40: 常量，下箭头键的代码。 |
| KEY_DELETE | Number | 46: 常量，删除(Delete)键的代码。 |
| observers: | Array | 缓存的观察者的列表，这个对象内部具体实现的一部分。 |
Table 2.7. Event 对象的扩展
| 方法 | 类别 | 参数 | 描述 |
|---|---|---|---|
| element(event) | static | event: 事件对象 | 返回引发这个事件的元素。 |
| isLeftClick(event) | static | event: 事件对象 | 如果鼠标左键单击返回true。 |
| pointerX(event) | static | event: 事件对象 | 返回在页面上x坐标。 |
| pointerY(event) | static | event: 事件对象 | 返回在页面上y坐标。 |
| stop(event) | static | event: 事件对象 | 用这个方法来中止事件的默认行为来使事件的传播停止。 |
| findElement(event, tagName) | static | event: 事件对象, tagName: 指定标记的名字 | 向 DOM 树的上位查找，找到第一个给定标记名称的元素， 从这个元素开始触发事件。 |
| observe(element, name, observer, useCapture) | static | element: 对象或者对象id, name: 事件名 (如 'click', 'load', etc), observer: 处理这个事件的方法, useCapture: 如果true, 在捕捉到事件的阶段处理事件 那么如果 false在bubbling 阶段处理。 | 加入一个处理事件的方法。 |
| stopObserving(element, name, observer, useCapture) | static | element: 对象或者对象id, name: 事件名 (如 'click', 'load', etc), observer: 处理这个事件的方法, useCapture: 如果true, 在捕捉到事件的阶段处理事件 那么如果 false在bubbling 阶段处理。 | 删除一个处理实践的方法。 |
| _observeAndCache( element, name, observer, useCapture) | static | 私有方法，不用管它。 | |
| unloadCache() | static | (none) | 私有方法，不用管它。清除内存中的多有观察着缓存。 |
让我们看看怎样用这个对象加入处理 window 对象的load事件的处理方法。
<script>
Event.observe(window, 'load', showMessage, false);
function showMessage() {
alert('Page loaded.');
}
</script>
浙公网安备 33010602011771号