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: 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 ⁨Januar 2020⁩.

Die scrollTo()-Methode der Element-Schnittstelle scrollt zu einem bestimmten Koordinatensatz innerhalb eines gegebenen Elements.

Syntax

js
scrollTo(xCoord, yCoord)
scrollTo(options)

Parameter

xCoord

Das Pixel entlang der horizontalen Achse des Elements, das in der oberen linken Ecke angezeigt werden soll.

yCoord

Das Pixel entlang der vertikalen Achse des Elements, das in der oberen linken Ecke angezeigt werden soll.

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 sanft animiert erfolgen soll. Diese Option ist ein String, der einen der folgenden Werte haben 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
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

Siehe auch