blob: 1aa608a771b7c1609b732612837d311d0ac9085a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
---
title: Intersection Observer
slug: Web/API/IntersectionObserver
tags:
- API
- Experimental
- Interface
- Intersection Observer API
- IntersectionObserver
- Reference
- observers
translation_of: Web/API/IntersectionObserver
---
<div>{{APIRef("Intersection Observer API")}}</div>
<p><span class="seoSummary"><code><strong>IntersectionObserver</strong></code><strong>接口</strong> (从属于<a href="/en-US/docs/Web/API/Intersection_Observer_API">Intersection Observer API</a>) 提供了一种异步观察目标元素与其</span>祖先<span class="seoSummary">元素或顶级文档视窗({{Glossary('viewport')}})交叉状态的方法。</span>祖先元素与视窗({{Glossary('viewport')}})被称为<strong>根(root)。</strong></p>
<p>当一个<span class="seoSummary"><code>IntersectionObserver</code></span>对象被创建时，其被配置为监听根中一段给定比例的可见区域。一旦IntersectionObserver被创建，则无法更改其配置，所以一个给定的观察者对象只能用来监听可见区域的特定变化值；然而，你可以在同一个观察者对象中配置监听多个目标元素。</p>
<h2 id="构造器">构造器</h2>
<dl>
<dt>{{domxref("IntersectionObserver.IntersectionObserver()")}}</dt>
<dd>创建一个新的<code>IntersectionObserver</code>对象，当其监听到目标元素的可见部分穿过了一个或多个<strong>阈(thresholds)</strong>时，会执行指定的回调函数。</dd>
</dl>
<h2 id="属性">属性</h2>
<dl>
<dt>{{domxref("IntersectionObserver.root")}} {{readonlyinline}}</dt>
<dd>所监听对象的具体祖先元素({{domxref("element")}})。如果未传入值或值为<code>null</code>，则默认使用顶级文档的视窗。</dd>
<dt>{{domxref("IntersectionObserver.rootMargin")}} {{readonlyinline}}</dt>
<dd>计算交叉时添加到<strong>根(root)</strong>边界盒{{Glossary('bounding box')}}的矩形偏移量， 可以有效的缩小或扩大根的判定范围从而满足计算需要。此属性返回的值可能与调用构造函数时指定的值不同，因此可能需要更改该值，以匹配内部要求。所有的偏移量均可用<strong>像素(pixel)</strong>(<code>px</code>)或<strong>百分比(percentage)</strong>(<code>%</code>)来表达, 默认值为"0px 0px 0px 0px"。</dd>
<dt>{{domxref("IntersectionObserver.thresholds")}} {{readonlyinline}}</dt>
<dd>一个包含阈值的列表, 按升序排列, 列表中的每个阈值都是监听对象的交叉区域与边界区域的比率。当监听对象的任何阈值被越过时，都会生成一个通知(Notification)。如果构造器未传入值, 则默认值为0。</dd>
</dl>
<h2 id="方法">方法</h2>
<dl>
<dt>{{domxref("IntersectionObserver.disconnect()")}}</dt>
<dd>使<code>IntersectionObserver</code>对象停止监听工作。</dd>
<dt>{{domxref("IntersectionObserver.observe()")}}</dt>
<dd><font face="Open Sans, arial, x-locale-body, sans-serif">使</font><code>IntersectionObserver</code>开始监听一个目标元素。</dd>
<dt>{{domxref("IntersectionObserver.takeRecords()")}}</dt>
<dd>返回所有观察目标的{{domxref("IntersectionObserverEntry")}}对象数组。</dd>
<dt>{{domxref("IntersectionObserver.unobserve()")}}</dt>
<dd><font face="Open Sans, arial, x-locale-body, sans-serif">使</font><code>IntersectionObserver</code>停止监听特定目标元素。</dd>
<dt>
</dt>
</dl>
<h2 id="示例">示例</h2>
<pre class="brush: js">var intersectionObserver = new IntersectionObserver(function(entries) {
// If intersectionRatio is 0, the target is out of view
// and we do not need to do anything.
if (entries[0].intersectionRatio <= 0) return;
loadItems(10);
console.log('Loaded new items');
});
// start observing
intersectionObserver.observe(document.querySelector('.scrollerFooter'));</pre>
<h2 id="规范">规范</h2>
{{Specifications}}
<h2 id="浏览器兼容">浏览器兼容</h2>
<p>{{Compat}}</p>
<h2 id="参考">参考</h2>
<ul>
<li>{{domxref('MutationObserver')}}</li>
<li>{{domxref('PerformanceObserver')}}</li>
<li>{{domxref('ResizeObserver')}}</li>
</ul>
<p> </p>
|
