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

Window:resize 事件

· 52CE 我爱测

在一些早期的浏览器中,可以在任何 HTML 元素上注册 `resize` 事件处理器。现在仍然可以设置 `onresize` 属性或使用 EventTarget.addEventListener 在任何元素上设置一个处理器。然而,`resize` 事件只在 Window 对象(即由 document.defaultView 返回)上触发。只有在 `window` 对象上注册的处理器才能接收 `resize` 事件。

resize 事件在文档视图(窗口)调整大小时触发。

这个事件不可取消,不会冒泡。

在一些早期的浏览器中,可以在任何 HTML 元素上注册 resize 事件处理器。现在仍然可以设置 onresize 属性或使用 EventTarget.addEventListener 在任何元素上设置一个处理器。然而,resize 事件只在 Window 对象(即由 document.defaultView 返回)上触发。只有在 window 对象上注册的处理器才能接收 resize 事件。

虽然现在 resize 事件只针对窗口触发,但你可以使用 ResizeObserver API 获得其他元素的尺寸调整通知。

如果对你的应用程序来说,调整大小事件被触发了太多次,请参阅优化 window.onresize 来控制事件触发的时间。

语法

在像 EventTarget.addEventListener 这样的方法中使用事件名称,或者设置事件处理器属性。

addEventListener("resize", (event) => {});

onresize = (event) => {};

事件类型

一个通用的 Event。

示例

窗口大小记录器

以下示例报告了每次改变窗口大小时,窗口的尺寸。

HTML

<p>缩放浏览器窗口以触发 <code>resize</code> 事件</p>
<p>窗口高度:<span id="height"></span></p>
<p>窗口宽度:<span id="width"></span></p>

JavaScript

const heightOutput = document.querySelector("#height");
const widthOutput = document.querySelector("#width");

function reportWindowSize() {
  heightOutput.textContent = window.innerHeight;
  widthOutput.textContent = window.innerWidth;
}

window.onresize = reportWindowSize;

结果

窗口大小记录器

[!NOTE] 这里的例子是在 iframe 中输出的,所以报告的宽度和高度值是针对 <iframe> 的,而不是本页面所在的窗口。特别是,很难调整窗口的大小,以便看到报告高度的不同。

窗口大小记录器更容易观察到效果。

addEventListener 等价形式

你也可以使用 addEventListener() 方法设定事件处理器:

window.addEventListener("resize", reportWindowSize);

规范

浏览器兼容性

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

资料来源与适用范围

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

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

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