prototype.js简易教程文档2

4.15. options 参数对象
AJAX操作中一个重要的部分就是 options 参数。 本质上没有options类。任何对象都可以被传入，只要带有需要的属性。通常会只为了AJAX调用创建匿名类。

Table 16. options 参数对象

属性 类型 Default 描述
method Array 'post' HTTP 请求方式。
parameters String '' 在HTTP请求中传入的url格式的值列表。
asynchronous Boolean true 指定是否做异步 AJAX 请求。
postBody String undefined 在HTTP POST的情况下，传入请求体中的内容。
requestHeaders Array undefined 和请求一起被传入的HTTP头部列表， 这个列表必须含有偶数个项目， 任何奇数项目是自定义的头部的名称， 接下来的偶数项目使这个头部项目的字符串值。 例子:['my-header1', 'this is the value', 'my-other-header', 'another value']
onXXXXXXXX Function(XMLHttpRequest) undefined 在AJAX请求中，当相应的事件/状态形成的时候调用的自定义方法。 例如 var myOpts = {onComplete: showResponse, onLoaded: registerLoaded};. 这个方法将被传入一个参数， 这个参数是携带AJAX操作的 XMLHttpRequest对象。
onSuccess Function(XMLHttpRequest) undefined 当AJAX请求成功完成的时候调用的自定义方法。 这个方法将被传入一个参数， 这个参数是携带AJAX操作的 XMLHttpRequest对象。
onFailure Function(XMLHttpRequest) undefined 当AJAX请求完成但出现错误的时候调用的自定义方法。 这个方法将被传入一个参数， 这个参数是携带AJAX操作的 XMLHttpRequest对象。
insertion Function(Object, String) null 为了把返回的文本注入到一个元素中而执行的方法。 这个方法将被传入两个参数，要被更新的对象并且只应用于 Ajax.Updater的响应文本 。
evalScripts Boolean undefined, false 决定当响应到达的时候是否执行其中的脚本块，只在 Ajax.Updater 对象中应用。
decay Number undefined, 1 决定当最后一次响应和前一次响应相同时在 Ajax.PeriodicalUpdater 对象中的减漫访问的次数， 例如，如果设为2，后来的刷新和之前的结果一样， 这个对象将等待2个设定的时间间隔进行下一次刷新， 如果又一次一样， 那么将等待4次，等等。 不设定这个只，或者设置为1，将避免访问频率变慢。

4.16. Ajax.Updater 类
继承自 Ajax.Request

当请求的url返回一段HTML而你想把它直接放置到页面中一个特定的元素的时候被用到。 如果url的返回<script> 的块并且想在接收到时就执行它的时候也可以使用该对象。含有脚本的时候使用 evalScripts 选项。

Table 17. Ajax.Updater 类

属性 类型 类别 描述
ScriptFragment String static 可以判断是否为脚本的正则表达式。
containers Object instance 这个对象包含两个属性:AJAX请求成功执行的时候用到 containers.success , 否则的话用到 containers.failure 。

Table 18. Ajax.Updater 类

方法 类别 参数 描述
[ctor](container, url, options) constructor container:可以是元素的id, 也可以是元素自己, 或者可以是带有2个属性的对象 - object.success AJAX请求成功的时候用到的元素(或者id) 否则用到object.failure 中设定的元素(或id) ,url: 请求的url, options: AJAX 选项 创建一个用给定的选项请求给定的url的一个实例。
updateContent() instance (none) 这个方法通常不会被外部调用。 当响应到达的时候，被这个对象自己调用。 它会用HTML更新适当的元素或者调用在 insertion 选项中传入的方法-这个方法将被传入两个参数， 被更新的元素和响应文本。

4.17. Ajax.PeriodicalUpdater 类
继承自 Ajax.Base

这个类重复生成并使用 Ajax.Updater 对象来刷新页面中的一个元素。或者执行 Ajax.Updater 可以执行的其它任务。更多信息参照 Ajax.Updater 参考 。

Table 19. Ajax.PeriodicalUpdater 类

