From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../api/windoweventhandlers/onpopstate/index.html | 85 ++++++++++++++++++++++ 1 file changed, 85 insertions(+) create mode 100644 files/ja/web/api/windoweventhandlers/onpopstate/index.html (limited to 'files/ja/web/api/windoweventhandlers/onpopstate') diff --git a/files/ja/web/api/windoweventhandlers/onpopstate/index.html b/files/ja/web/api/windoweventhandlers/onpopstate/index.html new file mode 100644 index 0000000000..3063f71af1 --- /dev/null +++ b/files/ja/web/api/windoweventhandlers/onpopstate/index.html @@ -0,0 +1,85 @@ +--- +title: WindowEventHandlers.onpopstate +slug: Web/API/WindowEventHandlers/onpopstate +tags: + - API + - DOM + - Event Handler + - HTML DOM + - HTML5 + - Window + - WindowEventHandlers + - onpopstate + - イベント + - プロパティ +translation_of: Web/API/WindowEventHandlers/onpopstate +--- +
{{APIRef}}
+ +

{{domxref("WindowEventHandlers")}} ミックスインの onpopstate プロパティは、ウィンドウの popstate イベントを処理するための {{domxref("EventHandler")}} です。

+ +

popstate イベントは、同じ文書の2つの履歴項目の間で、アクティブな履歴項目が変わるたびにウィンドウに発行されます。アクティブな履歴項目が history.pushState() を呼び出したことで作成されたり、 history.replaceState() を呼び出したことで影響されたりした場合、 popstate イベントの state プロパティが履歴項目の状態オブジェクトのコピーを保持します。

+ +
+

メモ: history.pushState() 又は history.replaceState() を呼び出すことは、 popstate イベントのトリガーにはなりません。 popstate イベントは、戻るボタンをクリックしたり (又は JavaScript で history.back() を呼び出したり)、同じ文書で2つの履歴項目間を移動したりするように、ブラウザーのアクションを実行することのみがトリガーになります。

+
+ +

構文

+ +
window.onpopstate = funcRef;
+
+ + + +

+ +

例えば、http://example.com/example.html のページで次のコードを実行すると、示されているようにアラートを生成します。

+ +
window.onpopstate = function(event) {
+  alert("location: " + document.location + ", state: " + JSON.stringify(event.state));
+};
+
+history.pushState({page: 1}, "title 1", "?page=1");
+history.pushState({page: 2}, "title 2", "?page=2");
+history.replaceState({page: 3}, "title 3", "?page=3");
+history.back(); // alerts "location: http://example.com/example.html?page=1, state: {"page":1}"
+history.back(); // alerts "location: http://example.com/example.html, state: null
+history.go(2);  // alerts "location: http://example.com/example.html?page=3, state: {"page":3}
+
+ +

なお、元の履歴項目 (http://example.com/example.html の場合) には関連付けられる状態オブジェクトがありませんが、それでも2回目の history.back() の呼び出し後に項目がアクティブになったとき、 popstate イベントが発行されます。

+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName('HTML WHATWG', 'webappapis.html#handler-window-onpopstate', 'onpopstate')}}{{Spec2('HTML WHATWG')}}
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.WindowEventHandlers.onpopstate")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf