addEventListener()
方法是 JavaScript 中用于处理指定元素的指定事件的函数。它有三个参数:
-
type
(必需):一个字符串,指定要监听的事件名。 -
listener
(必需):一个实现了EventListener
接口的对象,或者是一个函数,当指定的事件被触发时,该函数将被调用。 -
options
(可选):一个指定有关监听器属性的布尔值或对象的选项。如果是布尔值,它表示useCapture
参数。如果是对象,则可能包含以下属性:-
capture
:布尔值,指定事件是否在捕获或冒泡阶段执行。默认为false
。 -
once
:布尔值,指定监听器是否在触发一次后被自动移除。默认为false
。 -
passive
:布尔值,当为true
时,表示listener
将不会调用preventDefault()
。默认为false
。
-
下面是 addEventListener()
方法的详细代码示例:
// 获取元素
var btn = document.getElementById('myButton');
// 定义事件处理函数
function handleClick(event) {
alert('Button clicked!');
}
// 添加事件监听器
btn.addEventListener('click', handleClick);
在这个例子中,我们获取了一个具有 ID myButton
的元素,并定义了一个名为 handleClick
的函数,该函数在点击事件触发时会显示一个警告框。然后,我们使用 addEventListener()
方法将 handleClick
函数添加为 btn
元素的点击事件监听器。
如果你想要使用 options
参数,可以这样做:
// 添加事件监听器,只在捕获阶段触发,并且只触发一次
btn.addEventListener('click', handleClick, {
capture: true,
once: true
});
在这个例子中,handleClick
函数只会在点击事件的捕获阶段触发,并且只触发一次。之后,该监听器将被自动移除。