prototype.js开发笔记III

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	改变目标元素的大小尺寸和位置与源元素的相同。

如果你发现错误，过失或信息不完全，或平淡无意义的东西，请 通知作者 ，作者会尽可能快的修正它，作者仍然在写其他没写的类，来保持一致。 任何翻译的过失，不足，词不达意，表达含糊等请通知我，我会再加斟酌，找到合适的描述。

分享到：

EXT典型范例 Image Chooser源码大剖析 | prototype.js开发笔记II

• 2008-12-28 07:17
• 浏览 683
• 评论(0)
• 查看更多