Element: scrollTo()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Januar 2020 browserübergreifend verfügbar.
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-
Die x-Koordinate des scrollbaren Inhalts des Elements, zu der die linke Kante des Scrollports des Elements scrollen soll.
yCoord-
Die y-Koordinate des scrollbaren Inhalts des Elements, zu der die obere Kante des Scrollports des Elements scrollen soll.
options-
Ein Objekt, das die folgenden Eigenschaften enthält:
top-
Die y-Koordinate des scrollbaren Inhalts des Elements, zu der die obere Kante des Scrollports des Elements scrollen soll. Dies ist das gleiche wie der
yCoord-Parameter. left-
Die x-Koordinate des scrollbaren Inhalts des Elements, zu der die linke Kante des Scrollports des Elements scrollen soll. Dies ist das gleiche wie der
xCoord-Parameter. behavior-
Bestimmt, ob das Scrollen sofort erfolgt 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 auf dem Element bestimmt.
Rückgabewert
Keiner (undefined).
Beispiele
element.scrollTo(0, 1000);
Verwendung von options:
element.scrollTo({
top: 100,
left: 100,
behavior: "smooth",
});
Spezifikationen
| Spezifikation |
|---|
| CSSOM View Module # dom-element-scrollto |