stopObserving [1.6.0]
document.stopObserving(eventName, handler[, useCapture = false]) -> document
为文档注销指定的事件处理程序。
document.stopObserving 是 Element#stopObserving 基于整个文档范围的版本。
stopObserving
Event.stopObserving(element, eventName, handler[, useCapture = false])
注销事件处理程序。
该方法具有与 observe 在语义上完全一致的参数。它用于注销一个事件处理程序, 注销后这个元素事件的组合将不会被再次调用。
为什么不会停止调用?
为使 stopObserving 正常工作,必须传入与调用相关的 observe 注册事件时 完全相同的参数。 这看起来似乎很简单,但是编写代码时经常会出现类似下面的一种常见错误:
var obj = {
…
fx: function(event) {
…
}
};
Event.observe(elt, 'click', obj.fx.bindAsEventListener(obj));
…
// 这是错误的,不能这样做
E...
stopObserving
stopObserving(element, eventName, handler) -> HTMLElement
为 element 注销指定的事件处理程序。
这是对 Event.stopObserving 的简单代理,更深入的信息请参考 Event.stopObserving。
样例
$(element).stopObserving('click', coolAction);
// -> HTMLElement(并注销 'coolAction' 事件处理程序)。
stopObserving(element, eventName, handler) -> HTMLElement
为 element 注销指定的事件处理程序。
这是对 Event.stopObserving 的简单代理,更深入的信息请参考 Event.stopObserving。
样例
$(element).stopObserving('click', coolAction);
// -> HTMLElement(并注销 'coolAction' 事件处理程序)。