Window: scrollTo() Methode
Window.scrollTo()
scrollt zu einem bestimmten Koordinatensatz im Dokument.
Syntax
scrollTo(xCoord, yCoord)
scrollTo(options)
Parameter
xCoord
-
Das Pixel entlang der horizontalen Achse des Dokuments, das Sie in der oberen linken Ecke anzeigen möchten.
yCoord
-
Das Pixel entlang der vertikalen Achse des Dokuments, das Sie in der oberen linken Ecke anzeigen möchten.
options
-
Ein Objekt, das die folgenden Eigenschaften enthält:
top
-
Gibt die Anzahl der Pixel entlang der Y-Achse an, um das Fenster oder Element zu scrollen.
left
-
Gibt die Anzahl der Pixel entlang der X-Achse an, um das Fenster oder Element zu scrollen.
behavior
-
Bestimmt, ob das Scrollen sofort erfolgt oder sanft animiert wird. Diese Option ist eine Zeichenkette, die einen der folgenden Werte annehmen muss:
smooth
: Das Scrollen sollte sanft animiert werdeninstant
: Das Scrollen sollte sofort und in einem einzigen Sprung erfolgenauto
: Das Scrollverhalten wird durch den berechneten Wert vonscroll-behavior
bestimmt
Rückgabewert
Kein (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
Specification |
---|
CSSOM View Module # dom-window-scrollto |
Browser-Kompatibilität
BCD tables only load in the browser