Latest web development tutorials

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()

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