ResizeObserver是监听HTML元素尺寸变化的唯一合理方案,window.resize仅响应视口变化,无法捕获flex重排、内容撑开等内部变更;需确保元素已挂载、避免修改自身盒模型引发循环。

ResizeObserver 是监听 HTML 区域(比如 很多人一上来就给 除非你真在监听整个浏览器窗口缩放,否则写 立即学习“前端免费学习笔记(深入)”; 实操建议: 生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力:
- 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面;
- 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”;
- 提及位于 `apps/console/src/featur 若需总占用尺寸(含 padding + border),可搭配 在 ResizeObserver 回调中直接修改被观察元素的盒模型属性(如 组件卸载时漏掉 <div>、<code><section></section>)尺寸变化的唯一合理方案,window.resize 完全无效 —— 它只管浏览器窗口,不管你的盒子。为什么 window.addEventListener('resize', ...) 对 div 完全没用
window 绑 resize,结果侧边栏展开、Flex 子项收缩、卡片内容变多导致高度撑开,回调一次都不触发。这是因为:
window.resize 只响应 viewport 尺寸变化(比如用户拖拽浏览器边框)<div> 高度 → 不触发<li>CSS <code>display: flex 下兄弟元素 flex-grow 拉伸,当前元素被压缩 → 不触发window.addEventListener('resize', ...) 去管某个区域,就是方向错了。ResizeObserver.observe() 报错或静默失败的常见原因
ResizeObserver.observe() 必须传入一个**已挂载到 DOM 中的真实 Element 节点**,否则要么直接报错,要么静默失效:
null 或 undefined(比如 document.getElementById('missing') 没查到)→ 报错:Failed to execute 'observe' on 'ResizeObserver': The target must be an instance of Element
ref 还没绑定、SSR 渲染阶段、innerHTML 插入前就调用)→ 静默失败,回调永不执行display: none 的元素 → 元素脱离文档流,不触发;应改用 visibility: hidden 或先 ro.unobserve(el)
DOMContentLoaded 后,或确认 el && el.nodeType === 1 再调用 ro.observe(el)
useEffect(() => { ro.observe(el); return () => ro.unobserve(el); }, []) 中处理mounted(Vue 2)或 onMounted(Vue 3)中执行contentRect.width/height 到底返回什么
entry.contentRect.width 和 entry.contentRect.height 永远只反映 content-box 尺寸,与 box-sizing 无关:
width: 300px; padding: 20px; border: 4px solid; box-sizing: border-box,contentRect.width 仍是 252(300 − 20×2 − 4×2)<div> 只靠 <code>padding: 50px 扩展高度 → contentRect.height === 0,不会触发回调el.getBoundingClientRect(),但注意它会强制同步 layout,高频回调中慎用。回调里改样式导致页面卡死怎么办
el.style.width、el.style.padding、el.style.display),会再次触发 layout 计算,从而再次进入回调 —— 形成无限循环,CPU 拉满,页面冻结。
entry.contentRect,更新非盒模型状态(如设置 dataset.width、切换 class、写 CSS 自定义属性 --panel-width)entry.target 自身if (width !== lastWidth) { /* update */; lastWidth = width; },但不能替代架构设计ro.disconnect() 或 ro.unobserve(el),会导致内存泄漏和 Cannot read property 'xxx' of null 错误 —— 这是最容易被忽略的生产级陷阱。


















