CKTIS / HTML
onoffline — tratar o evento de passagem para offline
O atributo onoffline em body define um processador para o evento offline do objeto Window. Permite que uma página reaja quando o navegador comunica uma perda de ligação, mas não verifica se um servidor específico está acessível.
Versão: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxe
<body onoffline="JavaScript statements">onoffline é um atributo de processamento de eventos: o seu valor é código JavaScript, não um valor booleano. Quando colocado em body, processa o evento offline do objeto Window, e não um evento relativo apenas ao elemento body.
O navegador coloca um evento offline na fila quando navigator.onLine muda de true para false. Definir o atributo não verifica o estado inicial. Lê navigator.onLine durante a inicialização; usa ononline para reagir à mudança oposta.
Este sinal não verifica se um servidor está acessível. O valor true não garante acesso à Internet, e as falhas dos pedidos têm de ser tratadas de forma independente. Não desatives funcionalidades essenciais apenas com base neste indicador.
Uma alternativa ao atributo é window.addEventListener('offline', handler), que separa JavaScript de HTML e permite registar vários ouvintes. Uma Content Security Policy pode bloquear código de processamento escrito diretamente num atributo.
Exemplos
<!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>Resultado
offline event received
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.