prototype.js开发笔记(三)

2.16. Ajax.Updater 类

继承自 Ajax.Request 

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

 

Table 2.17. Ajax.Updater 类

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

 

Table 2.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 选项中传入的方法-这个方法将被传入两个参数， 被更新的元素和响应文本。

 

2.17. Ajax.PeriodicalUpdater 类

继承自 Ajax.Base 

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

 

Table 2.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 2.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)	这个方法通常不会被外部调用。当到下一次更新时被内部调用。

 

2.18. Element 对象

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

 

Table 2.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	删除该元素的所有只含有空格的子节点。

 

2.19. Abstract 对象

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

2.20. Abstract.Insertion 类

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

 

Table 2.22. Abstract.Insertion 类

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

 

Table 2.23. Abstract.Insertion 类

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

 

2.21. Insertion 对象

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

2.22. Insertion.Before 类

继承自 Abstract.Insertion 

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

Table 2.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>

2.23. Insertion.Top 类

继承自 Abstract.Insertion 

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

Table 2.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>

2.24. Insertion.Bottom 类

继承自 Abstract.Insertion 

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

Table 2.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>

2.25. Insertion.After 类

继承自 Abstract.Insertion 

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

Table 2.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?

2.26. Field 对象

这个对象提供操作表单中的输入项目的功能性方法。

 

Table 2.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	移动焦点并且选择支持项目值选择的表单项目的