浏览器与 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, true

defaultPrevented 在成功调用 preventDefault() 后变为 true。不可取消事件即使调用该方法,该值仍然是 false。

cancelable 与被动监听器

cancelable 表示事件规范是否允许取消。常见的链接点击和表单提交事件通常可取消,但某些自定义事件或浏览器生成的事件可能不可取消,因此公共组件中先检查它更稳妥。

使用 { passive: true } 注册的监听器承诺不会阻止默认行为,常用于提升滚动事件性能。在被动监听器中调用 preventDefault() 不会按预期生效,浏览器还可能输出警告。确实需要拦截滚动时,应明确使用 { passive: false },并谨慎评估交互和性能影响。

常见边界

  • 取消表单提交后,校验、请求发送和成功提示都需要由代码自行完成。
  • 取消链接跳转时,应保留可访问性与键盘操作,不要只处理鼠标事件。
  • return false 不是原生 addEventListener() 的取消方式,应显式调用 preventDefault()。
  • 业务代码可读取 defaultPrevented,避免多个监听器重复执行同一替代逻辑。
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

阻止默认行为

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通