Element: scrollBy() 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 scrollBy() Methode des Element Interfaces scrollt ein Element um den angegebenen Betrag.
Syntax
scrollBy(xCoord, yCoord)
scrollBy(options)
Parameter
xCoord-
Der horizontale Pixelwert, um den Sie scrollen möchten.
yCoord-
Der vertikale Pixelwert, um den Sie scrollen möchten.
options-
Ein Objekt, das die folgenden Eigenschaften enthält:
top-
Gibt die Anzahl der Pixel entlang der Y-Achse an, um die das Fenster oder Element gescrollt werden soll.
left-
Gibt die Anzahl der Pixel entlang der X-Achse an, um die das Fenster oder Element gescrollt werden soll.
behavior-
Gibt an, ob das Scrollen sanft animiert (
smooth), sofort in einem einzigen Sprung (instant) erfolgen soll oder der Browser die Methode wählen sollte (auto, Standard).
Rückgabewert
Keiner (undefined).
Beispiele
// scroll an element
element.scrollBy(300, 300);
Verwendung von options:
element.scrollBy({
top: 100,
left: 100,
behavior: "smooth",
});
Spezifikationen
| Spezifikation |
|---|
| CSSOM View Module> # dom-element-scrollby> |