属性 类型 类别 描述
container Object instance 这个值将直接传入Ajax.Updater的构造方法。
url String instance 这个值将直接传入Ajax.Updater的构造方法。
frequency Number instance 两次刷新之间的间隔 (不是频率) ，以秒为单位。 默认2秒。 This 当调用 Ajax.Updater 对象的时候，这个数将和当前的 decay 相乘。
decay Number instance 重负执行任务的时候保持的衰败水平。
updater Ajax.Updater instance 最后一次使用的 Ajax.Updater 对象
timer Object instance 通知对象该下一次更新时用到的JavaScript 计时器。

Table 20. Ajax.PeriodicalUpdater 类

方法 类别 参数 描述
[ctor](container, url, options) constructor container:可以是元素的id, 也可以是元素自己, 或者可以是带有2个属性的对象 - object.success AJAX请求成功的时候用到的元素(或者id) 否则用到object.failure 中设定的元素(或id) ,url: 请求的url, options: AJAX 选项 创建一个用给定的选项请求给定的url的一个实例。
start() instance (none) 这个方法通常不会被外部调用。 对象为了开始周期性执行任务的时候调用的方法。
stop() instance (none) 这个方法通常不会被外部调用。 对象为了停止周期性执行任务的时候调用的方法。
updateComplete() instance (none) 这个方法通常不会被外部调用。 被当前的 Ajax.Updater 使用，当一次请求结束的时候，它被用作计划下一次请求。
onTimerEvent() instance (none) 这个方法通常不会被外部调用。当到下一次更新时被内部调用。

4.18. Element 对象
这个对象提供在操作DOM中元素时使用的功能性方法。

Table 21. Element 对象

方法 类别 参数 描述
toggle(elem1 [, elem2 [, elem3 [...]]]) constructor elemN: 元素对象或id 切换每一个传入元素的可视性。
hide(elem1 [, elem2 [, elem3 [...]]]) instance elemN: 元素对象或id 用设定它的 style.display 为 'none'来隐藏每个传入的元素。
show(elem1 [, elem2 [, Slem3 [...]]]) instance elemN: 元素对象或id 用设定它的 style.display 为 ''来显示每个传入的元素。
remove(element) instance element: 元素对象或id 从document对象中删除指定的元素。
getHeight(element) instance element: 元素对象或id 返回元素的 offsetHeight 。
addClassName( element, className) instance element: 元素对象或id, className: CSS类名 向元素的类名中加入给定的类名。
hasClassName( element, className) instance element: 元素对象或id, className: CSS类名 返回 true 如果元素的类名中含有给定的类名
removeClassName( element, className) instance element: 元素对象或id, className: CSS类名 从元素的类名中删除给定的类名。
cleanWhitespace( element ) instance element: 元素对象或id 删除该元素的所有只含有空格的子节点。

4.19. Abstract 对象
这个对象是这个程序包中其他类的根。它没有任何属性和方法。在这个对象中定义的类可以被视为传统的抽象类。

4.20. Abstract.Insertion 类
这个类被用作其他提供动态内容插入功能的类的基类，它像一个抽象类一样被使用。

Table 22. Abstract.Insertion 类

方法 类别 参数 描述
[ctor](element, content) constructor element: 元素对象或id, content: 被插入的HTML 创建一个可以帮助插入动态内容的对象。

Table 23. Abstract.Insertion 类

属性 类型 类别 描述
adjacency String static, parameter 这个参数指定相对于给定元素，内容将被放置的位置。 可能的值是: 'beforeBegin', 'afterBegin', 'beforeEnd', 和 'afterEnd'.
element Object instance 与插入物做参照元素对象。
content String instance 被插入的 HTML 。

4.21. Insertion 对象
这个对象是其他类似功能的根。它没有任何属性和方法。在这个对象中定义的类仍然可以被视为传统的抽象类。

4.22. Insertion.Before 类
继承自 Abstract.Insertion

在给定元素开始标记的前面插入HTML。

Table 24. Insertion.Before 类

