diff options
Diffstat (limited to 'files/zh-cn/web/api/resizeobserver/index.html')
| -rw-r--r-- | files/zh-cn/web/api/resizeobserver/index.html | 79 |
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 => { + 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> |
