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.