Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes