Element: scrollTo() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年1月以降、すべてのブラウザーで利用可能です。
scrollTo() は Element インターフェイスのメソッドで、指定された要素内を指定された座標までスクロールします。
構文
js
scrollTo(x-coord, y-coord)
scrollTo(options)
引数
x-coordは、要素の水平軸上で左上に表示したいピクセルです。y-coordは、要素の垂直軸状で左上に表示したいピクセルです。
- または -
options-
以下の引数を含む辞書オブジェクトです。
top-
ウィンドウまたは要素をスクロールする Y 軸方向のピクセル数を指定します。
left-
ウィンドウまたは要素をスクロールする X 軸方向のピクセル数を指定します。
behavior-
スクロールを即座に行うか、滑らかにアニメーションさせるかを決定します。このオプションは文字列であり、以下のいずれかの値を取ります。
smooth: スクロールをスムーズなアニメーションで行うinstant: スクロールを単一のジャンプで即座に行うauto: スクロールの動作をscroll-behaviorの計算値によって指定する
返値
なし (undefined)。
例
js
element.scrollTo(0, 1000);
options を使用する場合:
js
element.scrollTo({
top: 100,
left: 100,
behavior: "smooth",
});
仕様書
| 仕様書 |
|---|
| CSSOM View Module # dom-element-scrollto |