一、事件
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.eventPhaseEvent.cancelable,Event.cancelBubble,event.defaultPreventedEvent.currentTarget,Event.targetEvent.typeEvent.timeStampEvent.isTrustedEvent.detailEvent.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.shiftKeyMouseEvent.button,MouseEvent.buttonsMouseEvent.clientX,MouseEvent.clientYMouseEvent.movementX,MouseEvent.movementYMouseEvent.screenX,MouseEvent.screenYMouseEvent.offsetX,MouseEvent.offsetYMouseEvent.pageX,MouseEvent.pageYMouseEvent.relatedTargetMouseEvent.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.screenXMouseEvent.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:松开键盘时触发该事件。如果用户一直按键不松开,就会连续触发键盘事件,触发的顺序如下。keydownkeypresskeydownkeypress...(重复以上过程)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、ArrowRightAlt 键:返回AltLeft或AltRightShift 键:返回ShiftLeft或ShiftRightCtrl 键:返回ControlLeft或ControlRightKeyboardEvent.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.location0:处在键盘的主区域,或者无法判断处于哪一个区域。1:处在键盘的左侧,只适用那些有两个位置的键(比如 Ctrl 和 Shift 键)。2:处在键盘的右侧,只适用那些有两个位置的键(比如 Ctrl 和 Shift 键)。3:处在数字小键盘。KeyboardEvent.repeatKeyboardEvent.repeat返回一个布尔值,代表该键是否被按着不放,以便判断是否重复这个键,即浏览器会持续触发keydown和keypress事件,直到用户松开手为止。
KeyboardEvent 的实例方法
KeyboardEvent.getModifierState()方法返回一个布尔值,表示是否按下或激活指定的功能键。它的常用参数如下。Alt:Alt 键CapsLock:大写锁定键Control:Ctrl 键Meta:Meta 键NumLock:数字键盘开关键Shift:Shift 键
6. 进度事件
进度事件的种类
- 进度事件用来描述资源加载的进度,主要由 AJAX 请求、
、
