Skip to content

Resize Observer

一句话解释

Resize Observer API 在元素内容矩形尺寸变化时回调,无需轮询。

用大白话说

Resize Observer API 监视元素,在其尺寸变化——宽、高或两者——时触发回调。与 window resize 事件(仅对整个视口触发)不同,Resize Observer 跟踪单个元素,包括由布局位移、内容变化或容器查询引起的尺寸变化。在该 API 出现前,检测元素尺寸变化需用 setInterval 轮询 getBoundingClientRect,既浪费又不精确。观察者很高效:浏览器仅在尺寸实际变化时触发并批量通知。回调中可拿到新的边框盒与内容盒尺寸。适用场景:必须适配容器(而非仅视口)的响应式组件、canvas 的 CSS 尺寸变化时重绘、为虚拟化列表重新测量,以及在原生容器查询支持前实现类似行为。

示例

javascript
const box = document.querySelector(".resizable");
const ro = new ResizeObserver((entries) => {
  for (const entry of entries) {
    const { width, height } = entry.contentRect;
    console.log(`Box is now ${width}x${height}`);
  }
});
ro.observe(box);

当 .resizable 尺寸变化(来自 CSS、内容或用户拖拽)时,回调带着新的 contentRect 尺寸触发。

相关术语

相关资源

相关课程

解读错误信息

用大白话解释常见错误——什么意思、为什么发生、如何修复。

查看错误

← 返回术语表