这是我参与8月更文挑战的第4天,活动详情查看:8月更文挑战html
EventTarget
接口概述DOM 的事件操做(监听和触发),都定义在EventTarget
接口。全部节点对象都部署了这个接口,其余一些须要事件通讯的浏览器内置对象(好比,XMLHttpRequest
、AudioNode
、AudioContext
)也部署了这个接口。node
该接口主要提供三个实例方法。web
addEventListener
:绑定事件的监听函数removeEventListener
:移除事件的监听函数dispatchEvent
:触发事件EventTarget.addEventListener()
用于在当前节点或对象上,定义一个特定事件的监听函数。一旦这个事件发生,就会执行监听函数。该方法没有返回值。编程
target.addEventListener(type, listener[, useCapture]);
复制代码
该方法接受三个参数。浏览器
type
:事件名称,大小写敏感。listener
:监听函数。事件发生时,会调用该监听函数。useCapture
:布尔值,表示监听函数是否在捕获阶段(capture)触发,默认为false
(监听函数只在冒泡阶段被触发)。该参数可选。下面是一个例子。markdown
function hello() {
console.log('Hello world');
}
var button = document.getElementById('btn');
button.addEventListener('click', hello, false);
复制代码
上面代码中,button
节点的addEventListener
方法绑定click
事件的监听函数hello
,该函数只在冒泡阶段触发。函数
上面代码中,addEventListener
方法的第二个参数,就是一个具备handleEvent
方法的对象。post
其次,第三个参数除了布尔值useCapture
,还能够是一个属性配置对象。该对象有如下属性。ui
capture
:布尔值,表示该事件是否在捕获阶段
触发监听函数。once
:布尔值,表示监听函数是否只触发一次,而后就自动移除。passive
:布尔值,表示监听函数不会调用事件的preventDefault
方法。若是监听函数调用了,浏览器将忽略这个要求,并在监控台输出一行警告。
若是但愿事件监听函数只执行一次,能够打开属性配置对象的once
属性。this
element.addEventListener('click', function (event) {
// 只执行一次的代码 且 this 指向 element
console.log(this.nodeName); // "element"
}, {once: true});
复制代码
addEventListener
方法能够为针对当前对象的同一个事件,添加多个不一样的监听函数。这些函数按照添加顺序触发,即先添加先触发。若是为同一个事件屡次添加同一个监听函数,该函数只会执行一次,多余的添加将自动被去除(没必要使用removeEventListener
方法手动去除)。
上面代码中,监听函数内部的this
指向事件所在的对象element
。
EventTarget.removeEventListener
方法用来移除addEventListener
方法添加的事件监听函数。该方法没有返回值。
div.addEventListener('click', listener, false);
div.removeEventListener('click', listener, false);
复制代码
removeEventListener
方法的参数,与addEventListener
方法彻底一致。它的第一个参数“事件类型”,大小写敏感。
注意,removeEventListener
方法移除的监听函数,必须是addEventListener
方法添加的那个监听函数,并且必须在同一个元素节点,不然无效。
EventTarget.dispatchEvent
方法在当前节点上触发指定事件,从而触发监听函数的执行。该方法返回一个布尔值,只要有一个监听函数调用了Event.preventDefault()
,则返回值为false
,不然为true
。
target.dispatchEvent(event)
复制代码
dispatchEvent
方法的参数是一个Event
对象的实例。
para.addEventListener('click', hello, false);
var event = new Event('click');
para.dispatchEvent(event);
复制代码
上面代码在当前节点触发了click
事件。
若是dispatchEvent
方法的参数为空,或者不是一个有效的事件对象,将报错。
浏览器的事件模型,就是经过监听函数(listener)对事件作出反应。事件发生后,浏览器监听到了这个事件,就会执行对应的监听函数。这是事件驱动编程模式(event-driven)的主要编程方式。
JavaScript 有三种方法,能够为事件绑定监听函数。
HTML 语言容许在元素的属性中,直接定义某些事件的监听代码。
<body onload="doSomething()">
<div onclick="console.log('触发事件')">
复制代码
上面代码为body
节点的load
事件、div
节点的click
事件,指定了监听代码。一旦事件发生,就会执行这段代码。
元素的事件监听属性,都是on
加上事件名,好比onload
就是on + load
,表示load
事件的监听代码。
注意,这些属性的值是将会执行的代码,而不是一个函数。
<!-- 正确 -->
<body onload="doSomething()">
复制代码
一旦指定的事件发生,on-
属性的值是原样传入 JavaScript 引擎执行。所以若是要执行函数,不要忘记加上一对圆括号
。使用这个方法只会在冒泡阶段触发
。
直接设置on-
属性,与经过元素节点的setAttribute
方法设置on-
属性,效果是同样的。
el.setAttribute('onclick', 'doSomething()');
// 等同于
// <Element onclick="doSomething()">
复制代码
元素节点对象的事件属性,一样能够指定监听函数。
window.onload = doSomething;
div.onclick = function (event) {
console.log('触发事件');
};
复制代码
使用这个方法指定的监听函数,也是只会在冒泡阶段触发。
注意,这种方法与 HTML 的on-
属性的差别是,它的值是函数名(doSomething
),而不像后者,必须给出完整的监听代码(doSomething()
)。
全部 DOM 节点实例都有addEventListener
方法,用来为该节点定义事件的监听函数。
window.addEventListener('load', doSomething, false);
复制代码
addEventListener
方法的详细介绍,参见上面EventTarget
接口。
上面三种方法,第一种“HTML 的 on- 属性”,违反了 HTML 与 JavaScript 代码相分离的原则,将二者写在一块儿,不利于代码分工,所以不推荐使用。
第二种“元素节点的事件属性”的缺点在于,同一个事件只能定义一个监听函数,也就是说,若是定义两次onclick
属性,后一次定义会覆盖前一次。所以,也不推荐使用。
第三种EventTarget.addEventListener
是推荐的指定监听函数的方法。它有以下优势:
window
、XMLHttpRequest
等)也有这个接口,它等因而整个 JavaScript 统一的监听函数接口。监听函数内部的this
指向触发事件的那个元素节点。三种监听函数的写法,this
的指向均是如此。
// HTML 代码以下 写法一
// <button id="btn" onclick="console.log(this.id)">点击</button> // btn
var btn = document.getElementById('btn');
// 写法二
btn.onclick = function () {
console.log(this.id); // btn
};
// 写法三
btn.addEventListener(
'click',
function (e) {
console.log(this.id); // btn
},
false
);
复制代码
上面两种写法,点击按钮之后也是输出btn
。
一个事件发生后,会在子元素和父元素之间传播(propagation)。这种传播分红三个阶段。
window
对象传导到目标节点(上层传到底层),称为“捕获阶段”(capture phase)。window
对象(从底层传回上层),称为“冒泡阶段”(bubbling phase)。这种三阶段的传播模型,使得同一个事件会在多个节点上触发。
<div>
<p>点击</p>
</div>
复制代码
上面代码中,<div>
节点之中有一个<p>
节点。
若是对这两个节点,都设置click
事件的监听函数(每一个节点的捕获阶段和冒泡阶段,各设置一个监听函数),共计设置四个监听函数。而后,对<p>
点击,click
事件会触发四次。
var phases = {
1: 'capture',
2: 'target',
3: 'bubble'
};
var div = document.querySelector('div');
var p = document.querySelector('p');
div.addEventListener('click', callback, true);
p.addEventListener('click', callback, true);
div.addEventListener('click', callback, false);
p.addEventListener('click', callback, false);
function callback(event) {
var tag = event.currentTarget.tagName;
var phase = phases[event.eventPhase];
console.log("Tag: '" + tag + "'. EventPhase: '" + phase + "'");
}
// 点击之后的结果
// Tag: 'DIV'. EventPhase: 'capture'
// Tag: 'P'. EventPhase: 'target'
// Tag: 'P'. EventPhase: 'target'
// Tag: 'DIV'. EventPhase: 'bubble'
复制代码
上面代码表示,click
事件被触发了四次:<div>
节点的捕获阶段和冒泡阶段各1次,<p>
节点的目标阶段触发了2次。
<div>
向<p>
传播时,触发<div>
的click
事件;<div>
到达<p>
时,触发<p>
的click
事件;<p>
传回<div>
时,再次触发<div>
的click
事件。其中,<p>
节点有两个监听函数(addEventListener
方法第三个参数的不一样,会致使绑定两个监听函数),所以它们都会由于click
事件触发一次。因此,<p>
会在target
阶段有两次输出。
事件传播的最上层对象是window
,接着依次是document
,html
(document.documentElement
)和body
(document.body
)。也就是说,上例的事件传播顺序,在捕获阶段依次为window
、document
、html
、body
、div
、p
,在冒泡阶段依次为p
、div
、body
、html
、document
、window
。
因为事件会在冒泡阶段向上传播到父节点,所以能够把子节点的监听函数定义在父节点上,由父节点的监听函数统一处理多个子元素的事件。这种方法叫作事件的代理(delegation)。
var ul = document.querySelector('ul');
ul.addEventListener('click', function (event) {
if (event.target.tagName.toLowerCase() === 'li') {
// some code
}
});
复制代码
上面代码中,click
事件的监听函数定义在<ul>
节点,可是实际上,它处理的是子节点<li>
的click
事件。这样作的好处是,只要定义一个监听函数,就能处理多个子节点的事件,而不用在每一个<li>
节点上定义监听函数。并且之后再添加子节点,监听函数依然有效。
若是但愿事件到某个节点为止,再也不传播,可使用事件对象的stopPropagation
方法。
// 事件传播到 p 元素后,就再也不向下传播了
p.addEventListener('click', function (event) {
event.stopPropagation();
}, true);
// 事件冒泡到 p 元素后,就再也不向上冒泡了
p.addEventListener('click', function (event) {
event.stopPropagation();
}, false);
复制代码
上面代码中,stopPropagation
方法分别在捕获阶段和冒泡阶段,阻止了事件的传播。
可是,stopPropagation
方法只会阻止事件的传播,不会阻止该事件触发<p>
节点的其余click
事件的监听函数。也就是说,不是完全取消click
事件。
若是想要完全取消该事件,再也不触发后面全部click
的监听函数,可使用stopImmediatePropagation
方法。
p.addEventListener('click', function (event) {
event.stopImmediatePropagation();
console.log(1);
});
p.addEventListener('click', function(event) {
// 不会被触发
console.log(2);
});
复制代码
上面代码中,stopImmediatePropagation
方法能够完全取消这个事件,使得后面绑定的全部click
监听函数都再也不触发。因此,只会输出1,不会输出2。