Element.scrollIntoView()

構文

element.scrollIntoView();
element.scrollIntoView(alignToTop); // 論理型の引数
element.scrollIntoView(scrollIntoViewOptions); // オブジェクト型の引数

引数

alignToTop Optional

Boolean 値です。

• true の場合、要素の上端がスクロール可能な祖先の表示範囲の上端に来るようにスクロールします。 scrollIntoViewOptions: {block: "start", inline: "nearest"} に相当します。これが既定値です。
• false の場合、要素の下端がスクロール可能祖先の表示範囲の下端に来るようにスクロールします。 scrollIntoViewOptions: {block: "end", inline: "nearest"} に相当します。

scrollIntoViewOptions Optional

以下のプロパティを持つオブジェクトです。

behavior Optional

推移のアニメーションを定義します。
auto または smooth のどちらかです。既定値は auto です。

block Optional

垂直方向の配置を定義します。
start, center, end, nearest の何れかです。既定値は start です。

inline Optional

水平方法の配置を定義します。
start, center, end, nearest の何れかです。既定値は nearest です。

例

var element = document.getElementById("box");

element.scrollIntoView();
element.scrollIntoView(false);
element.scrollIntoView({block: "end"});
element.scrollIntoView({behavior: "smooth", block: "end", inline: "nearest"});

メモ

他の要素のレイアウトによっては、要素の上部または下部まで完全にスクロールされない場合があります。

仕様書

ブラウザーの互換性

関連情報

• Element.scrollIntoViewIfNeeded()