Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / HTML

onpageswap — obsluha odchádzajúceho dokumentu počas navigácie

Atribút onpageswap na body nastavuje obslužnú funkciu Window pre udalosť pageswap. Táto udalosť sa týka odchádzajúceho dokumentu počas navigácie; neoznamuje zobrazenie novej stránky.

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

Syntax

<body onpageswap="JavaScript statements">

onpageswap je obsahový atribút obsahujúci kód JavaScriptu na obsluhu udalosti pageswap. Na prvku body nastavuje obsluhu objektu Window, nie samostatnú obsluhu tohto prvku. Nie je to booleovský atribút: jeho hodnota je kód a parameter event sprístupňuje udalosť.

Prehliadač môže odoslať udalosť pageswap oknu opúšťaného dokumentu, keď dokument v dôsledku navigácie prestáva byť aktívny. Dokument sa nemusí uvoľniť z pamäte: udalosť môže nastať aj vtedy, keď ho prehliadač ponechá vo vyrovnávacej pamäti na navigáciu späť a dopredu (bfcache). Skutočná udalosť používa rozhranie PageSwapEvent; jej vlastnosť viewTransition môže sprístupniť prechod zobrazenia alebo mať hodnotu null. Nezamieňajte si túto udalosť s pagereveal, ktorá sa týka začiatku vykresľovania dokumentu. pageswap neslúži na zrušenie navigácie.

Atribút na body a vlastnosť window.onpageswap nastavujú rovnakú obsluhu: priradenie novej funkcie nahradí predchádzajúcu. Alternatíva window.addEventListener('pageswap', handler) pridáva nezávislé obsluhy bez toho, aby túto vlastnosť nahrádzala. Zásady Content Security Policy môžu blokovať kód v atribútoch; v takom prípade použite povolený externý skript.

Skript v príklade vypisuje do konzoly len výsledky dvoch kontrol: či má prvok body atribút onpageswap a či objekt window sprístupňuje vlastnosť onpageswap. Skript nevyvoláva žiadnu udalosť ani nespúšťa navigáciu, takže výstup nepotvrdzuje, že sa obslužná funkcia definovaná v atribúte vykoná.

Prí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ýsledok

onpageswap attribute present: true
onpageswap event property available: true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje