编辑这个页面须要登录或更高权限!

HTML DOM removeEventListener() 方法

HTML DOM Document对象

document.removeEventListener()删除附加在document.addEventListener()方法中的事件处理程序。

注意:要删除事件处理程序,用addEventListener()方法指定的函数必须是外部的“命名"函数,如下面的示例(myFunc)。

匿名函数,例如"document.removeEventListener("event",function(){ statement });" 不管用。

使用元素 .addEventListener()方法将事件处理程序附加到指定的元素。

使用元素 .removeEventListener()方法从指定的元素中删除事件处理程序。

语法:

document.removeEventListener(event, listener, useCapture)
// 将事件处理程序附加到文档
document.addEventListener("mousemove", myFunc);

// 从文档中删除事件处理程序
document.removeEventListener("mousemove", myFunc);
测试看看‹/›

浏览器兼容性

表中的数字指定了完全支持removeEventListener()方法的第一个浏览器版本:

方法
removeEventListener()1171.09

参数值

参数描述
event(必需)要删除的JavaScript事件的名称。使用事件时不使用"on"前缀,例如使用"click"代替"onclick"或"mousedown"代替"onmousedown"。
有关所有HTML DOM事件的列表,请参考我们完整的HTML DOM事件对象参考
listener(必需)要删除的JavaScript函数的名称。
useCapture(可选)布尔值,指定是在捕获阶段还是冒泡阶段中删除事件。默认为false。
可能的值:
  • true-在捕获阶段删除了事件处理程序

  • false-在冒泡阶段删除了事件处理程序

注意:如果事件处理程序已附加两次,一次附加捕获,一次附加冒泡,则必须分别将其分别移除。
您可以在我们的JavaScript事件传播教程中阅读有关事件传播的更多信息

技术细节

返回值:没有
DOM版本:DOM 2级

相关参考

JavaScript教程:事件监听器

JavaScript教程:事件传播

HTML DOM参考:document.addEventListener()

HTML DOM参考:element.removeEventListener()

HTML DOM Document对象