HTML DOM Element removeEventListener() 方法

定义和用法

removeEventListener() 方法从元素中删除事件处理程序。

另请参阅:

元素方法:

addEventListener() 方法

removeEventListener() 方法

文档方法:

addEventListener() 方法

removeEventListener() 方法

教程:

HTML DOM EventListener

DOM 事件的完整列表

实例

从元素中移除 "mousemove" 事件:

myDIV.removeEventListener("mousemove", myFunction);

亲自试一试

语法

element.removeEventListener(type, listnener, useCapture)

参数

参数 描述
type

必需。要删除事件监听器的事件类型。

请勿使用 "on" 前缀。例如,使用 "click" 而不是 "onclick"。

如需完整的 HTML DOM 事件列表,请访问:HTML DOM 事件对象参考手册

listnener 必需。要删除的事件监听器函数。
useCapture

可选(默认为 false)。

  • true - 从捕获中删除处理程序
  • false - 从冒泡中删除处理程序

如果事件处理程序被追加了两次,一次是捕获,一次是冒泡,那么每个都必须单独删除。

返回值

无。

技术细节

removeEventListener() 方法将删除指定的事件监听器函数。参数 typeuseCapture 必须与调用 addEventListener() 方法的相应参数一样。如果没有找到与指定的参数匹配的事件监听器,该方法则什么都不做。

如果一个事件监听器函数被该方法删除,那么当节点发生指定类型的事件时,就不再调用它。即使一个事件监听器被同一节点上同类型事件注册的另一个事件监听器删除,它也不会再被调用。

这个方法也被 DocumentWindow 对象定义,并且工作方式相似。

浏览器支持

element.removeEventListener() 是 DOM Level 2 (2001) 特性。

所有浏览器都完全支持它:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 9-11 支持 支持 支持 支持