Window: scrollTo()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die Window.scrollTo() Methode scrollt zu einem bestimmten Satz von
Koordinaten im Dokument.
Syntax
scrollTo(xCoord, yCoord)
scrollTo(options)
Parameter
xCoord-
Die x-Koordinate des Dokuments, zu der die linke Kante des Viewports scrollen soll.
yCoord-
Die y-Koordinate des Dokuments, zu der die obere Kante des Viewports scrollen soll.
options-
Ein Objekt, das die folgenden Eigenschaften enthält:
top-
Die y-Koordinate des Dokuments, zu der die obere Kante des Viewports scrollen soll. Dies ist dasselbe wie der
yCoord-Parameter. left-
Die x-Koordinate des Dokuments, zu der die linke Kante des Viewports scrollen soll. Dies ist dasselbe wie der
xCoord-Parameter. behavior-
Bestimmt, ob das Scrollen sofort oder sanft animiert wird. Diese Option ist ein String, der einen der folgenden Werte annehmen muss:
smooth: Das Scrollen wird sanft animiert.instant: Das Scrollen erfolgt sofort in einem einzigen Sprung.auto: Das Scrollverhalten wird durch den berechneten Wert derscroll-behaviorCSS-Eigenschaft im Dokument bestimmt.
Rückgabewert
Keiner (undefined).
Beispiele
window.scrollTo(0, 1000);
Verwendung von options:
window.scrollTo({
top: 100,
left: 100,
behavior: "smooth",
});
Hinweise
Window.scroll() ist im Wesentlichen dasselbe wie diese Methode. Für relatives
Scrollen, siehe Window.scrollBy(), Window.scrollByLines(),
und Window.scrollByPages().
Für das Scrollen von Elementen siehe Element.scrollTop und
Element.scrollLeft.
Spezifikationen
| Spezifikation |
|---|
| CSSOM View Module # dom-window-scrollto |