HTML DOM removeEventListener() 方法

HTML DOM Element 对象

element.removeEventListener()方法将删除已与element.addEventListener()方法关联的事件处理程序。

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

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

使用document.addEventListener()方法将事件处理程序附加到文档。

使用document.removeEventListener()方法从文档中删除事件处理程序。

语法:

element.removeEventListener(event, listener, useCapture)
var box = document.getElementById("para");

//将事件处理程序附加到id="para "的P元素上
box.addEventListener("mousemove", myFunc);

// 从具有id =“ para”的P元素中删除事件处理程序
box.removeEventListener("mousemove", myFunc);
测试看看‹/›

浏览器兼容性

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

Method
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参考:element .addEventListener()

HTML DOM参考:document.addEventListener()

HTML DOM参考:document.removeEventListener()

HTML DOM Element 对象