CKTIS / JavaScript
visibilitychange — zmeny viditeľnosti dokumentu
Udalosť visibilitychange oznamuje zmenu viditeľnosti dokumentu. Aktuálny stav zistíte pomocou document.visibilityState.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
document.addEventListener("visibilitychange", handler);visibilitychange je udalosť objektu document, ktorá sa vyvolá po zmene jeho stavu viditeľnosti. document.visibilityState vracia "visible" alebo "hidden"; document.hidden je boolovským ekvivalentom druhej hodnoty.
Viditeľnosť určuje prehliadač, napríklad pri prepnutí na inú kartu alebo minimalizovaní okna. Udalosť sa šíri smerom nahor. Môžete ju použiť na obmedzenie zbytočnej práce na skrytej stránke.
Príklad pomocou dispatchEvent vyvolá jednu syntetickú udalosť visibilitychange bez prepínania kariet alebo zmeny viditeľnosti dokumentu. Obslužná funkcia sa spustí iba raz, pretože je zaregistrovaná s voľbou once: true. V konzole označí udalosť ako synthetic a vypíše boolovský výsledok (true) kontroly, či má document.visibilityState hodnotu "visible" alebo "hidden". Samotný stav viditeľnosti nevypisuje.
Príklady
<!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>Výsledok
visibilitychange (synthetic): valid visibilityState = true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.