CKTIS / HTML
onpageswap — obsługa opuszczania dokumentu podczas nawigacji
Atrybut onpageswap na elemencie body ustawia procedurę obsługi zdarzenia pageswap obiektu Window. Zdarzenie dotyczy wychodzącego dokumentu podczas nawigacji; nie jest powiadomieniem o pojawieniu się nowej strony.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
<body onpageswap="JavaScript statements">onpageswap to atrybut treści zawierający kod JavaScript procedury obsługi zdarzenia pageswap. Umieszczony na elemencie body konfiguruje procedurę obiektu Window, a nie niezależną procedurę tego elementu. Nie jest atrybutem logicznym: jego wartość stanowi kod, w którym parametr event udostępnia zdarzenie.
Przeglądarka może wysłać zdarzenie pageswap do okna opuszczanego dokumentu, gdy dokument ten przestaje być aktywny wskutek nawigacji. Dokument nie musi zostać rozładowany: zdarzenie może wystąpić również wtedy, gdy przeglądarka zachowuje go w pamięci podręcznej nawigacji wstecz i dalej (bfcache). Rzeczywiste zdarzenie ma interfejs PageSwapEvent; jego właściwość viewTransition może udostępniać przejście widoku albo mieć wartość null. Nie należy mylić tego zdarzenia z pagereveal, które dotyczy rozpoczęcia wyświetlania dokumentu. pageswap nie służy do anulowania nawigacji.
Atrybut na body i właściwość window.onpageswap konfigurują tę samą procedurę: przypisanie nowej funkcji zastępuje poprzednią. Alternatywa window.addEventListener('pageswap', handler) pozwala dodawać niezależne procedury bez zastępowania tej właściwości. Polityka Content Security Policy może blokować kod w atrybutach; wtedy użyj dozwolonego skryptu zewnętrznego.
Skrypt w przykładzie wypisuje w konsoli tylko wyniki dwóch sprawdzeń: czy element body ma atrybut onpageswap i czy obiekt window udostępnia właściwość onpageswap. Skrypt nie wysyła żadnego zdarzenia ani nie inicjuje nawigacji, więc wynik nie potwierdza, że procedura obsługi zdefiniowana w atrybucie zostanie wywołana.
Przykłady
<!doctype html>
<html lang="en">
<head><meta charset="utf-8"><title>Body onpageswap handler</title></head>
<body onpageswap="document.body.dataset.received = event.type">
<script>
console.log('onpageswap attribute present: ' + document.body.hasAttribute('onpageswap'));
console.log('onpageswap event property available: ' + ('onpageswap' in window));
</script>
</body>
</html>
Wynik
onpageswap attribute present: true onpageswap event property available: true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.