Prototype1.4手册(17)

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

Method Kind Arguments Description
[ctor](form, frequency, callback)   constructor   form: form object or id, frequency: interval in seconds, callback function to be called when any data entry element in the form changes   继承自 Abstract.TimedObserver. 创建一个监听表单变化的对象。  
getValue()   instance   (none)   返回所有表单数据的一系列值。  

The Abstract.EventObserver class

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

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

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

Method Kind Arguments Description
[ctor](element, callback)   constructor   element: element object or id, callback: function to be called when the event happens   创建监听元素的对象。  
getValue()   instance,abstract   (none)   子类必须实现这个方法以瘊定什么这个元素被监视的当前值。  
registerCallback()   instance   (none)   这个方法通常不会被外部调用。 被对象调用来把自己绑定到元素的事件上。  
registerFormCallbacks()   instance   (none)   这个方法通常不会被外部调用。 被对象调用来把自己绑定到表单中的每一个数据项元素的事件上。  
onElementEvent()   instance   (none)   这个方法通常不会被外部调用。 将被绑定到元素的事件上。  

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

The Form.Element.EventObserver class

继承自

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

Method Kind Arguments Description
[ctor](element, callback)   constructor   element: element object or id, callback: function to be called when the event happens   继承自 Abstract.EventObserver。 创建一个监听元素值属性的对象。  
getValue()   instance   (none)   返回元素的值。  

The Form.EventObserver class

继承自

Abstract.EventObserver 的一个实现类,监听表单对象中包含的任何对象的任何变化,用元素的事件检测值的变化。如果元素没有任何报告变化的事件, 那么你可以使用 类代替。 Method Kind Arguments Description
[ctor](form, callback)   constructor   form: form object or id, callback: function to be called when any data entry element in the form changes   继承自 Abstract.EventObserver。 创建一个监听元素值属性的对象。  
getValue()   instance   (none)   返回所有表单数据的一系列值。  
Position 对象 (预备文档)

这个对象提供许多和元素位置相关的方法。

Method Kind Arguments Description
prepare()   instance   (none)   调整 deltaX 和 deltaY 属性来协调在滚动位置中的变化。 记得在页面滚动之后的任何调用的withinIncludingScrolloffset 之前调用这个方法。  
realOffset(element)   instance   element: object   返回这个元素的正确滚动偏差的 Array 对象, 包括所有影响元素的滚动偏差。结果数组类似 [total_scroll_left, total_scroll_top]  
cumulativeOffset(element)   instance   element: object   回这个元素的正确滚动偏差的 Array 对象, 包含任何被放置的父元素强加偏差。结果数组类似 [total_offset_left, total_offset_top]  
within(element, x, y)   instance   element: object, x and y: coordinates of a point   测试给定的点的坐标是否在给定的元素的外部矩形范围之内。  
withinIncludingScrolloffsets(element, x, y)   instance   element: object, x and y: coordinates of a point    测试给定的点的坐标是否在给定的元素的外部矩形范围之内(包含scroll offsets)。  
overlap(mode, element)   instance   mode: 'vertical' or 'horizontal', element: object   在调用这个方法之前需要调用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: element object or id, target: element object or id   改变目标元素的大小尺寸和位置与源元素的相同。  

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/wjjfjs.html