このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

IntersectionObserver: trackVisibility プロパティ

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimental: これは実験的な機能です。
本番で使用する前にブラウザー互換性一覧表をチェックしてください。

trackVisibilityIntersectionObserver インターフェイスの読み取り専用のプロパティで、オブザーバーが要素の交差に加えてターゲットの可視性も追跡するかどうかを示します。

交差判定のために可視性を追跡する場合は true、そうでない場合は false です。

この値は、IntersectionObserver() コンストラクターの option.trackVisibility 引数で設定します。

解説

可視性を追跡していない場合、オブザーバーは対象要素がルート要素のビューポート内にスクロールされた際に通知を提供します。 ただし、これは対象要素の可視性が損なわれているかどうかを判断するものではありません。対象要素は他の要素によって部分的に覆われている可能性があり、不透明度が低下している可能性があり、フィルターや座標変換、その他の変更によって歪んでいる可能性があります。

可視性を追跡する際、ブラウザーが可視であると考えてみる要素のみが交差として示されます。 このアルゴリズムは保守的であり、わずかな不透明度の減少のみを伴う要素など、技術的には可視である要素を省略する場合があります。

可視性の計算は計算コストが高いことに注意してください。 演算が行われる頻度が高くなりすぎないよう、 delay を使用して、最小報告間隔を制限してください。

仕様書

Specification
Intersection Observer
# dom-intersectionobserver-trackvisibility

ブラウザーの互換性

関連情報