KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / HTML

onpageswap — een uitgaand document afhandelen tijdens navigatie

Het attribuut onpageswap op body stelt de Window-handler in voor de gebeurtenis pageswap. Deze gebeurtenis betreft het uitgaande document tijdens navigatie; het is geen melding dat er een nieuwe pagina is verschenen.

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

Syntax

<body onpageswap="JavaScript statements">

onpageswap is een contentattribuut met JavaScript-code voor een handler van de gebeurtenis pageswap. Op het element body configureert het de handler op Window, niet een onafhankelijke handler op dat element. Het is geen booleaans attribuut: de waarde is code, waarbij de parameter event de gebeurtenis beschikbaar maakt.

De browser kan pageswap versturen naar het venster van het uitgaande document wanneer dat document door navigatie niet langer actief is. Het document hoeft daarvoor niet te worden ontladen: de gebeurtenis kan ook plaatsvinden als de browser het document bewaart in de cache voor terug- en vooruitnavigatie (bfcache). De echte gebeurtenis gebruikt de interface PageSwapEvent; de eigenschap viewTransition kan een view transition beschikbaar maken of de waarde null hebben. Verwar deze gebeurtenis niet met pagereveal, die betrekking heeft op het begin van de weergave van een document. pageswap is geen manier om navigatie te annuleren.

Het attribuut op body en de eigenschap window.onpageswap configureren dezelfde handler: een nieuwe functie toewijzen vervangt de vorige. Het alternatief window.addEventListener('pageswap', handler) voegt onafhankelijke handlers toe zonder die eigenschap te vervangen. Content Security Policy kan code in attributen blokkeren; gebruik dan een toegestaan extern script.

Het voorbeeldscript logt alleen de resultaten van twee controles: of body het attribuut onpageswap heeft en of de eigenschap onpageswap beschikbaar is op window. Het script verstuurt geen gebeurtenis en start geen navigatie. De uitvoer bevestigt dus niet dat de handler in het attribuut wordt uitgevoerd.

Voorbeelden

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

Resultaat

onpageswap attribute present: true
onpageswap event property available: true

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen