prototype.js开发笔记(三)-CSDN博客

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