Landscape

# GlobalEventHandlers 接口

# 概述

指定事件的回调函数，推荐使用的方法是元素的addEventListener方法。

div.addEventListener('click', clickHandler, false);
1

除了之外，还有一种方法可以直接指定事件的回调函数。

div.onclick = clickHandler;
1

这个接口是由GlobalEventHandlers接口提供的。它的优点是使用比较方便，缺点是只能为每个事件指定一个回调函数，并且无法指定事件触发的阶段（捕获阶段还是冒泡阶段）。

HTMLElement、Document和Window都继承了这个接口，也就是说，各种 HTML 元素、document对象、window对象上面都可以使用GlobalEventHandlers接口提供的属性。下面就列出这个接口提供的主要的事件属性。

# GlobalEventHandlers.onabort

某个对象的abort事件（停止加载）发生时，就会调用onabort属性指定的回调函数。

各种元素的停止加载事件，到底如何触发，目前并没有统一的规定。因此实际上，这个属性现在一般只用在<img>元素上面。

// HTML 代码如下
// <img src="example.jpg" id="img">
var img = document.getElementById('img');
img.onabort = function () {
  console.log('image load aborted.');
}
1
2
3
4
5
6

# GlobalEventHandlers.onerror

error事件发生时，就会调用onerror属性指定的回调函数。

error事件分成两种。

一种是 JavaScript 的运行时错误，这会传到window对象，导致window.onerror()。

window.onerror = function (message, source, lineno, colno, error) {
  // ...
}
1
2
3

window.onerror的处理函数共接受五个参数，含义如下。

  • message：错误信息字符串
  • source：报错脚本的 URL
  • lineno：报错的行号，是一个整数
  • colno：报错的列号，是一个整数
  • error： 错误对象

另一种是资源加载错误，比如<img>或<script>加载的资源出现加载错误。这时，Error 对象会传到对应的元素，导致该元素的onerror属性开始执行。

element.onerror = function (event) {
  // ...
}
1
2
3

注意，一般来说，资源的加载错误不会触发window.onerror。

# GlobalEventHandlers.onload、GlobalEventHandlers.onloadstart

元素完成加载时，会触发load事件，执行onload()。它的典型使用场景是window对象和<img>元素。对于window对象来说，只有页面的所有资源加载完成（包括图片、脚本、样式表、字体等所有外部资源），才会触发load事件。

对于<img>和<video>等元素，加载开始时还会触发loadstart事件，导致执行onloadstart。

# GlobalEventHandlers.onfocus，GlobalEventHandlers.onblur

当前元素获得焦点时，会触发element.onfocus；失去焦点时，会触发element.onblur。

element.onfocus = function () {
  console.log("onfocus event detected!");
};
element.onblur = function () {
  console.log("onblur event detected!");
};
1
2
3
4
5
6

注意，如果不是可以接受用户输入的元素，要触发onfocus，该元素必须有tabindex属性。

# GlobalEventHandlers.onscroll

页面或元素滚动时，会触发scroll事件，导致执行onscroll()。

# GlobalEventHandlers.oncontextmenu，GlobalEventHandlers.onshow

用户在页面上按下鼠标的右键，会触发contextmenu事件，导致执行oncontextmenu()。如果该属性执行后返回false，就等于禁止了右键菜单。document.oncontextmenu与window.oncontextmenu效果一样。

document.oncontextmenu = function () {
  return false;
};
1
2
3

上面代码中，oncontextmenu属性执行后返回false，右键菜单就不会出现。

元素的右键菜单显示时，会触发该元素的onshow监听函数。

# 其他的事件属性

# 1. 鼠标的事件属性

  • onclick
  • ondblclick
  • onmousedown
  • onmouseenter
  • onmouseleave
  • onmousemove
  • onmouseout
  • onmouseover
  • onmouseup
  • onwheel

# 2. 键盘的事件属性

  • onkeydown
  • onkeypress
  • onkeyup

# 3. 焦点的事件属性

  • onblur
  • onfocus

# 4. 表单的事件属性

  • oninput
  • onchange
  • onsubmit
  • onreset
  • oninvalid
  • onselect

# 5. 触摸的事件属性

  • ontouchcancel
  • ontouchend
  • ontouchmove
  • ontouchstart

拖动的事件属性分成两类：一类与被拖动元素相关，另一类与接收被拖动元素的容器元素相关。

# 6. 被拖动元素的事件属性

  • ondragstart：拖动开始
  • ondrag：拖动过程中，每隔几百毫秒触发一次
  • ondragend：拖动结束

# 7. 接收被拖动元素的容器元素的事件属性

  • ondragenter：被拖动元素进入容器元素。
  • ondragleave：被拖动元素离开容器元素。
  • ondragover：被拖动元素在容器元素上方，每隔几百毫秒触发一次。
  • ondrop：松开鼠标后，被拖动元素放入容器元素。

# 8. <dialog>对话框元素的事件属性

  • oncancel
  • onclose