Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła