Element: scrollTo()-Methode
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Januar 2020.
Die scrollTo()-Methode des Element-Interfaces scrollt zu einem bestimmten Satz von Koordinaten innerhalb eines gegebenen Elements.
Diese Methode ist ein Alias für Element.scroll().
Syntax
scrollTo(xCoord, yCoord)
scrollTo(options)
Parameter
xCoord-
Das Pixel entlang der horizontalen Achse des Elements, das oben links angezeigt werden soll.
yCoord-
Das Pixel entlang der vertikalen Achse des Elements, das oben links angezeigt werden soll.
options-
Ein Objekt, das die folgenden Eigenschaften enthält:
top-
Gibt die Anzahl der Pixel entlang der Y-Achse an, die das Fenster oder das Element scrollen soll.
left-
Gibt die Anzahl der Pixel entlang der X-Achse an, die das Fenster oder das Element scrollen soll.
behavior-
Bestimmt, ob das Scrollen sofort oder sanft animiert erfolgt. Diese Option ist ein String, der einen der folgenden Werte annehmen muss:
smooth: Scrollen soll sanft animiert werdeninstant: Scrollen soll sofort in einem einzigen Sprung erfolgenauto: Das Scrollverhalten wird durch den berechneten Wert vonscroll-behaviorbestimmt
Rückgabewert
Keiner (undefined).
Beispiele
element.scrollTo(0, 1000);
Verwendung von options:
element.scrollTo({
top: 100,
left: 100,
behavior: "smooth",
});
Spezifikationen
| Specification |
|---|
| CSSOM View Module> # dom-element-scrollto> |