Window: 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 July 2015.

Die Window.scroll()-Methode scrollt das Fenster zu einer bestimmten Stelle im Dokument.

Syntax

scroll(xCoord, yCoord)
scroll(options)

Parameter

xCoord

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

yCoord

Das Pixel entlang der vertikalen Achse des Dokuments, 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 mit einer sanften Animation erfolgen soll. Diese Option ist ein String, der einen der folgenden Werte annehmen muss:

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

Rückgabewert

Keiner (undefined).

Beispiele

// Put the 100th vertical pixel at the top of the window
window.scroll(0, 100);

Verwendung von options:

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

Anmerkungen

Window.scrollTo() ist im Wesentlichen dieselbe Methode. Für relatives Scrollen siehe Window.scrollBy(), Window.scrollByLines() und Window.scrollByPages().

Für das Scrollen von Elementen siehe Element.scrollTop und Element.scrollLeft.

Spezifikationen

Specification
CSSOM View Module # dom-window-scroll