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月.
thresholds は IntersectionObserver インターフェイスの読み取り専用プロパティで、このオブザーバーを 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 |
ブラウザーの互換性
Loading…