Latest web development tutorials

HTML DOM removeEventListener() 方法

元素對象參考手冊 元素對象

實例

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

// 向<div> 元素添加事件句柄
document.getElementById("myDIV").addEventListener("mousemove", myFunction);

// 移除<div> 元素的事件句柄
document.getElementById("myDIV").removeEventListener("mousemove", myFunction);

嘗試一下»

定義和用法

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

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

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

瀏覽器支持

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

方法
removeEventListener() 1.0 9.0 1.0 1.0 7.0

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

語法

element .removeEventListener( event , function , useCapture )

參數值

Parameter Description
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() 方法實現。

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

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

嘗試一下»

相關頁面

JavaScript教程: HTML DOM EventListener

JavaScript參考手冊: document.removeEventListener()

元素對象參考手冊 元素對象