CKTIS / JavaScript
visibilitychange — změny viditelnosti dokumentu
Událost visibilitychange oznamuje změnu viditelnosti dokumentu. Aktuální stav zjistíte pomocí document.visibilityState.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
document.addEventListener("visibilitychange", handler);visibilitychange je událost objektu document, která se vyvolá po změně jeho stavu viditelnosti. document.visibilityState vrací "visible" nebo "hidden"; document.hidden je booleovským ekvivalentem druhé hodnoty.
Viditelnost určuje prohlížeč, například při přepnutí na jinou kartu nebo minimalizaci okna. Událost se šíří směrem vzhůru. Můžete ji využít k omezení zbytečné práce na skryté stránce.
Příklad pomocí dispatchEvent vyvolá jednu syntetickou událost visibilitychange, aniž by se přepínalo mezi kartami nebo měnila viditelnost dokumentu. Obslužná funkce se spustí jen jednou, protože je zaregistrovaná s volbou once: true. V konzoli označí událost jako synthetic a vypíše booleovský výsledek (true) kontroly, zda má document.visibilityState hodnotu "visible" nebo "hidden". Samotný stav viditelnosti nevypisuje.
Pří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ýsledek
visibilitychange (synthetic): valid visibilityState = true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.