Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje