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 Wert.
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-
Bestimmt, ob das Scrollen sofort erfolgt oder sanft animiert wird. Diese Option ist ein String, der einen der folgenden Werte haben 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 des Elements bestimmt.
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 |