方法 类别 参数 描述
[ctor](element, content) constructor element: 元素对象或id, content: 被插入的HTML 继承自 Abstract.Insertion. 创建一个可以帮助插入动态内容的对象。

下面的代码

<br>Hello, <span id="person" style="color:red;">Wiggum. How's it going?</span><script> new Insertion.Before('person', 'Chief '); </script>将把 HTML 变为

<br>Hello, Chief <span id="person" style="color:red;">Wiggum. How's it going?</span>4.23. Insertion.Top 类
继承自 Abstract.Insertion

在给定元素第一个子节点位置插入 HTML。内容将位于元素的开始标记的紧后面。

Table 25. Insertion.Top 类

方法 类别 参数 描述
[ctor](element, content) constructor element: 元素对象或id, content: 被插入的HTML 继承自 Abstract.Insertion. 创建一个可以帮助插入动态内容的对象。

下面的代码

<br>Hello, <span id="person" style="color:red;">Wiggum. How's it going?</span><script> new Insertion.Top('person', 'Mr. '); </script>将把 HTML 变为

<br>Hello, <span id="person" style="color:red;">Mr. Wiggum. How's it going?</span>4.24. Insertion.Bottom 类
继承自 Abstract.Insertion

在给定元素最后一个子节点位置插入 HTML。内容将位于元素的结束标记的紧前面。

Table 26. Insertion.Bottom 类

方法 类别 参数 描述
[ctor](element, content) constructor element: 元素对象或id, content: 被插入的HTML 继承自 Abstract.Insertion. 创建一个可以帮助插入动态内容的对象。

下面的代码

<br>Hello, <span id="person" style="color:red;">Wiggum. How's it going?</span><script> new Insertion.Bottom('person', " What's up?"); </script>将把 HTML 变为

<br>Hello, <span id="person" style="color:red;">Wiggum. How's it going? What's up?</span>4.25. Insertion.After 类
继承自 Abstract.Insertion

在给定元素结束标记的后面插入HTML。

Table 27. Insertion.After 类

方法 类别 参数 描述
[ctor](element, content) constructor element: 元素对象或id, content: 被插入的HTML 继承自 Abstract.Insertion. 创建一个可以帮助插入动态内容的对象。

下面的代码

<br>Hello, <span id="person" style="color:red;">Wiggum. How's it going?</span><script> new Insertion.After('person', ' Are you there?'); </script>将把 HTML 变为

<br>Hello, <span id="person" style="color:red;">Wiggum. How's it going?</span> Are you there?4.26. Field 对象
这个对象提供操作表单中的输入项目的功能性方法。

Table 28. Field 对象

方法 类别 参数 描述
clear(field1 [, field2 [, field3 [...]]]) instance fieldN: 元素对象或id 清除传入表单中项目元素的值。
present(field1 [, field2 [, field3 [...]]]) instance fieldN: 元素对象或id 只有在所有的表单项目都不为空时返回 true 。
focus(field) instance fieldN: 元素对象或id 移动焦点到给定的表单项目。
select(field) instance fieldN: 元素对象或id 选择支持项目值选择的表单项目的值。
activate(field) instance fieldN: 元素对象或id 移动焦点并且选择支持项目值选择的表单项目的值。

4.27. Form 对象
这个对象提供操作表单和他们的输入项目的功能性方法。

Table 29. Form 对象

方法 类别 参数 描述
serialize(form) instance form: 表单元素或id 返回url参数格式的项目名和值的列表， 如'field1=value1&field2=value2&field3=value3'。
getElements(form) instance form: 表单元素或id 返回包含所有在表单中输入项目的 Array 对象。
getInputs(form [, typeName [, name]]) instance form: 表单元素或id, typeName: 输入项目的类型, name: 输入项目的名称 返回一个 Array 包含所有在表单中的 <input> 元素。 另外， 这个列表可以对元素的类型或名字属性进行过滤。
disable(form) instance form: 表单元素或id 使表单中的所有输入项目无效。
enable(form) instance form: 表单元素或id 使表单中的所有输入项目有效。
focusFirstElement(form) instance form: 表单元素或id 激活第一个表单中可视的，有效的输入项目。
reset(form) instance form: 表单元素或id 重置表单。和调用表单对象的 reset() 方法一样。

