HTML DOM removeEventListener() 方法

Document 對象參考手冊 Document 對象

實例

移除由 addEventListener() 方法添加的 "mousemove" 事件：

// 在文檔中添加事件句柄
document.addEventListener("mousemove", myFunction);

// 移除文檔中的事件句柄
document.removeEventListener("mousemove", myFunction);

定義和使用

document.removeEventListener() 方法用於移除由 document.addEventListener() 方法添加的事件句柄。

注意: 如果要移除事件句柄，addEventListener() 的執行函數必須使用外部函數，如上實例所示 (myFunction)。

匿名函數，類似 "document.removeEventListener("event", function(){ myScript });" 該事件是無法移除的。

提示： 使用 element.addEventListener() 和 element.removeEventListener() 方法來添加或移除指定元素的事件句柄。

流覽器支持

表格中的數字表示支持該方法的第一個流覽器的版本號。

方法
removeEventListener() 1.0 9.0 1.0 1.0 7.0

注意： Internet Explorer 8 及更早IE版本不支持 removeEventListener() 方法，Opera 7.0 及 Opera 更早版本也不支持。 但是，對於這些不支持該函數的流覽器，你可以使用 detachEvent() 方法來移除由 attachEvent() 方法添加的事件句柄 (查看 "更多實例" 瞭解跨流覽器的解決方案)。

語法

document.removeEventListener(event, function, useCapture)

參數值

參數 描述
event 必須。要移除的事件名稱。

注意： 不要使用 "on" 首碼。 例如，使用 "click" ,而不是使用 "onclick"。

提示： 所有 HTML DOM 事件，可以查看我們完整的HTML DOM Event 對象參考手冊。
function 必須。指定要移除的函數。
useCapture 可選。布爾值，指定移除事件句柄的階段。

可能值：
  • true - 事件句柄在捕獲階段移除
  • false- 默認。事件句柄在冒泡階段移除
注意： 如果添加兩次事件句柄，一次在捕獲階段，一次在冒泡階段，你必須單獨移除該事件。

技術細節

DOM 版本: DOM Level 2 events
返回值: 沒有返回值
修改記錄: 在 Firefox 6 和 Opera 12.0 中 useCapture 參數是可選的。 （在 Chrome、IE 和 Safari 中一直都是可選的）。

更多實例

實例

如果流覽器不支持 removeEventListener() 方法，你可以使用 detachEvent() 方法實現。

該實例演示了跨流覽器的解決方法：

if (document.removeEventListener) {         // 所有流覽器，除了 IE 8 及更早IE版本
    document.removeEventListener("mousemove", myFunction);
} else if (document.detachEvent) {         // IE 8 及更早IE版本
    document.detachEvent("onmousemove", myFunction);
}


相關文章

JavaScript 教學: HTML DOM EventListener

JavaScript 參考手冊: element.removeEventListener()

Document 對象參考手冊 Document 對象