Element: scrollBy() メソッド

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年1月以降、すべてのブラウザーで利用可能です。

scrollBy() は Element インターフェイスのメソッドで、指定された量だけ要素をスクロールします。

構文

scrollBy(x-coord, y-coord)
scrollBy(options)

- または -

以下の引数を持つ辞書です。

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

なし (undefined)。

// 要素をスクロール
element.scrollBy(300, 300);

options を使用する場合:

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

仕様書
CSSOM View Module # dom-element-scrollby

このページは MDN の貢献者によって 2023年7月26日に最終更新されました。