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

View in English Always switch to English

IntersectionObserver: thresholds プロパティ

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2019年3月⁩.

thresholdsIntersectionObserver インターフェイスの読み取り専用プロパティで、このオブザーバーを IntersectionObserver() でインスタンス化したときに指定された交差量のしきい値の一覧を返すものです。

オブジェクトのインスタンス化時に指定されたしきい値の比率が 1 つだけの場合、これはその単一の値を含む配列になります。

しきい値がどのように作用するかについては、しきい値を参照してください。

オブザーバーをインスタンス化する際に threshold プロパティを使用して元々指定されていた、交差量のしきい値の配列です。 配列にせずにしきい値を 1 つだけ指定した場合、この値はそのしきい値を含む 1 項目の配列となります。 元の threshold 配列の順序に関係なく、この値は常に数値の昇順に並べ替えられます。

threshold オプションを指定せずに IntersectionObserver() でオブザーバーをインスタンス化した場合、 thresholds の値は [0] となります。

メモ: IntersectionObserver() コンストラクターで指定できる options オブジェクトには threshold というフィールドがありますが、このプロパティは thresholds と呼ばれています。 もし options のフィールド名として誤って thresholds を使用してしまうと、 thresholds の配列は [0.0] になってしまい、おそらく期待したものとは異なるものになってしまいます。

仕様書

Specification
Intersection Observer
# dom-intersectionobserver-thresholds

ブラウザーの互換性