Motivation
响应式网站/Web应用程序 根据视口大小调整内容展示方式。这通常通过CSS和media查询来完成。当CSS表现不好我们会使用Javascript。
比如document.addEventListener("resize",fun)或者Element的onresize属性。通过监听window.resize事件,Javascript DOM操作与视口大小保持同步。
但你会意识到,这甚至不包括在窗口未被调整大小但元素改变其大小的情况。例如,添加新的子元素,设置元素的display样式none或类似的操作会改变元素,其兄弟或祖先的大小。
随着响应式Web应用程序的普及,对响应式组件的需求也会增加。这些组件也需要有对resize事件做出响应。不幸的是,Web平台目前不提供组件跟踪其大小的方法。
Current workarounds
一些应用程序实施自制的调整大小通知框架(例如:Polymer)。这种方法容易出错,难以维护,并且需要每个组件都实施自制方法。
其他人巧妙的通过可以代替调整事件的事件来调整内容(例如:<a href="https://github.com/wnr/element-resize-detector">element-resize-detector</a>)。目前最优秀的方法都使用类似的技巧:
在组件中插入一个绝对定位的子项,并且以发出滚动事件的方式制作子项,或者在父项大小更改时制作window.resize。
绝对定位的子项方法在ShadowDOM或React等框架中不起作用。
这些方法都不可取。它们在正确性,代码复杂性和性能方面都失败了。
在当今的Web平台上无法复制ResizeObserver功能。
这就是为什么ResizeObserver是一个有用的原始API。它对任何观察到的元素的大小的变化作出反应,与导致变化的原因无关。它还为您提供访问观察元素的新大小。
API
提到的“Observer”后缀的API共享一个简单的API设计。ResizeObserver也不例外。
您创建一个ResizeObserver 对象并将回调传递给构造函数。回调将被赋予一个数组ResizeOberverEntries- 每个观察元素一个条目 - 包含元素的大小
var ro = new ResizeObserver( entries => { for (let entry of entries) { const cr = entry.contentRect; console.log(‘Element:‘, entry.target); console.log(`Element size: ${cr.width}px x ${cr.height}px`); console.log(`Element padding: ${cr.top}px ; ${cr.left}px`); } }); // Observe one or multiple elements ro.observe(someElement);
Usage examples
以下是使用ResizeObserver在画布内绘制椭圆的示例。
<canvas style="width:10%;height:10%"></canvas> <canvas style="width:20%;height:20%"></canvas> function drawEllipse(entry) { let ctx = entry.target.getContext(‘2d‘); let rx = Math.floor(entry.contentRect.width / 2); let ry = Math.floor(entry.contentRect.height / 2); ctx.beginPath(); ctx.clearRect(0,0, entry.contentRect.width,entry.contentRect.height); ctx.ellipse(rx, ry, rx, ry, 0, 0, 2 * Math.PI); ctx.stroke(); } // ResizeObserver delegates action to Element‘s handleResize method let ro = new ResizeObserver( entries => { for (let entry of entries) { if (entry.target.handleResize) entry.target.handleResize(entry); } }); // Set up observations var canvases = document.querySelectorAll(‘canvas‘); for (let canvas of canvases) { canvas.handleResize = drawEllipse; ro.observe(canvas); }
内联框架可以检测其大小何时发生变化,并通知父窗口。
let ro = new ResizeObserver(entries => { let idealSize = computeIdealSize(); window.parent.postMessage({ name: "iframeResize", width: idealSize.width, height: idealSize.height }, ‘*‘); }); ro.observe(document.body);
当新消息到达时,我们如何让聊天窗口滚动到底部?ResizeObserver解决方案将所有消息保存在不断增长的中div,并观察其大小。当新消息到达时,滚动到底部。
完整的例子 详细讨论了用户滚动的处理。
.chat { overflow: scroll; } <div class="chat"> <!-- chat has the scrollbar --> <div class="chat-text"> <!-- chat-text contains chat text --> <div>jack: hi </div> <div>jill: hi </div> </div> </div let ro = new ResizeObserver( entries => { for (let e of entries) { let chat = e.target.parentNode; chat.scrollTop = chat.scrollHeight - chat.clientHeight; } }); ro.observe(document.querySelector(‘.chat-text‘))
How
Performance
调整通知的大小可以有很高的频率。Observer API避免了事件捕获/泡泡的开销。
框架作者可以在ResizeObserver之上提供一个开发友好的“基于事件”的API,以避免注册太多的观察者。
Notice
通知传送顺序
当多个ResizeObservers注册时,通知应按注册顺序传送。
回调变更集应按注册顺序列出元素。
内联元素
内联元素不应该生成调整大小通知。
怎么样变换?
转换不会影响内容大小。他们不应该触发通知。
动画怎么样?
影响内容大小的动画应该会触发通知。
如果工作成本很高,开发人员可能会希望在动画期间跳过工作。
调整大小和可视性
当元素不可见时,内容大小变为0。这将生成一个调整大小的通知。开发人员将能够使用ResizeObserver观察可见性。
本文参考:
ResizeObserver: It’s Like document.onresize for Elements ----- https://developers.google.com/web/updates/2016/10/resizeobserver
WICG/ResizeObserver ----- https://github.com/WICG/ResizeObserver/blob/master/explainer.md
原文地址:https://www.cnblogs.com/CrossGod/p/ResizeObserver.html