HTML DOM addEventListener() 方法

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

實例

為 <button> 元素添加點擊事件。 當用戶點擊按鈕時，在 id="demo" 的 <p> 元素上輸出 "Hello World" :

document.getElementById("myBtn").addEventListener("click", function(){
    document.getElementById("demo").innerHTML = "Hello World";
});

定義和用法

addEventListener() 方法用於向指定元素添加事件句柄。

提示： 使用 removeEventListener() 方法來移除 addEventListener() 方法添加的事件句柄。

流覽器支持

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

方法
addEventListener() 1.0 9.0 1.0 1.0 7.0

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

語法

element.addEventListener(event, function, useCapture)

參數值

參數 描述
event 必須。字串，指定事件名。

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

提示： 所有 HTML DOM 事件，可以查看我們完整的 HTML DOM Event 對象參考手冊。
function 必須。指定要事件觸發時執行的函數。

當事件對象會作為第一個參數傳入函數。 事件對象的類型取決於特定的事件。例如， "click" 事件屬於 MouseEvent(滑鼠事件) 對象。
useCapture 可選。布爾值，指定事件是否在捕獲或冒泡階段執行。

可能值:
  • true - 事件句柄在捕獲階段執行
  • false- false- 默認。事件句柄在冒泡階段執行

技術細節

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

更多實例

實例

您可以通過函數名來引用外部函數。

該實例演示了在用戶點擊 <button> 元素時如何執行函數:

document.getElementById("myBtn").addEventListener("click", myFunction);

function myFunction() {
    document.getElementById("demo").innerHTML = "Hello World";
}


實例

您可以在文檔中添加許多事件，添加的事件不會覆蓋已存在的事件。

該實例演示了如何在<button>元素中添加兩個點擊事件：

document.getElementById("myBtn").addEventListener("click", myFunction);
document.getElementById("myBtn").addEventListener("click", someOtherFunction);


實例

您可以在同一個元素中添加不同類型的事件。

該實例演示了如何在同一個 <button> 元素中添加多個事件：

document.getElementById("myBtn").addEventListener("mouseover", myFunction);
document.getElementById("myBtn").addEventListener("click", someOtherFunction);
document.getElementById("myBtn").addEventListener("mouseout", someOtherFunction);


實例

當傳遞參數值時，使用"匿名函數"調用帶參數的函數：

document.getElementById("myBtn").addEventListener("click", function() {
    myFunction(p1, p2);
});


實例

修改 <button> 元素的背景：

document.getElementById("myBtn").addEventListener("click", function(){
    this.style.backgroundColor = "red";
});


實例

使用可選參數 useCapture 來演示冒泡和捕獲階段的不同:

document.getElementById("myDiv").addEventListener("click", myFunction, true);


實例

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

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

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


實例

如果流覽器不支持 addEventListener() 方法, 你可以使用 attachEvent() 方法替代。

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

var x = document.getElementById("myBtn");
if (x.addEventListener) {                    //所有主流流覽器，除了 IE 8 及更早 IE版本
    x.addEventListener("click", myFunction);
} else if (x.attachEvent) {                  // IE 8 及更早 IE 版本
    x.attachEvent("onclick", myFunction);
}


相關頁面

JavaScript 教學: HTML DOM EventListener

JavaScript 參考手冊: document.addEventListener()

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