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 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

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

Spezifikation
CSSOM View Module
# dom-element-scrollby

Browser-Kompatibilität