大网数据广告活动
Web 标准与前端开发

Event.cancelable

· 52CE 我爱测

Event 实例的只读属性 **`cancelable`** 表明该事件是否可以被取消,即事件是否可以像从未发生一样被阻止。

DOM

Event 实例的只读属性 cancelable 表明该事件是否可以被取消,即事件是否可以像从未发生一样被阻止。

如果事件不能被取消,则其 cancelable 属性的值为 false,且事件发生时无法在事件监听回调中停止事件。

大部分由用户与页面交互产生的原生浏览器事件都可以被取消。取消 Element/click_event、Document/wheel_event 或 Window/beforeunload_event 事件将分别阻止用户点击某些元素、滚动页面或跳离页面。

使用 JavaScript 代码创建的自定义事件,可以在初始化事件的时候声明该事件是否可以被取消。

要取消一个事件的默认行为,可以调用该事件的 event.preventDefault 方法。

对于同时处理多种事件的监听回调,可能需要先检查 cancelable 属性的值,再调用这些事件的 event.preventDefault 方法。

值

为一个Boolean。若事件可以被取消,其值为 true。

示例

例如,浏览器厂商提议 Document/wheel_event 事件只能在事件监听回调第一次执行时被取消,接下来的 wheel 事件都不能被取消。

function preventScrollWheel(event) {
  if (typeof event.cancelable !== "boolean" || event.cancelable) {
    // The event can be canceled, so we do so.
    event.preventDefault();
  } else {
    // The event cannot be canceled, so it is not safe
    // to call preventDefault() on it.
    console.warn(`The following event couldn't be canceled:`);
    console.dir(event);
  }
}

document.addEventListener("wheel", preventScrollWheel);

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。