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

CKTIS / HTML

onoffline — gérer l’événement de passage hors ligne

L’attribut onoffline sur body définit un gestionnaire pour l’événement offline de l’objet Window. Il permet à une page de réagir lorsque le navigateur signale une perte de connexion, mais ne vérifie pas si un serveur donné est accessible.

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

Syntaxe

<body onoffline="JavaScript statements">

onoffline est un attribut de gestion d’événement : sa valeur est du code JavaScript, et non une valeur booléenne. Placé sur body, il gère l’événement offline de l’objet Window, et non un événement concernant uniquement l’élément body.

Le navigateur met un événement offline en file d’attente lorsque navigator.onLine passe de true à false. Définir l’attribut ne vérifie pas l’état initial. Lis navigator.onLine lors de l’initialisation ; utilise ononline pour réagir au changement inverse.

Ce signal ne permet pas de vérifier si un serveur est accessible. La valeur true ne garantit pas l’accès à Internet, et les échecs de requêtes doivent être gérés séparément. Ne désactive pas de fonctionnalité essentielle uniquement sur la base de cet indicateur.

Une alternative à l’attribut est window.addEventListener('offline', handler), qui sépare le JavaScript du HTML et permet d’enregistrer plusieurs écouteurs. Une Content Security Policy peut bloquer le code de gestion écrit directement dans un attribut.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>onoffline demonstration</title>
</head>
<body onoffline="document.getElementById('status').textContent = 'offline event received'">
  <p id="status" role="status">waiting</p>
  <button id="simulate" type="button">Simulate offline event</button>
  <script>
    document.getElementById('simulate').addEventListener('click', () => {
      window.dispatchEvent(new Event('offline'));
    });
  </script>
</body>
</html>

Résultat

offline event received

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