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 尺寸触发。
相关术语
相关资源
相关课程
- 观察者
学习 Resize Observer。
解读错误信息
用大白话解释常见错误——什么意思、为什么发生、如何修复。