Window.scrollBy()
Window.scrollBy() メソッドは、ウィンドウ内の文書を指定された量だけスクロールさせます。
構文
js
scrollBy(x-coord, y-coord)
scrollBy(options)
引数
x-coordはスクロールさせたい水平方向のピクセル数です。y-coordはスクロールさせたい垂直方向のピクセル数です。
- または -
options-
以下の引数を含む辞書です。
top-
ウィンドウまたは要素をスクロールする Y 軸方向のピクセル数を指定します。
left-
ウィンドウまたは要素をスクロールする X 軸方向のピクセル数を指定します。
behavior-
スクロールを滑らかにアニメーションさせるか (
smooth)、瞬時に一回のジャンプで行うか (instant)、あるいはブラウザーに選択させるか (auto, 既定値) を指定することができます。
返値
なし (undefined)。
例
1 ページ分下スクロールさせるには、次のようにします。
js
window.scrollBy(0, window.innerHeight);
上スクロールさせるには、次のようにします。
js
window.scrollBy(0, -window.innerHeight);
options を使用します。
js
window.scrollBy({
top: 100,
left: 100,
behavior: 'smooth'
});
メモ
window.scrollBy() は特定の量だけスクロールしますが、 window.scroll() は文書内の絶対位置までスクロールします。 window.scrollByLines() および window.scrollByPages() も参照してください。
仕様書
| Specification |
|---|
| CSSOM View Module # dom-window-scrollby |
ブラウザーの互換性
BCD tables only load in the browser