Window: scrollBy()-Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die Window.scrollBy()-Methode scrollt das Dokument im
Fenster um den angegebenen Betrag.
Syntax
scrollBy(xCoord, yCoord)
scrollBy(options)
Parameter
xCoord-
Der horizontale Pixelwert, um den Sie scrollen möchten.
yCoord-
Der vertikale Pixelwert, um den Sie scrollen möchten.
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 weich animiert erfolgt. Diese Option ist ein String, der einen der folgenden Werte annehmen muss:
smooth: Das Scrollen wird weich animiert.instant: Das Scrollen erfolgt sofort in einem einzigen Sprung.auto: Das Scroll-Verhalten wird durch den berechneten Wert derscroll-behaviorCSS-Eigenschaft im Dokument bestimmt.
Rückgabewert
Keiner (undefined).
Beispiele
Um eine Seite nach unten zu scrollen:
window.scrollBy(0, window.innerHeight);
Um nach oben zu scrollen:
window.scrollBy(0, -window.innerHeight);
Verwendung von options:
window.scrollBy({
top: 100,
left: 100,
behavior: "smooth",
});
Anmerkungen
window.scrollBy() scrollt um einen bestimmten Betrag, während
window.scroll() zu einer absoluten Position im Dokument scrollt. Siehe auch
window.scrollByLines() und window.scrollByPages().
Spezifikationen
| Spezifikation |
|---|
| CSSOM View Module # dom-window-scrollby |