title | short-title | slug | l10n | ||
---|---|---|---|---|---|
Element: scrollTo() メソッド |
scrollTo() |
Web/API/Element/scrollTo |
|
{{APIRef}}
scrollTo()
は {{domxref("Element")}} インターフェイスのメソッドで、指定された要素内を指定された座標までスクロールします。
scrollTo(x-coord, y-coord)
scrollTo(options)
x-coord
は、要素の水平軸上で左上に表示したいピクセルです。y-coord
は、要素の垂直軸状で左上に表示したいピクセルです。
- または -
options
- : 以下の引数を含む辞書オブジェクトです。
top
- : ウィンドウまたは要素をスクロールする Y 軸方向のピクセル数を指定します。
left
- : ウィンドウまたは要素をスクロールする X 軸方向のピクセル数を指定します。
behavior
- : スクロールを即座に行うか、滑らかにアニメーションさせるかを決定します。このオプションは文字列であり、以下のいずれかの値を取ります。
smooth
: スクロールをスムーズなアニメーションで行うinstant
: スクロールを単一のジャンプで即座に行うauto
: スクロールの動作を {{cssxref("scroll-behavior")}} の計算値によって指定する
- : スクロールを即座に行うか、滑らかにアニメーションさせるかを決定します。このオプションは文字列であり、以下のいずれかの値を取ります。
- : 以下の引数を含む辞書オブジェクトです。
なし ({{jsxref("undefined")}})。
element.scrollTo(0, 1000);
options
を使用する場合:
element.scrollTo({
top: 100,
left: 100,
behavior: "smooth",
});
{{Specifications}}
{{Compat}}
- {{domxref("Element.scrollTop")}}, {{domxref("Element.scrollLeft")}}
- {{domxref("Window.scrollTo()")}}