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.

We’d love to hear your thoughts on the next set of proposals for the JavaScript language. You can find a description of the proposals here.

Please take two minutes to fill out our short survey.

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

Syntax

scroll(xCoord, yCoord)
scroll(options)

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

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

Ein Objekt, das die folgenden Eigenschaften enthält:

Gibt die Anzahl der Pixel entlang der Y-Achse an, um die das Fenster oder Element gescrollt werden soll.

Gibt die Anzahl der Pixel entlang der X-Achse an, um die das Fenster oder Element gescrollt werden soll.

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

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:

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

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.

Specification
CSSOM View Module # dom-window-scroll