← 返回首页
Window: scrollBy()-Methode - Web-APIs | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Seitenleiste umschalten
  1. Web
  2. Web-APIs
  3. Fenster
  4. scrollBy()
Farbschema
  • Systemeinstellung
  • Hell
  • Dunkel
Deutsch
Sprache merken Mehr erfahren

Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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.

In diesem Artikel

Syntax

js
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 der scroll-behavior CSS-Eigenschaft im Dokument bestimmt.

Rückgabewert

Keiner (undefined).

Beispiele

Um eine Seite nach unten zu scrollen:

js
window.scrollBy(0, window.innerHeight);

Um nach oben zu scrollen:

js
window.scrollBy(0, -window.innerHeight);

Verwendung von options:

js
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

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Help improve MDN

War diese Übersetzung hilfreich?
Ja Nein
Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.
Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden
  1. Fenster
  2. Instanzeigenschaften
    1. caches
    2. closed
    3. cookieStore
    4. crashReport
    5. credentialless
    6. crossOriginIsolated
    7. crypto
    8. customElements
    9. devicePixelRatio
    10. document
    11. documentPictureInPicture
    12. event
    13. external
    14. fence
    15. frameElement
    16. frames
    17. fullScreen
    18. history
    19. indexedDB
    20. innerHeight
    21. innerWidth
    22. isSecureContext
    23. launchQueue
    24. length
    25. localStorage
    26. location
    27. locationbar
    28. menubar
    29. mozInnerScreenX
    30. mozInnerScreenY
    31. name
    32. navigation
    33. navigator
    34. opener
    35. orientation
    36. origin
    37. originAgentCluster
    38. outerHeight
    39. outerWidth
    40. parent
    41. performance
    42. personalbar
    43. scheduler
    44. screen
    45. screenLeft
    46. screenTop
    47. screenX
    48. screenY
    49. scrollbars
    50. scrollMaxX
    51. scrollMaxY
    52. scrollX
    53. scrollY
    54. self
    55. sessionStorage
    56. sharedStorage
    57. speechSynthesis
    58. status
    59. statusbar
    60. toolbar
    61. top
    62. trustedTypes
    63. viewport
    64. visualViewport
    65. window
  3. Instanzmethoden
    1. alert()
    2. atob()
    3. blur()
    4. btoa()
    5. cancelAnimationFrame()
    6. cancelIdleCallback()
    7. captureEvents()
    8. clearImmediate()
    9. clearInterval()
    10. clearTimeout()
    11. close()
    12. confirm()
    13. createImageBitmap()
    14. dump()
    15. fetch()
    16. fetchLater()
    17. find()
    18. focus()
    19. getComputedStyle()
    20. getDefaultComputedStyle()
    21. getScreenDetails()
    22. getSelection()
    23. matchMedia()
    24. moveBy()
    25. moveTo()
    26. open()
    27. postMessage()
    28. print()
    29. prompt()
    30. queryLocalFonts()
    31. queueMicrotask()
    32. releaseEvents()
    33. reportError()
    34. requestAnimationFrame()
    35. requestFileSystem()
    36. requestIdleCallback()
    37. resizeBy()
    38. resizeTo()
    39. scroll()
    40. scrollBy()
    41. scrollByLines()
    42. scrollByPages()
    43. scrollTo()
    44. setImmediate()
    45. setInterval()
    46. setResizable()
    47. setTimeout()
    48. showDirectoryPicker()
    49. showOpenFilePicker()
    50. showSaveFilePicker()
    51. sizeToContent()
    52. stop()
    53. structuredClone()
    54. webkitConvertPointFromNodeToPage()
    55. webkitConvertPointFromPageToNode()
  4. Events
    1. afterprint
    2. appinstalled
    3. beforeinstallprompt
    4. beforeprint
    5. beforeunload
    6. blur
    7. devicemotion
    8. deviceorientation
    9. deviceorientationabsolute
    10. error
    11. focus
    12. gamepadconnected
    13. gamepaddisconnected
    14. hashchange
    15. languagechange
    16. load
    17. message
    18. messageerror
    19. offline
    20. online
    21. orientationchange
    22. pagehide
    23. pagereveal
    24. pageshow
    25. pageswap
    26. popstate
    27. rejectionhandled
    28. resize
    29. scrollsnapchange
    30. scrollsnapchanging
    31. storage
    32. unhandledrejection
    33. unload
    34. vrdisplayactivate
    35. vrdisplayconnect
    36. vrdisplaydeactivate
    37. vrdisplaydisconnect
    38. vrdisplaypresentchange
  5. Vererbung
    1. EventTarget

Der Bauplan für ein besseres Internet.

MDN Mitmachen Entwicklung

Besuche die gemeinnützige Muttergesellschaft der Mozilla Corporation, die Mozilla Foundation.
Teile dieses Inhalts sind ©1998–2026 von einzelnen mozilla.org-Mitwirkenden. Inhalte sind verfügbar unter einer Creative-Commons-Lizenz.