DOM 事件監聽器

addEventListener() 方法

實例

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<body>

<p>该实例使用 addEventListener() 方法在按钮中添加点击事件。 </p>
<button id="myBtn">点我</button>
<p id="demo"></p>
<script>
document.getElementById("myBtn").addEventListener("click", displayDate);
function displayDate() {
    document.getElementById("demo").innerHTML = Date();
}
</script>

</body>
</html>

執行實例»

點擊"執行實例"按鈕查看線上實例

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

addEventListener() 方法新增的事件句柄不會覆寫已存在的事件句柄。

你可以為一個元素新增多個事件句柄。

你可以在同一個元素中加入多個同類型的事件句柄，如：兩個 "click" 事件。

你可以為任何 DOM 物件新增事件監聽，而不僅僅是 HTML 元素。如： window 物件。

addEventListener() 方法可以更簡單的控制事件（冒泡與捕獲）。

當你使用 addEventListener() 方法時, JavaScript 從 HTML 標記中分離開來，可讀性更強，在沒有控制HTML標記時也可以加入事件監聽。

你可以使用 removeEventListener() 方法來移除事件的監聽。

語法

element.addEventListener(event, function, useCapture);

#第一個參數是事件的型別(如"click" 或"mousedown").

第二個參數是事件觸發後呼叫的函數。

第三個參數是個布林值用來描述事件是冒泡還是捕獲。此參數是可選的。

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

向原始元素新增事件句柄

實例

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<body>

<p>该实例使用 addEventListener() 方法在按钮中添加点击事件。 </p>
<button id="myBtn">点我</button>
<script>
document.getElementById("myBtn").addEventListener("click", function(){
    alert("Hello World!");
});
</script>

</body>
</html>

執行實例»

點擊"運行實例" 按鈕檢視線上實例

你可以使用函數名，來引用外部函數:

實例

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<body>

<p>该实例使用 addEventListener() 方法在用户点击按钮时执行函数。</p>
<button id="myBtn">点我</button>
<script>
document.getElementById("myBtn").addEventListener("click", myFunction);
function myFunction() {
    alert ("Hello World!");
}
</script>

</body>
</html>

執行實例»

點擊"運行實例" 按鈕查看線上實例

#在同一個元素中新增多個事件句柄

addEventListener()方法允許向同個元素新增多個事件，且不會覆寫已存在的事件：

實例

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<body>

<p>该实例使用 addEventListener() 方法向同个按钮中添加两个点击事件。</p>
<button id="myBtn">点我</button>
<script>
var x = document.getElementById("myBtn");
x.addEventListener("click", myFunction);
x.addEventListener("click", someOtherFunction);
function myFunction() {
    alert ("Hello World!")
}
function someOtherFunction() {
    alert ("函数已执行!")
}
</script>

</body>
</html>

##執行實例»點擊"運行實例" 按鈕查看線上實例

你可以向同個元素添加不同類型的事件：

實例

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<body>

<p>实例使用 addEventListener() 方法在同一个按钮中添加多个事件。</p>
<button id="myBtn">点我</button>
<p id="demo"></p>
<script>
var x = document.getElementById("myBtn");
x.addEventListener("mouseover", myFunction);
x.addEventListener("click", mySecondFunction);
x.addEventListener("mouseout", myThirdFunction);
function myFunction() {
    document.getElementById("demo").innerHTML += "Moused over!<br>"
}
function mySecondFunction() {
    document.getElementById("demo").innerHTML += "Clicked!<br>"
}
function myThirdFunction() {
    document.getElementById("demo").innerHTML += "Moused out!<br>"
}
</script>

</body>
</html>

執行實例»點擊"執行實例"按鈕查看線上實例

向Window 物件新增事件句柄

addEventListener() 方法允許你在HTML DOM 物件新增事件監聽， HTML DOM 物件如： HTML 元素, HTML 文件, window 物件。或其他支出的事件物件如: xmlHttpRequest 物件。

實例

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<body>

<p>实例在window对象中使用 addEventListener() 方法。</p>
<p>尝试重置浏览器的窗口触发 "resize" 事件句柄。</p>
<p id="demo"></p>
<script>
window.addEventListener("resize", function(){
    document.getElementById("demo").innerHTML = Math.random();
});
</script>

</body>
</html>

運行實例»點擊"運行實例" 按鈕查看線上實例

傳遞參數

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

實例

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<body>

<p>实例演示了在使用 addEventListener() 方法时如何传递参数。</p>
<p>点击按钮执行计算。</p>
<button id="myBtn">点我</button>
<p id="demo"></p>
<script>
var p1 = 5;
var p2 = 7;
document.getElementById("myBtn").addEventListener("click", function() {
    myFunction(p1, p2);
});
function myFunction(a, b) {
    var result = a * b;
    document.getElementById("demo").innerHTML = result;
}
</script>

