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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
scrollBy
options.behavior parameter
options.left parameter
options.top parameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support