Latest web development tutorials

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對象