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 Eigenschaft snapTargetBlock des SnapEvent-Interfaces gibt eine Referenz auf das Element zurück, das beim Auslösen des Ereignisses in der Blockrichtung einschnappt.

Konkret:

  • Im Fall des scrollsnapchanging-Ereignisses bezieht sich dies auf ein in der Blockrichtung bevorstehendes Einschnappziel (d.h. es wird ausgewählt, wenn die aktuelle Scroll-Geste endet).
  • Im Fall des scrollsnapchange-Ereignisses bezieht sich dies auf ein neu ausgewähltes Einschnappziel in der Blockrichtung.

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

Wert

Ein Node, der das eingeschnappte Element darstellt, oder null, wenn das Scroll-Einschnappen nur in der Inline-Richtung erfolgt und somit kein Element in der Blockrichtung einschnappt.

Wenn das eingeschnappte 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

BCD tables only load in the browser

Siehe auch