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

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