Window.scrollBy()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

Window.scrollBy() メソッドは、ウィンドウ内の文書を指定された量だけスクロールさせます。

構文

scrollBy(x_coord, y_coord);
scrollBy(options);

- または -

以下の引数を含む辞書です。

top: ウィンドウまたは要素をスクロールする Y 軸方向のピクセル数を指定します。
left: ウィンドウまたは要素をスクロールする X 軸方向のピクセル数を指定します。
behavior: スクロールを滑らかにアニメーションさせるか (smooth)、瞬時に一回のジャンプで行うか (instant)、あるいはブラウザーに選択させるか (auto, 既定値) を指定することができます。

なし (undefined)。

1 ページ分下スクロールさせるには、次のようにします。

window.scrollBy(0, window.innerHeight);

上スクロールさせるには、次のようにします。

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

options を使用します。

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

window.scrollBy() は特定の量だけスクロールしますが、 window.scroll() は文書内の絶対位置までスクロールします。 window.scrollByLines() および window.scrollByPages() も参照してください。

Specification
CSSOM View Module # dom-window-scrollby

This page was last modified on ⁨2023年8月25日⁩ by MDN contributors.