浏览器与 Web API / 系统课时
使用 addEventListener 监听事件
使用 addEventListener 监听事件
本课解决“怎样为元素稳定注册事件处理逻辑”这一问题。你将掌握事件类型、回调函数、重复注册判定与监听器移除,并通过一个可运行示例验证不同监听器的实际执行次数。
学习目标
- 使用
addEventListener为元素注册一个或多个事件监听器 - 解释事件类型、回调引用与
capture对重复注册的影响 - 使用
removeEventListener正确移除已注册的监听器
addEventListener 的注册规则
addEventListener(type, callback, options) 把一个回调登记到事件目标上。type 是不带 on 前缀的事件名,例如 click、input;callback 是事件发生时执行的函数;options 可以控制捕获阶段、只执行一次或是否声明为被动监听器。
同一个元素可以监听同一种事件的多个回调。浏览器只会忽略“事件类型相同、回调对象相同、capture 值相同”的重复注册。两个内容完全一样的匿名函数仍是不同函数对象,因此会分别执行。
完整示例:注册、触发与移除
下面的页面同时注册普通监听器、两个匿名监听器和一个 once 监听器。普通监听器被重复注册一次,但浏览器只保留一份。
html
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>事件监听示例</title>
</head>
<body>
<button id="trigger">触发事件</button>
<button id="remove">移除普通监听器</button>
<pre id="output">等待操作</pre>
<script>
const triggerButton = document.querySelector('#trigger');
const removeButton = document.querySelector('#remove');
const output = document.querySelector('#output');
const records = [];
function log(message) {
records.push(message);
output.textContent = records.join('\n');
}
function handleClick() {
log('普通监听器');
}
triggerButton.addEventListener('click', handleClick);
// 同一回调与同一捕获设置再次注册,不会新增一份监听器
triggerButton.addEventListener('click', handleClick);
triggerButton.addEventListener('click', () => log('匿名监听器 A'));
triggerButton.addEventListener('click', () => log('匿名监听器 B'));
triggerButton.addEventListener('click', () => log('once 监听器'), {
once: true
});
removeButton.addEventListener('click', () => {
// 移除时必须继续使用原来的函数引用
triggerButton.removeEventListener('click', handleClick);
log('普通监听器已移除');
});
</script>
</body>
</html>预期结果。第一次点击“触发事件”后,页面显示:
text
普通监听器
匿名监听器 A
匿名监听器 B
once 监听器再点击“移除普通监听器”,然后第二次点击“触发事件”,后续只会新增以下记录:
text
普通监听器已移除
匿名监听器 A
匿名监听器 B监听选项与常见边界
{ once: true } 会在回调首次执行后自动移除监听器,适合一次性初始化。capture: true 表示在捕获阶段处理事件;省略时默认为 false,即通常在冒泡阶段执行。重复注册和移除监听器时,capture 是否一致是关键条件。
不要直接用临时匿名函数执行移除操作。removeEventListener('click', () => {}) 创建的是新函数,无法匹配之前注册的匿名回调。需要后续移除时,应先把函数保存到变量或声明为具名函数。
按自己的节奏,确认真正理解。