JavaScript EventTarget 接口
事件的本质是程序各个组成部分之间的一种通信方式,也是异步编程的一种实现。DOM 支持大量的事件,本章开始介绍 DOM 的事件编程。
介绍具体的事件之前,先来看看如何让 DOM 节点监听事件。
概述 #
DOM 节点的事件操作(监听和触发),都定义在EventTarget
接口。所有节点对象都部署了这个接口,其他一些需要事件通信的浏览器内置对象(比如,XMLHttpRequest
、AudioNode
、AudioContext
)也部署了这个接口。
该接口主要提供三个实例方法。
addEventListener()
:绑定事件的监听函数removeEventListener()
:移除事件的监听函数dispatchEvent()
:触发事件
EventTarget.addEventListener() #
EventTarget.addEventListener()
用于在当前节点或对象上(即部署了 EventTarget 接口的对象),定义一个特定事件的监听函数。一旦这个事件发生,就会执行监听函数。该方法没有返回值。
target.addEventListener(type, listener[, useCapture]);
该方法接受三个参数。
type
:事件名称,大小写敏感。listener
:监听函数。事件发生时,会调用该监听函数。useCapture
:布尔值,如果设为true
,表示监听函数将在捕获阶段(capture)触发(参见后文《事件的传播》部分)。该参数可选,默认值为false
(监听函数只在冒泡阶段被触发)。
下面是一个例子。
function hello() {
console.log('Hello world');
}
var button = document.getElementById('btn');
button.addEventListener('click', hello, false);
上面代码中,button
节点的addEventListener()
方法绑定click
事件的监听函数hello()
,该函数只在冒泡阶段触发。
关于参数,有两个地方需要注意。
首先,第二个参数除了监听函数,还可以是一个具有handleEvent
方法的对象,效果与监听函数一样。
buttonElement.addEventListener('click', {
handleEvent: function (event) {
console.log('click');
}
});
上面代码中,addEventListener()
方法的第二个参数,就是一个具有handleEvent()
方法的对象。
其次,第三个参数除了布尔值useCapture
,还可以是一个监听器配置对象,定制事件监听行为。该对象有以下属性。
capture
:布尔值,如果设为true
,表示监听函数在捕获阶段触发,默认为false
,在冒泡阶段触发。once
:布尔值,如果设为true
,表示监听函数执行一次就会自动移除,后面将不再监听该事件。该属性默认值为false
。passive
:布尔值,设为true
时,表示禁止监听函数调用preventDefault()
方法。如果调用了,浏览器将忽略这个要求,并在控制台输出一条警告。该属性默认值为false
。signal
:该属性的值为一个 AbortSignal 对象,为监听器设置了一个信号通道,用来在需要时发出信号,移除监听函数。
下面是once
属性的例子,让监听函数只执行一次。
element.addEventListener('click', function (event) {
// 只执行一次的代码
}, {once: true});
addEventListener()
方法可以为针对当前对象的同一个事件,添加多个不同的监听函数。这些函数按照添加顺序触发,即先添加先触发。如果为同一个事件多次添加同一个监听函数,该函数只会执行一次,多余的添加将自动被去除(不必使用removeEventListener()
方法手动去除)。
function hello() {
console.log('Hello world');
}
document.addEventListener('click', hello, false);
document.addEventListener('click', hello, false);
执行上面代码,点击文档只会输出一行Hello world
。
如果希望向监听函数传递参数,可以用匿名函数包装一下监听函数。
function print(x) {
console.log(x);
}
var el = document.getElementById('div1');
el.addEventListener('click', function () { print('Hello'); }, false);
上面代码通过匿名函数,向监听函数print
传递了一个参数。
监听函数内部的this
,指向当前事件所在的那个对象。
// HTML 代码如下
// <p id="para">Hello</p>
var para = document.getElementById('para');
para.addEventListener('click', function (e) {
console.log(this.nodeName); // "P"
}, false);
上面代码中,监听函数内部的this
指向事件所在的对象para
。
EventTarget.removeEventListener() #
EventTarget.removeEventListener()
方法用来移除addEventListener()
方法添加的事件监听函数。该方法没有返回值。
div.addEventListener('click', listener, false);
div.removeEventListener('click', listener, false);
removeEventListener()
方法的参数,与addEventListener()
方法完全一致。它的第一个参数“事件类型”,大小写敏感。
注意,removeEventListener()
方法移除的监听函数,必须是addEventListener()
方法添加的那个监听函数,而且必须在同一个元素节点,否则无效。
div.addEventListener('click', function (e) {}, false);
div.removeEventListener('click', function (e) {}, false);
上面代码中,removeEventListener()
方法无效,因为监听函数不是同一个匿名函数。
element.addEventListener('mousedown', handleMouseDown, true);
element.removeEventListener("mousedown", handleMouseDown, false);
上面代码中,removeEventListener()
方法也是无效的,因为第三个参数不一样。
EventTarget.dispatchEvent() #
EventTarget.dispatchEvent()
方法在当前节点上触发指定事件,从而触发监听函数的执行。该方法返回一个布尔值,只要有一个监听函数调用了Event.preventDefault()
,则返回值为false
,否则为true
。
target.dispatchEvent(event)
dispatchEvent()
方法的参数是一个Event
对象的实例(详见《Event 对象》章节)。
para.addEventListener('click', hello, false);
var event = new Event('click');
para.dispatchEvent(event);
上面代码在当前节点触发了click
事件。
如果dispatchEvent()
方法的参数为空,或者不是一个有效的事件对象,将报错。
下面代码根据dispatchEvent()
方法的返回值,判断事件是否被取消了。
var canceled = !cb.dispatchEvent(event);
if (canceled) {
console.log('事件取消');
} else {
console.log('事件未取消');
}