Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
Window: scrollX-Eigenschaft
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
* Some parts of this feature may have varying levels of support.
Die schreibgeschütztescrollX-Eigenschaft derWindow-Schnittstelle gibt die Anzahl der Pixel zurück, um die das Dokument derzeit horizontal gescrollt ist. Dieser Wert ist in modernen Browsern subpixelgenau, was bedeutet, dass er nicht unbedingt eine ganze Zahl ist. Sie können die Anzahl der Pixel, um die das Dokument vertikal gescrollt ist, von derscrollY-Eigenschaft erhalten.
Wert
Ein Gleitkommawert mit doppelter Genauigkeit, der die Anzahl der Pixel angibt, um die das Dokument derzeit horizontal vom Ursprung gescrollt ist, wobei ein positiver Wert bedeutet, dass der Inhalt nach rechts gescrollt ist (um mehr Inhalt auf der rechten Seite anzuzeigen). Technisch ausgedrückt, gibtscrollX die X-Koordinate des linken Randes des aktuellenViewports zurück. Wenn das Dokument überhaupt nicht nach links oder rechts gescrollt ist, istscrollX 0. Wenn kein Viewport vorhanden ist, ist der zurückgegebene Wert 0. Wenn das Dokument auf einem subpixelgenauen Gerät gerendert wird, dann ist der zurückgegebene Wert ebenfalls subpixelgenau und kann eine Dezimalkomponente enthalten.
Hinweis:Wenn Sie einen ganzzahligen Wert benötigen, können SieMath.round() verwenden, um ihn zu runden.
Es ist möglich, dassscrollX negativ ist, wenn das Dokument vom initialen umgebenden Block nach links gescrollt werden kann. Zum Beispiel, wenn das Dokument von rechts nach links verläuft und der Inhalt nach links wächst.
Safari reagiert auf das Überrollen, indem esscrollX über die maximale Scrollposition hinaus aktualisiert (es sei denn, der standardmäßige "Bounce"-Effekt wird deaktiviert, zum Beispiel durch Setzen vonoverscroll-behavior aufnone), während Chrome und Firefox dies nicht tun.
Diese Eigenschaft ist schreibgeschützt. Um das Fenster an eine bestimmte Stelle zu scrollen, verwenden SieWindow.scroll().
Beispiele
Dieses Beispiel überprüft die aktuelle horizontale Scrollposition des Dokuments. Wenn sie größer als 400 Pixel ist, wird das Fenster zum Anfang zurückgescrollt.
if (window.scrollX > 400) { window.scroll(0, 0);}Hinweise
DiepageXOffset-Eigenschaft ist ein Alias für diescrollX-Eigenschaft. Dies bedeutet, dasswindow.pageXOffset === window.scrollX immer true ist, wenn Sie keine der Eigenschaften neu zugewiesen haben.
Spezifikationen
| Specification |
|---|
| CSSOM View Module # dom-window-scrollx |