一、事件
1. EventTarget 接口
DOM 的事件操作(监听和触发),都定义在EventTarget接口。所有节点对象都部署了这个接口,其他一些需要事件通信的浏览器内置对象(比如,XMLHttpRequest、AudioNode、AudioContext)也部署了这个接口。
该接口主要提供三个实例方法。
- addEventListener:绑定事件的监听函数
- removeEventListener:移除事件的监听函数
- dispatchEvent:触发事件
// EventTarget.addEventListener()
// EventTarget.addEventListener()用于在当前节点或对象上,定义一个特定事件的监听函数。
// 一旦这个事件发生,就会执行监听函数。该方法没有返回值。
function hello() {
console.log('Hello world');
}
var button = document.getElementById('btn');
button.addEventListener('click', hello, false);
// EventTarget.removeEventListener()
// EventTarget.removeEventListener方法用来移除addEventListener方法添加的事件监听函数。该方法没有返回值。
div.addEventListener('click', listener, false);
div.removeEventListener('click', listener, false);
// EventTarget.dispatchEvent()
// EventTarget.dispatchEvent方法在当前节点上触发指定事件,从而触发监听函数的执行。
// 该方法返回一个布尔值,只要有一个监听函数调用了Event.preventDefault(),则返回值为false,否则为true。
var canceled = !cb.dispatchEvent(event);
if (canceled) {
console.log('事件取消');
} else {
console.log('事件未取消');
}
2. 事件模型
监听函数
- 浏览器的事件模型,就是通过监听函数(listener)对事件做出反应。事件发生后,浏览器监听到了这个事件,就会执行对应的监听函数。这是事件驱动编程模式(event-driven)的主要编程方式。
- JavaScript 有三种方法,可以为事件绑定监听函数。
// HTML 的 on- 属性
<body onload="doSomething()">
<div onclick="console.log('触发事件')">
// 注意,这些属性的值是将会执行的代码,而不是一个函数。
<!-- 正确 -->
<body onload="doSomething()">
<!-- 错误 -->
<body onload="doSomething">
// 元素节点的事件属性
window.onload = doSomething;
div.onclick = function (event) {
console.log('触发事件');
};
// 注意,这种方法与 HTML 的on-属性的差异是,它的值是函数名(doSomething)
// EventTarget.addEventListener()
// 所有 DOM 节点实例都有addEventListener方法,用来为该节点定义事件的监听函数。
window.addEventListener('load', doSomething, false);
this 指向
- 监听函数内部的this指向触发事件的那个元素节点。
事件传播
- 一个事件发生后,会在子元素和父元素之间传播(propagation)。这种传播分成三个阶段。
- 第一阶段:从window对象传导到目标节点(上层传到底层),称为“捕获阶段”(capture phase)。
- 第二阶段:在目标节点上触发,称为“目标阶段”(target phase)。
- 第三阶段:从目标节点传导回window对象(从底层传回上层),称为“冒泡阶段”(bubbling phase)。
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'
// 事件传播的最上层对象是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
}
});
3. Event 对象
事件发生以后,会产生一个事件对象,作为参数传给监听函数。浏览器原生提供一个Event对象,所有的事件都是这个对象的实例,或者说继承了Event.prototype对象。
Event对象本身就是一个构造函数,可以用来生成新的实例。
event = new Event(type, options);
var ev = new Event(
'look',
{
'bubbles': true,
'cancelable': false
}
);
document.dispatchEvent(ev);
实例属性
Event.bubbles,Event.eventPhase
Event.cancelable,Event.cancelBubble,event.defaultPrevented
Event.currentTarget,Event.target
Event.type
Event.timeStamp
Event.isTrusted
Event.detail
Event.bubbles属性返回一个布尔值,表示当前事件是否会冒泡。该属性为只读属性,一般用来了解 Event 实例是否可以冒泡。
Event.eventPhase属性返回一个整数常量,表示事件目前所处的阶段。该属性只读。
Event.cancelable属性返回一个布尔值,表示事件是否可以取消。该属性为只读属性,一般用来了解 Event 实例的特性。
Event.cancelBubble属性是一个布尔值,如果设为true,相当于执行Event.stopPropagation(),可以阻止事件的传播。
Event.defaultPrevented属性返回一个布尔值,表示该事件是否调用过Event.preventDefault方法。该属性只读。
Event.currentTarget属性返回事件当前所在的节点,即事件当前正在通过的节点,也就是当前正在执行的监听函数所在的那个节点。随着事件的传播,这个属性的值会变。
Event.target属性返回原始触发事件的那个节点,即事件最初发生的节点。这个属性不会随着事件的传播而改变。
Event.type属性返回一个字符串,表示事件类型。事件的类型是在生成事件的时候指定的。该属性只读。
Event.timeStamp属性返回一个毫秒时间戳,表示事件发生的时间。它是相对于网页加载成功开始计算的。
Event.isTrusted属性返回一个布尔值,表示该事件是否由真实的用户行为产生。比如,用户点击链接会产生一个click事件,该事件是用户产生的;Event构造函数生成的事件,则是脚本产生的。
Event.detail属性只有浏览器的 UI (用户界面)事件才具有。该属性返回一个数值,表示事件的某种信息。具体含义与事件类型相关。
比如,对于click和dblclick事件,Event.detail是鼠标按下的次数(1表示单击,2表示双击,3表示三击);
对于鼠标滚轮事件,Event.detail是滚轮正向滚动的距离,负值就是负向滚动的距离,返回值总是3的倍数。
实例方法
Event.preventDefault()
Event.stopPropagation()
Event.stopImmediatePropagation()
Event.composedPath()
Event.preventDefault方法取消浏览器对当前事件的默认行为。
stopPropagation方法阻止事件在 DOM 中继续传播,防止再触发定义在别的节点上的监听函数,但是不包括在当前节点上其他的事件监听函数。
Event.stopImmediatePropagation方法阻止同一个事件的其他监听函数被调用,不管监听函数定义在当前节点还是其他节点。
Event.composedPath()返回一个数组,成员是事件的最底层节点和依次冒泡经过的所有上层节点。
// HTML 代码如下
// <div>
// <p>Hello</p>
// </div>
var div = document.querySelector('div');
var p = document.querySelector('p');
div.addEventListener('click', function (e) {
console.log(e.composedPath());
}, false);
// [p, div, body, html, document, Window]
4. 鼠标事件
鼠标事件种类
// 鼠标事件指与鼠标相关的事件,继承了MouseEvent接口。具体的事件主要有以下一些。
click:按下鼠标(通常是按下主按钮)时触发。
dblclick:在同一个元素上双击鼠标时触发。
mousedown:按下鼠标键时触发。
mouseup:释放按下的鼠标键时触发。
mousemove:当鼠标在一个节点内部移动时触发。当鼠标持续移动时,该事件会连续触发。为了避免性能问题,建议对该事件的监听函数做一些限定,比如限定一段时间内只能运行一次。
mouseenter:鼠标进入一个节点时触发,进入子节点不会触发这个事件。
mouseover:鼠标进入一个节点时触发,进入子节点会再一次触发这个事件。
mouseout:鼠标离开一个节点时触发,离开父节点也会触发这个事件。
mouseleave:鼠标离开一个节点时触发,离开父节点不会触发这个事件。
contextmenu:按下鼠标右键时(上下文菜单出现前)触发,或者按下“上下文菜单键”时触发。
wheel:滚动鼠标的滚轮时触发,该事件继承的是WheelEvent接口。
MouseEvent 接口概述
- MouseEvent接口代表了鼠标相关的事件,单击(click)、双击(dblclick)、松开鼠标键(mouseup)、按下鼠标键(mousedown)等动作,所产生的事件对象都是MouseEvent实例。此外,滚轮事件和拖拉事件也是MouseEvent实例。
// 浏览器原生提供一个MouseEvent构造函数,用于新建一个MouseEvent实例。
var event = new MouseEvent(type, options);
// 第一个参数是字符串,表示事件名称;第二个参数是一个事件配置对象,该参数可选。
// 除了Event接口的实例配置属性,该对象可以配置以下属性,所有属性都是可选的。
screenX:数值,鼠标相对于屏幕的水平位置(单位像素),默认值为0,设置该属性不会移动鼠标。
screenY:数值,鼠标相对于屏幕的垂直位置(单位像素),其他与screenX相同。
clientX:数值,鼠标相对于程序窗口的水平位置(单位像素),默认值为0,设置该属性不会移动鼠标。
clientY:数值,鼠标相对于程序窗口的垂直位置(单位像素),其他与clientX相同。
ctrlKey:布尔值,是否同时按下了 Ctrl 键,默认值为false。
shiftKey:布尔值,是否同时按下了 Shift 键,默认值为false。
altKey:布尔值,是否同时按下 Alt 键,默认值为false。
metaKey:布尔值,是否同时按下 Meta 键,默认值为false。
button:数值,表示按下了哪一个鼠标按键,默认值为0,表示按下主键(通常是鼠标的左键)或者当前事件没有定义这个属性;1表示按下辅助键(通常是鼠标的中间键),2表示按下次要键(通常是鼠标的右键)。
buttons:数值,表示按下了鼠标的哪些键,是一个三个比特位的二进制值,默认为0(没有按下任何键)。1(二进制001)表示按下主键(通常是左键),2(二进制010)表示按下次要键(通常是右键),4(二进制100)表示按下辅助键(通常是中间键)。因此,如果返回3(二进制011)就表示同时按下了左键和右键。
relatedTarget:节点对象,表示事件的相关节点,默认为null。mouseenter和mouseover事件时,表示鼠标刚刚离开的那个元素节点;mouseout和mouseleave事件时,表示鼠标正在进入的那个元素节点。
function simulateClick() {
var event = new MouseEvent('click', {
'bubbles': true,
'cancelable': true
});
var cb = document.getElementById('checkbox');
cb.dispatchEvent(event);
}
MouseEvent 接口的实例属性
MouseEvent.altKey,MouseEvent.ctrlKey,MouseEvent.metaKey,MouseEvent.shiftKey
MouseEvent.button,MouseEvent.buttons
MouseEvent.clientX,MouseEvent.clientY
MouseEvent.movementX,MouseEvent.movementY
MouseEvent.screenX,MouseEvent.screenY
MouseEvent.offsetX,MouseEvent.offsetY
MouseEvent.pageX,MouseEvent.pageY
MouseEvent.relatedTarget
MouseEvent.altKey、MouseEvent.ctrlKey、MouseEvent.metaKey、MouseEvent.shiftKey
这四个属性都返回一个布尔值,表示事件发生时,是否按下对应的键。它们都是只读属性。
altKey属性:Alt 键
ctrlKey属性:Ctrl 键
metaKey属性:Meta 键(Mac 键盘是一个四瓣的小花,Windows 键盘是 Windows 键)
shiftKey属性:Shift 键
MouseEvent.button属性返回一个数值,表示事件发生时按下了鼠标的哪个键。该属性只读。
0:按下主键(通常是左键),或者该事件没有初始化这个属性(比如mousemove事件)。
1:按下辅助键(通常是中键或者滚轮键)。
2:按下次键(通常是右键)。
MouseEvent.buttons属性返回一个三个比特位的值,表示同时按下了哪些键。它用来处理同时按下多个鼠标键的情况。该属性只读。
1:二进制为001(十进制的1),表示按下左键。
2:二进制为010(十进制的2),表示按下右键。
4:二进制为100(十进制的4),表示按下中键或滚轮键。
MouseEvent.clientX属性返回鼠标位置相对于浏览器窗口左上角的水平坐标(单位像素)
MouseEvent.clientY属性返回垂直坐标。这两个属性都是只读属性。
MouseEvent.movementX属性返回当前位置与上一个mousemove事件之间的水平距离(单位像素)。
数值上,它等于下面的计算公式。
currentEvent.movementX = currentEvent.screenX - previousEvent.screenX
MouseEvent.screenX属性返回鼠标位置相对于屏幕左上角的水平坐标(单位像素),MouseEvent.screenY属性返回垂直坐标。
这两个属性都是只读属性。
MouseEvent.offsetX属性返回鼠标位置与目标节点左侧的padding边缘的水平距离(单位像素),MouseEvent.offsetY属性返回与目标节点上方的padding边缘的垂直距离。
这两个属性都是只读属性。
MouseEvent.pageX属性返回鼠标位置与文档左侧边缘的距离(单位像素),MouseEvent.pageY属性返回与文档上侧边缘的距离(单位像素)。
它们的返回值都包括文档不可见的部分。这两个属性都是只读。
MouseEvent.relatedTarget属性返回事件的相关节点。对于那些没有相关节点的事件,该属性返回null。
该属性只读。
MouseEvent 接口的实例方法
MouseEvent.getModifierState方法返回一个布尔值,表示有没有按下特定的功能键。
它的参数是一个表示功能键的字符串。
document.addEventListener('click', function (e) {
console.log(e.getModifierState('CapsLock'));
}, false);
WheelEvent 接口
- WheelEvent 接口继承了 MouseEvent 实例,代表鼠标滚轮事件的实例对象。目前,鼠标滚轮相关的事件只有一个wheel事件,用户滚动鼠标的滚轮,就生成这个事件的实例。
var wheelEvent = new WheelEvent(type, options);
第一个是字符串,表示事件类型,对于滚轮事件来说,这个值目前只能是wheel。
第二个参数是事件的配置对象。该对象的属性除了Event、UIEvent的配置属性以外
还可以接受以下几个属性,所有属性都是可选的。
deltaX:数值,表示滚轮的水平滚动量,默认值是 0.0。
deltaY:数值,表示滚轮的垂直滚动量,默认值是 0.0。
deltaZ:数值,表示滚轮的 Z 轴滚动量,默认值是 0.0。
deltaMode:数值,表示相关的滚动事件的单位,适用于上面三个属性。0表示滚动单位为像素,1表示单位为行,2表示单位为页,默认为0。
// 实例属性
WheelEvent.deltaX:数值,表示滚轮的水平滚动量。
WheelEvent.deltaY:数值,表示滚轮的垂直滚动量。
WheelEvent.deltaZ:数值,表示滚轮的 Z 轴滚动量。
WheelEvent.deltaMode:数值,表示上面三个属性的单位,0是像素,1是
5. 键盘事件
键盘事件种类
keydown:按下键盘时触发。
keypress:按下有值的键时触发,即按下 Ctrl、Alt、Shift、Meta 这样无值的键,这个事件不会触发。对于有值的键,按下时先触发keydown事件,再触发这个事件。
keyup:松开键盘时触发该事件。
如果用户一直按键不松开,就会连续触发键盘事件,触发的顺序如下。
keydown
keypress
keydown
keypress
...(重复以上过程)
keyup
KeyboardEvent 接口概述
new KeyboardEvent(type, options)
key:字符串,当前按下的键,默认为空字符串。
code:字符串,表示当前按下的键的字符串形式,默认为空字符串。
location:整数,当前按下的键的位置,默认为0。
ctrlKey:布尔值,是否按下 Ctrl 键,默认为false。
shiftKey:布尔值,是否按下 Shift 键,默认为false。
altKey:布尔值,是否按下 Alt 键,默认为false。
metaKey:布尔值,是否按下 Meta 键,默认为false。
repeat:布尔值,是否重复按键,默认为false。
KeyboardEvent 的实例属性
KeyboardEvent.altKey:是否按下 Alt 键
KeyboardEvent.ctrlKey:是否按下 Ctrl 键
KeyboardEvent.metaKey:是否按下 meta 键(Mac 系统是一个四瓣的小花,Windows 系统是 windows 键)
KeyboardEvent.shiftKey:是否按下 Shift 键
KeyboardEvent.code属性返回一个字符串,表示当前按下的键的字符串形式。该属性只读。
数字键0 - 9:返回digital0 - digital9
字母键A - z:返回KeyA - KeyZ
功能键F1 - F12:返回 F1 - F12
方向键:返回ArrowDown、ArrowUp、ArrowLeft、ArrowRight
Alt 键:返回AltLeft或AltRight
Shift 键:返回ShiftLeft或ShiftRight
Ctrl 键:返回ControlLeft或ControlRight
KeyboardEvent.key
比如 Backspace,Tab,Enter,Shift,Control,Alt,CapsLock,Esc,Spacebar,PageUp,PageDown,End,Home,Left,Right,Up,Down,PrintScreen,Insert,Del,Win,F1~F12,NumLock,Scroll 等
KeyboardEvent.location
0:处在键盘的主区域,或者无法判断处于哪一个区域。
1:处在键盘的左侧,只适用那些有两个位置的键(比如 Ctrl 和 Shift 键)。
2:处在键盘的右侧,只适用那些有两个位置的键(比如 Ctrl 和 Shift 键)。
3:处在数字小键盘。
KeyboardEvent.repeat
KeyboardEvent.repeat返回一个布尔值,代表该键是否被按着不放,以便判断是否重复这个键,即浏览器会持续触发keydown和keypress事件,直到用户松开手为止。
KeyboardEvent 的实例方法
KeyboardEvent.getModifierState()方法返回一个布尔值,表示是否按下或激活指定的功能键。它的常用参数如下。
Alt:Alt 键
CapsLock:大写锁定键
Control:Ctrl 键
Meta:Meta 键
NumLock:数字键盘开关键
Shift:Shift 键
6. 进度事件
进度事件的种类
- 进度事件用来描述资源加载的进度,主要由 AJAX 请求、、