Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onoffline — obsługa zdarzenia przejścia w tryb offline

Atrybut onoffline elementu body ustawia procedurę obsługi zdarzenia offline obiektu Window. Pozwala reagować na zgłoszoną przez przeglądarkę utratę łączności, ale nie sprawdza dostępności konkretnego serwera.

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

Składnia

<body onoffline="JavaScript statements">

onoffline to atrybut obsługi zdarzenia: jego wartością jest kod JavaScript, a nie wartość logiczna. Umieszczony na body obsługuje zdarzenie offline obiektu Window, nie zdarzenie dotyczące wyłącznie elementu body.

Przeglądarka kolejkuje zdarzenie offline, gdy navigator.onLine zmienia się z true na false. Samo ustawienie atrybutu nie sprawdza początkowego stanu. Odczytaj navigator.onLine podczas inicjalizacji; do reagowania na zmianę w przeciwnym kierunku służy ononline.

Ten sygnał nie jest testem dostępności serwera. Wartość true nie gwarantuje dostępu do Internetu, a błędy żądań trzeba obsługiwać niezależnie. Nie wyłączaj istotnych funkcji wyłącznie na podstawie tego wskaźnika.

Alternatywą dla atrybutu jest window.addEventListener('offline', handler), co oddziela JavaScript od HTML i pozwala rejestrować wiele procedur. Polityka Content Security Policy może blokować kod obsługi zapisany bezpośrednio w atrybucie.

Przykłady

<!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>

Wynik

offline event received

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła