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 September 2020.

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

Syntax

js
scroll(xCoord, yCoord)
scroll(options)

Parameter

xCoord

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

yCoord

Das Pixel entlang der vertikalen Achse des Dokuments, 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 annehmen muss:

  • smooth: Das Scrollen sollte sanft animiert erfolgen
  • 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

html
<!-- put the 100th vertical pixel at the top of the window -->

<button onclick="scroll(0, 100);">click to scroll to the 100th pixel</button>

Verwendung von options:

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

Hinweise

Window.scrollTo() ist im Wesentlichen dasselbe wie diese 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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch