aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/resizeobserver/index.html
diff options
context:
space:
mode:
Diffstat (limited to 'files/zh-cn/web/api/resizeobserver/index.html')
-rw-r--r--files/zh-cn/web/api/resizeobserver/index.html79
1 files changed, 79 insertions, 0 deletions
diff --git a/files/zh-cn/web/api/resizeobserver/index.html b/files/zh-cn/web/api/resizeobserver/index.html
new file mode 100644
index 0000000000..602fb4b351
--- /dev/null
+++ b/files/zh-cn/web/api/resizeobserver/index.html
@@ -0,0 +1,79 @@
+---
+title: ResizeObserver
+slug: Web/API/ResizeObserver
+translation_of: Web/API/ResizeObserver
+---
+<div>{{APIRef("Resize Observer API")}}{{SeeCompatTable}}</div>
+
+<p class="summary"><strong><code>ResizeObserver</code></strong> 接口可以监听到 {{domxref('Element')}} 的内容区域或 {{domxref('SVGElement')}}的边界框改变。内容区域则需要减去内边距padding。(有关内容区域、内边距资料见<a href="https://developer.mozilla.org/docs/Learn/CSS/Introduction_to_CSS/Box_model">盒子模型</a> )</p>
+
+<p>ResizeObserver避免了在自身回调中调整大小,从而触发的无限回调和循环依赖。它仅通过在后续帧中处理DOM中更深层次的元素来实现这一点。如果(浏览器)遵循规范,只会在绘制前或布局后触发调用。</p>
+
+<h2 id="构造器">构造器</h2>
+
+<dl>
+ <dt>{{domxref("ResizeObserver.ResizeObserver", "ResizeObserver()")}}</dt>
+ <dd>创建并返回一个<code>ResizeObserver</code>对象。</dd>
+</dl>
+
+<h2 id="属性">属性</h2>
+
+<p>无。</p>
+
+<h3 id="Event_handlers">Event handlers</h3>
+
+<p>无。</p>
+
+<h2 id="方法">方法</h2>
+
+<dl>
+ <dt>{{domxref('ResizeObserver.disconnect()')}}</dt>
+ <dd>取消和结束目标对象上所有对 {{domxref('Element')}}或 {{domxref('SVGElement')}} 观察。</dd>
+ <dt>{{domxref('ResizeObserver.observe()')}}</dt>
+ <dd>开始观察指定的 {{domxref('Element')}}或 {{domxref('SVGElement')}}。</dd>
+ <dt>{{domxref('ResizeObserver.unobserve()')}}</dt>
+ <dd>结束观察指定的{{domxref('Element')}}或 {{domxref('SVGElement')}}。</dd>
+</dl>
+
+<h2 id="示例">示例</h2>
+
+<p>以下示例通过观察box的宽度变化从而改变其边框圆角半径。</p>
+
+<pre class="brush: js">const resizeObserver = new ResizeObserver(entries =&gt; {
+ for (let entry of entries) {
+ entry.target.style.borderRadius = Math.max(0, 250 - entry.contentRect.width) + 'px';
+ }
+});
+resizeObserver.observe(document.querySelector('.box:nth-child(2)'));</pre>
+
+<h2 id="规范">规范</h2>
+
+<table class="standard-table">
+ <tbody>
+ <tr>
+ <th scope="col">Specification</th>
+ <th scope="col">Status</th>
+ <th scope="col">Comment</th>
+ </tr>
+ <tr>
+ <td>{{SpecName('Resize Observer','#resize-observer-interface','ResizeObserver')}}</td>
+ <td>{{Spec2('Resize Observer')}}</td>
+ <td>Initial definition.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="浏览器兼容性">浏览器兼容性</h2>
+
+
+
+<p>{{Compat("api.ResizeObserver")}}</p>
+
+<h2 id="参考">参考</h2>
+
+<ul>
+ <li><a href="https://developer.mozilla.org/docs/Learn/CSS/Introduction_to_CSS/Box_model">The box model</a></li>
+ <li>{{domxref('PerformanceObserver')}}</li>
+ <li>{{domxref('MutationObserver')}}</li>
+ <li>{{domxref('IntersectionObserver')}} (part of the <a href="/en-US/docs/Web/API/Intersection_Observer_API">Intersection Observer API</a>)</li>
+</ul>