Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

visibilitychange — spremembe vidnosti dokumenta

Dogodek visibilitychange sporoča spremembo vidnosti dokumenta. Trenutno stanje lahko preberete z document.visibilityState.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

document.addEventListener("visibilitychange", handler);

visibilitychange je dogodek objekta document, ki se sproži po spremembi njegovega stanja vidnosti. document.visibilityState vrne "visible" ali "hidden"; document.hidden je logična ustreznica druge vrednosti.

Vidnost določa brskalnik, na primer ob preklopu na drug zavihek ali minimiziranju okna. Dogodek se širi navzgor. Uporabite ga lahko za zmanjšanje nepotrebnega dela na skriti strani.

Primer z dispatchEvent sproži en sintetični dogodek visibilitychange, ne da bi preklopil na drug zavihek ali spremenil vidnost dokumenta. Funkcija za obravnavo dogodka se izvede samo enkrat, saj je registrirana z možnostjo once: true. V konzoli označi dogodek kot synthetic in izpiše logični rezultat (true) preverjanja, ali je vrednost document.visibilityState enaka "visible" ali "hidden". Samega stanja vidnosti ne izpiše.

Primeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Testing a visibilitychange listener</title>
</head>
<body>
<script>
  document.addEventListener('visibilitychange', (event) => {
    // In normal use, read the current state when the browser fires this event.
    const state = document.visibilityState;
    const valid = state === 'visible' || state === 'hidden';
    console.log(`${event.type} (${event.isTrusted ? 'browser' : 'synthetic'}): valid visibilityState = ${valid}`);
  }, { once: true });

  // Exercise the listener without switching tabs or changing visibility.
  document.dispatchEvent(new Event('visibilitychange'));
</script>
</body>
</html>

Rezultat

visibilitychange (synthetic): valid visibilityState = true

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri