Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 ⁨Januar 2020⁩.

Die scrollBy() Methode des Element Interfaces 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, 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

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