[12] History インターフェイス の scrollRestoration IDL属性 は、履歴 操作の後スクロール位置 を利用者エージェント が自動的に復元するべきか、
著者 のスクリプト に任せるべきかを表すものです。
[13] 通常はページ遷移が発生すると、その時点でのスクロール位置 が保存され、
次に履歴移動で戻ってきた際にそれが復元されます。しかしこの属性 を
manual Webアプリケーション では、
利用者エージェント に任せるよりも著者 のスクリプト で復元作業を行った方が良いことがあります。
仕様書 [1] HTML Standard (2015-11-17 17:58:32 +09:00 版) https://html.spec.whatwg.org/#scroll-restoration-mode [9] HTML Standard (2015-11-17 17:58:32 +09:00 版) https://html.spec.whatwg.org/#scrollrestoration [3] HTML Standard (2015-11-17 17:58:32 +09:00 版) https://html.spec.whatwg.org/#dom-history-scroll-restoration 意味 [14] 利用者エージェント によるスクロール位置 の復元は、
利用者 の利便性を向上させるための機能です。著者 は、
スクロール復元モード を濫用してスクロール位置 の復元を無効化したり、
意図的に異なる位置を表示したりするべきではありません。
[31]
多くの場合、 Webブラウザー は利用者 の行動を踏まえて最適な方法でスクロール位置 を復元できます。
Webアプリケーション の著者 が安易にこの挙動を無効化するべきではありません。
スクロール復元モード [2] セッション履歴エントリー のスクロール復元モードscroll restoration mode セッション履歴エントリー へと履歴を探索 した際に、
(あれば) 保存していたスクロール位置 を利用者エージェント が自動的に復元するべきかどうかを表します
>>1
[5] スクロール復元モード は、 auto manual >>3 列挙型 ScrollRestoration >>9
[6] auto スクロール位置 の復元を利用者エージェント が行うべきことを表します
>>3
[7] manual スクロール位置 の復元をページ が行い利用者エージェント が行うべきではないことを表します >>3
[28] なお、これは復元を行わないというだけで、原点 を表示するよう指示するのとは異なります
>>3 navigate の種別やキャッシュ 戦略などによって >>3 原点 以外が指された状態になっている場合があります。[4] スクロール復元モード の既定値は、 auto >>3
[16] 新しい文書 への navigate では、 auto 文書 の素片識別子 への navigate や pushState replaceState セッション履歴エントリー が作られる場合は、
現在値が引き継がれます。
navigate 、pushState [17] この値は、持続的利用者状態の復元 の際に参照されます。
取得器 [8] History インターフェイス の scrollRestoration 属性 は、取得時 、次のようにしなければなりません >>3
[19] 文脈オブジェクト の文書 完全に活性 でないなら、[20] SecurityError 例外 を投げ ます。[21] それ以外なら、[22] セッション履歴 の現在エントリー スクロール復元モード 設定器 [11] History インターフェイス の scrollRestoration 属性 は、設定時 、次のようにしなければなりません >>3
[23] 文脈オブジェクト の文書 完全に活性 でないなら、[24] SecurityError 例外 を投げ ます。[25] それ以外なら、[26] セッション履歴 の現在エントリー スクロール復元モード [10] この属性 の WebIDL の型 は、 ScrollRestoration >>9 manual auto
歴史 [15] Add scroll restoration preference to history traversal · whatwg/html@dd6a34e (2015-11-17 21:03:22 +09:00 版) https://github.com/whatwg/html/commit/dd6a34ec3c191ee1968a0fc8d174b4ce3b615916 [18] Tidy up history object API definitions · whatwg/html@a5d4802
(2015-12-01 11:58:03 +09:00 版)
https://github.com/whatwg/html/commit/a5d48020d6f83d4d2719dbdbf62f5bb8be8ef2f8
[27] Clarify manual scroll restoration mode · whatwg/html@017a842
(2015-12-19 11:05:16 +09:00 版)
https://github.com/whatwg/html/commit/017a842ec6c63e6ed4f26f77da41270688eab33e
[29] Move scroll position restoration after popstate
( (domenic 著, 2016-05-28 03:46:12 +09:00 ))
https://github.com/whatwg/html/commit/98895af2179ad879da9fa57983ab9589251f7950
[30] Release Notes for Safari Technology Preview 26 | WebKit
(2017-04-19 00:12:53 +09:00 )
https://webkit.org/blog/7474/release-notes-for-safari-technology-preview-26/
[32] New WebKit Features in Safari 11 | WebKit
(2017-09-26 23:25:00 +09:00 )
https://webkit.org/blog/7956/new-webkit-features-in-safari-11/
[33] Editorial: nested browsing context is a member, not a type
(annevk , 2019-11-27 02:46:03 +09:00 , 2022-01-18T09:57:48.000Z )
https://github.com/whatwg/html/commit/6b737bbc428facf34ec3728c0912cf9e172d0ea4