CKTIS / JavaScript
visibilitychange — promjene vidljivosti dokumenta
Događaj visibilitychange označava promjenu vidljivosti dokumenta. Trenutačno stanje možete pročitati pomoću document.visibilityState.
Verzija: 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 događaj objekta document koji se aktivira nakon promjene njegova stanja vidljivosti. document.visibilityState vraća "visible" ili "hidden"; document.hidden je logički ekvivalent druge vrijednosti.
Vidljivost određuje preglednik, primjerice pri prelasku na drugu karticu ili minimiziranju prozora. Događaj se širi prema gore. Možete ga upotrijebiti za smanjenje nepotrebnog rada na skrivenoj stranici.
Primjer pomoću dispatchEvent pokreće jedan sintetički događaj visibilitychange, bez prelaska na drugu karticu ili promjene vidljivosti dokumenta. Funkcija za obradu događaja izvršava se samo jednom jer je registrirana s opcijom once: true. U konzoli označava događaj kao synthetic i ispisuje logički rezultat (true) provjere je li vrijednost document.visibilityState jednaka "visible" ili "hidden". Ne ispisuje samo stanje vidljivosti.
Primjeri
<!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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.