Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / HTML

onpageswap — obsluha odcházejícího dokumentu během navigace

Atribut onpageswap na body nastavuje obslužnou funkci Window pro událost pageswap. Tato událost se týká odcházejícího dokumentu během navigace; neoznamuje zobrazení nové stránky.

Verze: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

<body onpageswap="JavaScript statements">

onpageswap je obsahový atribut obsahující kód JavaScriptu pro obsluhu události pageswap. Na prvku body nastavuje obsluhu objektu Window, nikoli samostatnou obsluhu tohoto prvku. Není to booleovský atribut: jeho hodnota je kód a parametr event zpřístupňuje událost.

Prohlížeč může odeslat událost pageswap oknu opouštěného dokumentu, když dokument v důsledku navigace přestává být aktivní. Dokument se nemusí uvolnit z paměti: událost může nastat i tehdy, když jej prohlížeč ponechá v mezipaměti pro navigaci zpět a vpřed (bfcache). Skutečná událost používá rozhraní PageSwapEvent; její vlastnost viewTransition může zpřístupnit přechod zobrazení, nebo mít hodnotu null. Nezaměňujte tuto událost s pagereveal, která se týká začátku vykreslování dokumentu. pageswap neslouží ke zrušení navigace.

Atribut na body a vlastnost window.onpageswap nastavují stejnou obsluhu: přiřazení nové funkce nahradí předchozí. Alternativa window.addEventListener('pageswap', handler) přidává nezávislé obsluhy, aniž by tuto vlastnost nahrazovala. Zásady Content Security Policy mohou blokovat kód v atributech; v takovém případě použijte povolený externí skript.

Skript v příkladu vypisuje do konzole pouze výsledky dvou kontrol: zda má prvek body atribut onpageswap a zda objekt window zpřístupňuje vlastnost onpageswap. Skript nevyvolává žádnou událost ani nezahajuje navigaci, takže výstup nepotvrzuje, že se obslužná funkce definovaná v atributu spustí.

Příklady

<!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>

Výsledek

onpageswap attribute present: true
onpageswap event property available: true

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje