Element: scroll() 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 scroll() Methode der Element Schnittstelle scrollt das Element zu einem bestimmten Satz von Koordinaten innerhalb eines gegebenen Elements.

Syntax

js
scroll(xCoord, yCoord)
scroll(options)

Parameter

xCoord

Das Pixel entlang der horizontalen Achse des Elements, das Sie in der oberen linken Ecke anzeigen möchten.

yCoord

Das Pixel entlang der vertikalen Achse des Elements, das Sie in der oberen linken Ecke anzeigen möchten.

options

Ein Objekt mit den folgenden Eigenschaften:

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 oder sanft animiert wird. Diese Option ist ein String, der einen der folgenden Werte enthalten muss:

  • smooth: Das Scrollen sollte sanft animiert werden
  • instant: Das Scrollen sollte sofort in einem einzigen Sprung erfolgen
  • auto: Das Scrollverhalten wird durch den berechneten Wert von scroll-behavior bestimmt

Rückgabewert

Keiner (undefined).

Beispiele

js
// Put the 1000th vertical pixel at the top of the element
element.scroll(0, 1000);

Verwendung von options:

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

Spezifikationen

Specification
CSSOM View Module
# dom-element-scroll

Browser-Kompatibilität

BCD tables only load in the browser