4.28. Form.Element 对象
这个对象提供表单对象中的可视和非可视元素的功能性方法。

Table 30. Form.Element 对象

方法 类别 参数 描述
serialize(element) instance element: 表单元素或id 返回元素的 名称=值 对, 如 'elementName=elementValue'。
getValue(element) instance element: 表单元素或id 返回元素的值。

4.29. Form.Element.Serializers 对象
这个对象提供了内部使用的用来协助解析出表单元素的当前值功能性方法。

Table 31. Form.Element.Serializers 对象

方法 类别 参数 描述
inputSelector(element) instance element: 一个带有checked属性的表单元素或id， 如 radio 或 checkbox。 返回带有元素名称和值的 Array , 如 ['elementName', 'elementValue']
textarea(element) instance element: 一个带有value属性的表单元素或id， 如 textbox, button 或 password 项目。 返回带有元素名称和值的 Array , 如 ['elementName', 'elementValue']
select(element) instance element: 一个<select> 元素对象或id。 返回带有元素名称和所有被选择的选项的值或文本的 Array , 如 ['elementName', 'selOpt1 selOpt4 selOpt9']

4.30. Abstract.TimedObserver 类
这个类是用于其它监听一个元素的值(或者任何类中涉及的属性)变化的类的基类，这个类像一个抽象类一样被使用。

子类可以被创建来监听如输入项目值，或style属性，或表格的行数，或者其他任何对跟踪变化相关的东西。

子类必须实现这个方法来决定什么才是被监听的元素的当前值。

Table 32. Abstract.TimedObserver 类

方法 类别 参数 描述
[ctor](element, frequency, callback) constructor element: 元素对象或id, frequency: 以秒为单位的间隔, callback: 当元素改变的时候调用的方法。 创建一个监听元素的对象。
registerCallback() instance (none) 这个方法通常不会被外部调用。 被这个对象自己调用来开始监听那个元素。
onTimerEvent() instance (none) 这个方法通常不会被外部调用。 被这个对象自己调用来周期性的检查那个元素。

Table 33. Abstract.TimedObserver 类

属性 类型 描述
element Object 被监听的元素对象。
frequency Number 每次检查中的以秒为单位的时间间隔。
callback Function(Object, String) 只要元素改变这个方法就会被调用。 会接收到元素对象和新值作为参数。
lastValue String 元素被核实的最后一个值。

4.31. Form.Element.Observer 类
继承自 Abstract.TimedObserver

Abstract.TimedObserver 的一个实现类用来监听表单输入项目的值的变化。当你想监听一个没有带报告值变化事件的元素的时候使用这个类。否则的话使用 Form.Element.EventObserver 类代替。

Table 34. Form.Element.Observer 类

方法 类别 参数 描述
[ctor](element, frequency, callback) constructor element: 元素对象或id, frequency: 以秒为单位的间隔, callback: 当元素改变的时候调用的方法。 继承自 Abstract.TimedObserver. 创建一个监听元素值属性的对象。
getValue() instance (none) 返回元素的值。

4.32. Form.Observer 类
继承自 Abstract.TimedObserver

Abstract.TimedObserver 的一个实现类用来监听表单中任何数据项的值的变化。当你想监听一个没有带报告值变化事件的元素的时候使用这个类。 否则的话使用类Form.EventObserver 代替。

Table 35. Form.Observer 类

方法 类别 参数 描述
[ctor](form, frequency, callback) constructor form: 表单对象或id, 继承自 Abstract.TimedObserver. 创建一个监听表单变化的对象。
getValue() instance (none) 返回所有表单数据的一系列值。

4.33. Abstract.EventObserver 类
这个类被用作其他一些类的基类，这些类具有在一个元素的值改变事件发生的时候执行一个回调方法这样的功能。

类 Abstract.EventObserver 的多个对象可以绑定到一个元素上，不是一个帮其他的擦出了，而是按照他们付给元素的顺序执行这些回调方法。

单选按钮和复选框的触发事件是 onclick ，而文本框和下拉列表框/下拉列表框的是 onchange 。

子类必须实现这个方法来决定什么才是被监听的元素的当前值。

Table 36. Abstract.EventObserver 类

方法 类别 参数 描述
[ctor](element, callback) constructor element: 元素对象或id, callback: 当事件发生的时候调用的方法。 创建监听元素的对象。
registerCallback() instance (none) 这个方法通常不会被外部调用。 被对象调用来把自己绑定到元素的事件上。
registerFormCallbacks() instance (none) 这个方法通常不会被外部调用。 被对象调用来把自己绑定到表单中的每一个数据项元素的事件上。
onElementEvent() instance (none) 这个方法通常不会被外部调用。 将被绑定到元素的事件上。

Table 37. Abstract.EventObserver 类

属性 类型 描述
element Object 被监听的元素对象。
callback Function(Object, String) 只要元素改变就调用的方法。会接收到元素对象和新值作为参数。
lastValue String 元素被核实的最后一个值。

4.34. Form.Element.EventObserver 类
继承自 Abstract.EventObserver

Abstract.EventObserver 的一个实现类，它在监测到表单中数据项元素的值改变的相应事件时候执行一个回调方法。 如果元素没有任何报告变化的事件，那么你可以使用 Form.Element.Observer 类代替。

Table 38. Form.Element.EventObserver 类

方法 类别 参数 描述
[ctor](element, callback) constructor element: 元素对象或id, callback: 当事件发生的时候调用的方法。 继承自 Abstract.EventObserver。 创建一个监听元素值属性的对象。
getValue() instance (none) 返回元素的值。

4.35. Form.EventObserver 类
继承自 Abstract.EventObserver

Abstract.EventObserver 的一个实现类，监听表单对象中包含的任何对象的任何变化，用元素的事件检测值的变化。如果元素没有任何报告变化的事件， 那么你可以使用Form.Observer 类代替。

Table 39. Form.Element.EventObserver 类

方法 类别 参数 描述
[ctor](form, callback) constructor form: 元素对象或id, callback: 当表单中任何数据项改变的时候调用的方法 继承自 Abstract.EventObserver。 创建一个监听元素值属性的对象。
getValue() instance (none) 返回所有表单数据的一系列值。

4.36. Position 对象 (预备文档)
这个对象提供许多和元素位置相关的方法。

Table 40. Position 对象 (预备文档)

方法 类别 参数 描述
prepare() instance (none) 调整 deltaX 和 deltaY 属性来协调在滚动位置中的变化。 记得在页面滚动之后的任何调用的withinIncludingScrolloffset 之前调用这个方法。
realOffset(element) instance element: 对象或id 返回这个元素的正确滚动偏差的 Array 对象， 包括所有影响元素的滚动偏差。结果数组类似 [total_scroll_left, total_scroll_top]
cumulativeOffset(element) instance element: 对象或id 回这个元素的正确滚动偏差的 Array 对象， 包含任何被放置的父元素强加偏差。结果数组类似 [total_offset_left, total_offset_top]
within(element, x, y) instance element: 对象, x 和 y: 一个点的坐标 测试给定的点的坐标是否在给定的元素的外部矩形范围之内。
withinIncludingScrolloffsets(element, x, y) instance element: object, x and y: coordinates of a point  
overlap(mode, element) instance mode: 'vertical' 或 'horizontal', element: 对象 在调用这个方法之前需要调用within() 。这个方法返回0.0到1.0之间的数字，来表示坐标在元素重叠的分数。 举个例子，如果元素是一个边长是100px的正方形的DIV，并且位于(300, 300), 然后 within(divSquare, 330, 330)；overlap('vertical', divSquare); 会返回 0.10，意思是那个点位于DIV顶部边框以下 10% (30px) 的位置上。
clone(source, target) instance source: 元素对象或 id, target: 元素对象或id 改变目标元素的大小尺寸和位置与源元素的相同。