</body>
</html>

運行實例»點擊"運行實例"按鈕查看線上實例

事件冒泡或事件捕捉？

事件傳遞有兩種方式：冒泡與捕獲。

事件傳遞定義了元素事件觸發的順序。如果你將 <p> 元素插入 <div> 元素中，使用者點擊 <p> 元素, 哪個元素的 "click" 事件先被觸發呢？

在冒泡中，內部元素的事件會先被觸發，然後再觸發外部元素，即： <p> 元素的點擊事件先觸發，然後觸發 <div> 元素的點擊事件。

在擷取中，外部元素的事件會先被觸發，然後才會觸發內部元素的事件，也就是： <div> 元素的點擊事件先觸發，然後再觸發 <p> 元素的點擊事件。

addEventListener() 方法可以指定"useCapture" 參數來設定傳遞類型：

addEventListener(event, function, useCapture);

預設值為false, 即冒泡傳遞，當值為true 時, 事件使用捕獲傳遞。

實例

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
<style>
div {
    background-color: coral;
    border: 1px solid;
    padding: 50px;
}
</style>
</head>
<body>

<p>实例演示了在添加不同事件监听时，冒泡与捕获的不同。</p>
<div id="myDiv">
	<p id="myP">点击段落，我是冒泡。</p>
</div><br>
<div id="myDiv2">
	<p id="myP2">点击段落，我是捕获。 </p>
</div>
<script>
document.getElementById("myP").addEventListener("click", function() {
    alert("你点击了 P 元素!");
}, false);
document.getElementById("myDiv").addEventListener("click", function() {
    alert(" 你点击了 DIV 元素 !");
}, false);
document.getElementById("myP2").addEventListener("click", function() {
    alert("你点击了 P2 元素!");
}, true);
document.getElementById("myDiv2").addEventListener("click", function() {
    alert("你点击了 DIV2 元素 !");
}, true);
</script>

</body>
</html>

運行實例»

點擊"運行實例" 按鈕查看線上實例

removeEventListener() 方法

removeEventListener() 方法移除由addEventListener() 方法新增的事件句柄:

實例

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<head>
<style>
#myDIV {
    background-color: coral;
    border: 1px solid;
    padding: 50px;
    color: white;
}
</style>
</head>
<body>

<div id="myDIV"> div 元素添加了 onmousemove 事件句柄，鼠标在桔红色的框内移动时会显示随机数。
  <p>点击按钮移除 DIV 的事件句柄。</p>
  <button onclick="removeHandler()" id="myBtn">点我</button>
</div>
<p id="demo"></p>
<script>
document.getElementById("myDIV").addEventListener("mousemove", myFunction);
function myFunction() {
    document.getElementById("demo").innerHTML = Math.random();
}
function removeHandler() {
    document.getElementById("myDIV").removeEventListener("mousemove", myFunction);
}
</script>

</body>
</html>

運行實例»

點擊"運行實例" 按鈕查看線上實例

瀏覽器支援

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

addEventListener()1.09.07.07.0

方法
				##1.0	1.0
	removeEventListener()	1.0	9.0	#1.0	1.0

注意：

IE 8 及更早IE 版本，Opera 7.0及其更早版本不支援addEventListener() 和removeEventListener() 方法。但是，對於這類瀏覽器版本可以使用 detachEvent() 方法移除事件句柄:

element.attachEvent(event, function);

element.detachEvent(event, function);

實例

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>php中文网(php.cn)</title>
</head>
<body>

<p> Internet Explorer 8 及更早IE版本不支持addEventListener() 方法。</p>
<p>该实例演示了所有浏览器兼容的解决方法。</p>
<button id="myBtn">点我</button>
<script>
var x = document.getElementById("myBtn");
if (x.addEventListener) {
    x.addEventListener("click", myFunction);
} else if (x.attachEvent) {
    x.attachEvent("onclick", myFunction);
}
function myFunction() {
    alert("Hello World!");
}
</script>

</body>
</html>

#執行實例»

點擊"運行實例" 按鈕查看線上實例

HTML DOM 事件物件參考手冊

###所有HTML DOM 事件，可以查看我們完整的HTML DOM Event 對象參考手冊。 ###

← DOM 事件

DOM 元素 →

DOM 事件監聽器

addEventListener() 方法

實例

語法

向原始元素新增事件句柄

實例

實例

#在同一個元素中新增多個事件句柄

實例

事件冒泡或事件捕捉？

實例

removeEventListener() 方法

實例

瀏覽器支援

PHP中文網