Element: scrollTo() 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 scrollTo()-Methode des Element Interfaces scrollt zu einem bestimmten Satz von Koordinaten innerhalb eines gegebenen Elements.

Syntax

js
scrollTo(xCoord, yCoord)
scrollTo(options)

Parameter

xCoord

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

yCoord

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

options

Ein Objekt, das die folgenden Eigenschaften enthält:

top

Gibt die Anzahl der Pixel entlang der Y-Achse an, um das Fenster oder Element zu scrollen.

left

Gibt die Anzahl der Pixel entlang der X-Achse an, um das Fenster oder Element zu scrollen.

behavior

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

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

Rückgabewert

Keiner (undefined).

Beispiele

js
element.scrollTo(0, 1000);

Verwendung von options:

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

Spezifikationen

Specification
CSSOM View Module
# dom-element-scrollto

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch