Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

onpageswap — gérer un document sortant pendant la navigation

L’attribut onpageswap sur body définit le gestionnaire Window de l’événement pageswap. Cet événement concerne le document sortant pendant une navigation ; il ne signale pas l’apparition d’une nouvelle page.

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

Syntaxe

<body onpageswap="JavaScript statements">

onpageswap est un attribut de contenu qui contient du code JavaScript pour gérer l’événement pageswap. Sur l’élément body, il configure le gestionnaire de Window, et non un gestionnaire indépendant de cet élément. Ce n’est pas un attribut booléen : sa valeur est du code, et le paramètre event fournit l’événement.

Le navigateur peut déclencher pageswap sur la fenêtre du document sortant lorsque la navigation fait que ce document cesse d’être actif. Le document n’a pas besoin d’être déchargé : l’événement peut aussi se déclencher lorsque le navigateur conserve le document dans le cache de navigation arrière et avant (bfcache). L’événement réel utilise l’interface PageSwapEvent ; sa propriété viewTransition peut fournir une transition de vue ou valoir null. Ne confondez pas cet événement avec pagereveal, qui concerne le début du rendu d’un document. pageswap ne permet pas d’annuler une navigation.

L’attribut sur body et la propriété window.onpageswap configurent le même gestionnaire : affecter une nouvelle fonction remplace la précédente. L’alternative window.addEventListener('pageswap', handler) ajoute des gestionnaires indépendants sans remplacer cette propriété. Une Content Security Policy peut bloquer le code dans les attributs ; utilisez alors un script externe autorisé.

Le script de l’exemple affiche uniquement les résultats de deux vérifications dans la console : si body possède l’attribut onpageswap et si window expose la propriété onpageswap. Le script ne déclenche aucun événement et ne lance aucune navigation ; le résultat ne confirme donc pas que le gestionnaire défini dans l’attribut s’exécute.

Exemples

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

Résultat

onpageswap attribute present: true
onpageswap event property available: true

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources