Element: scrollBy()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.

Die scrollBy()-Methode der Element-Schnittstelle scrollt ein Element um den angegebenen Betrag.

Syntax

js
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, die das Fenster oder Element scrollen soll.

left

Gibt die Anzahl der Pixel entlang der X-Achse an, die das Fenster oder Element scrollen soll.

behavior

Gibt an, ob das Scrollen gleichmäßig animiert werden soll (smooth), sofort in einem Sprung geschehen soll (instant), oder ob der Browser entscheiden soll (auto, Standard).

Rückgabewert

Keiner (undefined).

Beispiele

js
// scroll an element
element.scrollBy(300, 300);

Verwendung von options:

js
element.scrollBy({
  top: 100,
  left: 100,
  behavior: "smooth",
});

Spezifikationen

Specification
CSSOM View Module
# dom-element-scrollby

Browser-Kompatibilität

BCD tables only load in the browser