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() 方法將刪除指定的事件監聽器函數。參數 type 和 useCapture 必須與調用 addEventListener() 方法的相應參數一樣。如果沒有找到與指定的參數匹配的事件監聽器，該方法則什么都不做。

如果一個事件監聽器函數被該方法刪除，那么當節點發生指定類型的事件時，就不再調用它。即使一個事件監聽器被同一節點上同類型事件注冊的另一個事件監聽器刪除，它也不會再被調用。

這個方法也被 Document 和 Window 對象定義，并且工作方式相似。

瀏覽器支持

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

所有瀏覽器都完全支持它：

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