CKTIS / HTML
onoffline — de offline-gebeurtenis afhandelen
Het onoffline-attribuut op body stelt een handler in voor de offline-gebeurtenis van het Window-object. Een pagina kan daarmee reageren wanneer de browser verbindingsverlies meldt, maar het controleert niet of een bepaalde server bereikbaar is.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
<body onoffline="JavaScript statements">onoffline is een attribuut voor gebeurtenisafhandeling: de waarde is JavaScript-code, geen booleaanse waarde. Op body handelt het de offline-gebeurtenis van het Window-object af, niet een gebeurtenis die alleen het element body betreft.
De browser zet een offline-gebeurtenis in de wachtrij wanneer navigator.onLine verandert van true in false. Het instellen van het attribuut controleert de beginstatus niet. Lees navigator.onLine uit bij het initialiseren; gebruik ononline om op de tegenovergestelde verandering te reageren.
Dit signaal controleert niet of een server bereikbaar is. De waarde true garandeert geen internettoegang en fouten bij verzoeken moeten afzonderlijk worden afgehandeld. Schakel essentiële functies niet alleen op basis van deze indicator uit.
Een alternatief voor het attribuut is window.addEventListener('offline', handler). Daarmee houd je JavaScript en HTML gescheiden en kun je meerdere luisteraars registreren. Een Content Security Policy kan handlercode blokkeren die rechtstreeks in een attribuut is geschreven.
Voorbeelden
<!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>Resultaat
offline event received
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.