Die schreibgeschütztescrollY-Eigenschaft derWindow-Schnittstelle gibt die Anzahl der Pixel zurück, um die das Dokument derzeit vertikal gescrollt ist. Dieser Wert ist in modernen Browsern subpixel-genau, was bedeutet, dass er nicht unbedingt eine ganze Zahl ist. Sie können die Anzahl der Pixel, um die das Dokument horizontal gescrollt ist, von derscrollX-Eigenschaft erhalten.

Wert

Ein Gleitkommawert mit doppelter Genauigkeit, der angibt, um wie viele Pixel das Dokument derzeit vertikal vom Ursprung aus gescrollt ist, wobei ein positiver Wert bedeutet, dass der Inhalt nach unten gescrollt ist (um mehr Inhalt am unteren Rand freizugeben). Technisch ausgedrückt gibtscrollY die Y-Koordinate der oberen Kante des aktuellenViewport zurück. Wenn das Dokument überhaupt nicht nach oben oder unten gescrollt ist, istscrollY 0. Wenn kein Viewport vorhanden ist, ist der zurückgegebene Wert 0. Wenn das Dokument auf einem subpixel-genauen Gerät gerendert wird, ist der zurückgegebene Wert ebenfalls subpixel-genau und kann eine dezimale Komponente enthalten.

Safari reagiert auf Overscrolling, indemscrollY über die maximale Scroll-Position hinaus aktualisiert wird (es sei denn, der Standard-"Bounce"-Effekt ist deaktiviert, z.B. durch Setzen vonoverscroll-behavior aufnone), während Chrome und Firefox dies nicht tun. Beispielsweise kannscrollY auf Safari negativ sein, indem einfach weiter nach oben gescrollt wird, wenn sich das Dokument bereits ganz oben befindet.

Diese Eigenschaft ist schreibgeschützt. Um das Fenster an eine bestimmte Stelle zu scrollen, verwenden SieWindow.scroll().

Beispiele

// make sure and go down to the second pageif (window.scrollY) {  window.scroll(0, 0); // reset the scroll position to the top left of the document.}window.scrollByPages(1);

Hinweise

Verwenden Sie diese Eigenschaft, um zu überprüfen, dass das Dokument noch nicht gescrollt wurde, wenn relative Scrollfunktionen wiescrollBy(),scrollByLines() oderscrollByPages() verwendet werden.

DiepageYOffset-Eigenschaft ist ein Alias für diescrollY-Eigenschaft. Dies bedeutet, dass, wenn Sie keine der beiden Eigenschaften neu zugewiesen haben,window.pageYOffset === window.scrollY immer wahr ist.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• window.scrollX