CKTIS / HTML
onoffline — gestire l’evento di passaggio offline
L’attributo onoffline su body imposta un gestore per l’evento offline dell’oggetto Window. Permette a una pagina di reagire quando il browser segnala una perdita di connettività, ma non verifica se un server specifico è raggiungibile.
Versione: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintassi
<body onoffline="JavaScript statements">onoffline è un attributo gestore di eventi: il suo valore è codice JavaScript, non un valore booleano. Se inserito su body, gestisce l’evento offline dell’oggetto Window, non un evento che riguarda soltanto l’elemento body.
Il browser accoda un evento offline quando navigator.onLine cambia da true a false. Impostare l’attributo non verifica lo stato iniziale. Leggi navigator.onLine durante l’inizializzazione; usa ononline per reagire al cambiamento opposto.
Questo segnale non verifica se un server è raggiungibile. Il valore true non garantisce l’accesso a Internet e gli errori delle richieste devono essere gestiti separatamente. Non disattivare funzionalità essenziali basandoti soltanto su questo indicatore.
Un’alternativa all’attributo è window.addEventListener('offline', handler), che separa JavaScript da HTML e permette di registrare più listener. Una Content Security Policy può bloccare il codice del gestore scritto direttamente in un attributo.
Esempi
<!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>Risultato
offline event received
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.