小程序开发定制window.addEventListener相关参数介绍说明

原型

public override function (type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

作用

　　小程序开发定制侦听事件并处理相应的函数。

参数

　　1、type:String 　　

　　　　小程序开发定制事件的类型。 　　

　　2、listener:Function

　　 　 小程序开发定制侦听到事件后处理事件的函数。 小程序开发定制此函数必须接受 Event 对象作为其唯一的参数，并且不能返回任何结果，如以下示例所示： function 函数名(evt:Event):void 　　

　　3、useCapture: (default = false) 　　

　　　　这里牵扯到“事件流”的概念。侦听器在侦听时有三个阶段：捕获阶段、目标阶段和冒泡阶段。顺序 为：捕获阶段（根节点到子节点检查是否调用了监听函数）→目标阶段（目标本身）→冒泡阶段（目标本身到根节点）。此处的参数确定侦听器是运行于捕获阶段、 目标阶段还是冒泡阶段。 如果将 useCapture 设置为 true，则侦听器只在捕获阶段处理事件，而不在目标或冒泡阶段处理事件。 如果useCapture 为 false，则侦听器只在目标或冒泡阶段处理事件。 要在所有三个阶段都侦听事件，请调用两次 addEventListener，一次将 useCapture 设置为 true，第二次再将useCapture 设置为 false。 　　

　　4、priority:int (default = 0) 　　

　　　　事件侦听器的优先级。 优先级由一个带符号的 32 位整数指定。 数字越大，优先级越高。 优先级为 n 的所有侦听器会在优先级为 n -1 的侦听器之前得到处理。 如果两个或更多个侦听器共享相同的优先级，则按照它们的添加顺序进行处理。 默认优先级为 0。 　　

　　5、useWeakReference:Boolean (default = false) 　　

　　　　确定对侦听器的引用是强引用，还是弱引用。 强引用（默认值）可防止您的侦听器被当作垃圾回收。 弱引用则没有此作用。

注意

　　使用EventDispatcher对象注册事件侦听器对象，以使侦听器能够接收事件通知。 可以为特定类型的事件、阶段和优先级在显示列表的所有节点上注册事件侦听器。 　　成功注册一个事件侦听器后，无法通过额外调用addEventListener()来更改其优先级。要更改侦听器的优先级，必须首先调用 removeListener()。 然后，可以使用新的优先级再次注册该侦听器。

例子

添加监听事件 　　
 
function Go() 　　{ 　　//... 　　} 　　
 
document.getElementById("testButton").addEventListener("click", Go, false); 　　
 
或者 listener 直接就是函数 　　
 
document.getElementById("testButton").addEventListener("click", function () { ... }, false); 　　
 
删除监听事件 　　
 
document.getElementById("testButton").addEventListener("click", Go[1]);