SnapEvent: snapTargetBlock-Eigenschaft

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die schreibgeschützte snapTargetBlock-Eigenschaft des SnapEvent-Interfaces gibt eine Referenz auf das im Blockrichtung gesnappte Element zurück, wenn das Ereignis ausgelöst wurde.

Konkret bedeutet das:

  • Im Fall des scrollsnapchanging-Ereignisses bezieht sich dies auf ein ausstehendes Ziel im Blockrichtung, das gesnappt wird (d.h. es wird ausgewählt, wenn das aktuelle Scroll-Geste endet).
  • Im Fall des scrollsnapchange-Ereignisses bezieht sich dies auf ein neu ausgewähltes Ziel im Blockrichtung, das gesnapt wurde.

Die auf SnapEvent verfügbaren Eigenschaftswerte entsprechen direkt dem Wert der im Scroll-Container festgelegten scroll-snap-type-CSS-Eigenschaft. snapTargetBlock gibt nur dann eine Elementreferenz zurück, wenn die Snap-Achse als block (oder ein physikalischer Achsenwert, der im aktuellen Schreibmodus block entspricht) oder both angegeben ist.

Wert

Ein Node, der das gesnappte Element repräsentiert, oder null, wenn das Scroll-Snapping nur in der Inline-Richtung erfolgt und daher kein Element in der Blockrichtung gesnapt wird.

Wenn das gesnappte Element ein Pseudo-Element war, wird der zurückgegebene Node das besitzende Element dieses Pseudo-Elements sein.

Beispiele

Siehe die Hauptseite SnapEvent für kurze Beispiele und unseren Leitfaden zur Verwendung von Scroll-Snap-Ereignissen für vollständige Beispiele und Erklärungen.

Spezifikationen

Specification
CSS Scroll Snap Module Level 2
# dom-snapevent-snaptargetblock

Browser-Kompatibilität

Siehe auch