浏览器与 Web API / 系统课时
阻止默认行为
阻止默认行为
浏览器会为链接跳转、表单提交、复选框切换等事件执行默认动作。本课用 preventDefault() 精确取消这些动作,并通过 cancelable 与 defaultPrevented 判断事件是否允许取消、取消是否真正生效。
学习目标
- 会在事件监听器中调用
preventDefault()阻止默认动作 - 能区分默认行为、事件传播与监听器执行
- 会使用
cancelable和defaultPrevented验证取消结果
默认行为不是事件传播
事件触发后,浏览器通常先完成捕获、目标和冒泡阶段,再决定是否执行默认动作。例如,点击链接会产生 click 事件,事件传播结束后浏览器才进行跳转。
event.preventDefault() 只阻止默认动作,不会让事件停止冒泡。若还要阻止事件继续传播,需要另行调用 stopPropagation();两者解决的是不同问题,不能互相替代。
使用 preventDefault
下面的页面同时演示链接点击、表单提交和一个不可取消的自定义事件。代码会先检查 cancelable,再决定是否调用 preventDefault()。
html
<!doctype html>
<html lang='zh-CN'>
<head>
<meta charset='UTF-8'>
<title>preventDefault 示例</title>
</head>
<body>
<a id='docs' href='https://example.com'>打开文档</a>
<form id='searchForm'>
<input name='keyword' value='DOM'>
<button type='submit'>搜索</button>
</form>
<script>
const link = document.querySelector('#docs');
const form = document.querySelector('#searchForm');
link.addEventListener('click', (event) => {
// 只在事件允许取消时阻止链接跳转
if (event.cancelable) {
event.preventDefault();
}
console.log(`链接:${event.cancelable}, ${event.defaultPrevented}`);
});
form.addEventListener('submit', (event) => {
// 接管提交后,页面不会刷新或跳转
event.preventDefault();
const data = new FormData(form);
console.log(`表单:${data.get('keyword')}, ${event.defaultPrevented}`);
});
document.addEventListener('locked', (event) => {
event.preventDefault();
console.log(`自定义事件:${event.cancelable}, ${event.defaultPrevented}`);
});
document.dispatchEvent(new Event('locked', { cancelable: false }));
</script>
</body>
</html>预期结果
text
页面加载后:
自定义事件:false, false
点击“打开文档”后,页面不会跳转:
链接:true, true
点击“搜索”后,页面不会刷新或提交:
表单:DOM, truedefaultPrevented 在成功调用 preventDefault() 后变为 true。不可取消事件即使调用该方法,该值仍然是 false。
cancelable 与被动监听器
cancelable 表示事件规范是否允许取消。常见的链接点击和表单提交事件通常可取消,但某些自定义事件或浏览器生成的事件可能不可取消,因此公共组件中先检查它更稳妥。
使用 { passive: true } 注册的监听器承诺不会阻止默认行为,常用于提升滚动事件性能。在被动监听器中调用 preventDefault() 不会按预期生效,浏览器还可能输出警告。确实需要拦截滚动时,应明确使用 { passive: false },并谨慎评估交互和性能影响。
常见边界
- 取消表单提交后,校验、请求发送和成功提示都需要由代码自行完成。
- 取消链接跳转时,应保留可访问性与键盘操作,不要只处理鼠标事件。
return false不是原生addEventListener()的取消方式,应显式调用preventDefault()。- 业务代码可读取
defaultPrevented,避免多个监听器重复执行同一替代逻辑。
按自己的节奏,确认真正理解。