このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docs コミュニティーについてもっと知り、仲間になるにはこちらから。

View in English Always switch to English

History: scrollRestoration プロパティ

Baseline 広く利用可能

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

scrollRestorationHistory インターフェイスのプロパティで、ウェブアプリケーションが履歴の移動の動作で既定のスクロール位置の復元を明示的に設定できるようにします。

以下のうちのいずれかです。

auto

ユーザーがスクロールしたページ上のスクロールの位置が復元されます。

manual

ページ上のスクロール位置は復元されません。ユーザーが手動でその位置までスクロールする必要があります。

現在のスクロール復元の動作を問い合わせる

js
const scrollRestoration = history.scrollRestoration;
if (scrollRestoration === "manual") {
  console.log(
    "ページ上の位置は復元されないので、ユーザーが手動でスクロールする必要があります。",
  );
}

自動的にページ上の位置の復元をしないようにする

js
if (history.scrollRestoration) {
  history.scrollRestoration = "manual";
}

仕様書

仕様書
HTML
# dom-history-scroll-restoration-dev

ブラウザーの互換性