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: 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 ⁨Januar 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 angezeigt haben möchten.

yCoord

Das Pixel entlang der vertikalen Achse des Elements, das Sie in der oberen linken Ecke angezeigt haben 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

Bestimmt, ob das Scrollen sofort oder weich animiert erfolgen soll. Diese Option ist ein String, der einen der folgenden Werte annehmen muss:

  • smooth: das Scrollen sollte weich animiert werden
  • instant: das Scrollen sollte sofort in einem einzigen Sprung erfolgen
  • auto: Das Scroll-Verhalten 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