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…