SnapEvent

Limited availability

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

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

SnapEvent インターフェイスは、 scrollsnapchanging イベントおよび scrollsnapchange イベントのイベントオブジェクトを定義します。それぞれ、ブラウザーが新しいスクロールスナップターゲットが待機状態(現在のスクロール捜査が終了したら選択される)になったとき、および新しいスナップターゲットが選択されたときにスクロールコンテナーで発生します。

これらのイベントは、新しい要素がスナップされた際にコードを実行するために使用できます。 SnapEvent は、インライン方向やブロック方向にスナップされた要素への参照を公開します。 SnapEvent で利用可能なプロパティ値は、スクロールコンテナーに設定された CSS プロパティ scroll-snap-type の値に直接対応しています。

  • スナップ軸が block (または、現在の書字方向で block に相当する物理軸値)として指定されている場合、 snapTargetBlock のみが要素参照を返します。
  • スナップ軸が inline (または、現在の書字方向で inline に相当する物理軸値)として指定されている場合、 snapTargetInline のみが要素参照を返します。
  • スナップ軸が both と指定されている場合、snapTargetBlocksnapTargetInline は要素参照を返します。
Event SnapEvent

コンストラクター

SnapEvent() Experimental

新しい SnapEvent オブジェクトインスタンスを作成します。

インスタンスプロパティ

親である Event から継承しているプロパティもあります。

snapTargetBlock 読取専用 Experimental

イベントが発生したときにブロック方向にスナップされた要素への参照を返します。また、インライン方向のみでスクロールのスナップが発生したため、ブロック方向にスナップされた要素がない場合は null を返します。

snapTargetInline 読取専用 Experimental

イベントが発生したときにインライン方向にスナップされた要素への参照を返します。また、スクロールのスナップがブロック方向のみで発生し、インライン方向にスナップされた要素がない場合は null を返します。

scrollsnapchanging の例

以下の scrollsnapchanging ハンドラー関数の例では、 snapTargetBlock の要素の class 属性を、 Element.className プロパティを使用して pending に設定しています。これは、スナップターゲットが待機状態になった際に、要素のスタイルを変更するために使用できます。

なお、このハンドラーは、ブロック方向のスクロールコンテナー(ページの writing-mode が横書きに設定されている場合は縦スクロール)に設定されることを意図しているため、複数のイベントの間で snapTargetBlock 要素のみが変更されます。 SnapEvent.snapTargetInline は、インライン方向にはスナップが発生しないため、 null が返されます。

js
scrollingElem.addEventListener("scrollsnapchanging", (event) => {
  // 現在の待機状態のスナップターゲットのクラスに "pending" を設定
  event.snapTargetBlock.className = "pending";

  // ブロック方向の新しい待機状態のスナップターゲット要素を出力
  console.log(event.snapTargetBlock);

  // null を出力。インラインスナップは発生しない
  console.log(event.snapTargetInline);
});

scrollsnapchange の例

次の scrollsnapchange ハンドラー関数の例では、 SnapEvent.snapTargetBlock 要素に選択クラスを設定しています。これは、新たに選択されたスナップターゲットを、選択されているように見せるスタイル(例えば、アニメーションするなど)に使用することができます。

js
scrollingElem.addEventListener("scrollsnapchange", (event) => {
  event.snapTargetBlock.className = "selected";
});

仕様書

Specification
CSS Scroll Snap Module Level 2
# snapevent-interface

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
SnapEvent
Experimental
SnapEvent() constructor
Experimental
snapTargetBlock
Experimental
snapTargetInline
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.

関連情報