Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Vidljivost dokumenta: `Document.hidden` i `visibilitychange`

Pročitaj trenutačnu vidljivost dokumenta pomoću `document.hidden` i reagiraj na promjene pomoću `visibilitychange` bez ponovljenih provjera.

Verzija: Current web platform; runtime support varies

Sintaksa

document.hidden
 document.visibilityState
 document.addEventListener("visibilitychange", listener)
 document.removeEventListener("visibilitychange", listener)

document.hidden je logičko svojstvo samo za čitanje. Ima vrijednost true kad je document.visibilityState jednak "hidden", a false kad je jednak "visible". Kartica u pozadini ili minimizirani prozor uobičajeni su slučajevi u kojima je dokument skriven. Stanje ne govori ima li stranica fokus, vidi li se određeni element ni gleda li netko stranicu.

Nakon promjene stanja u bilo kojem smjeru preglednik pokreće visibilitychange na objektu document. To je običan Event koji se širi prema gore i ne može se otkazati. Ne sadrži novo stanje, pa svojstvo pročitaj u funkciji koja obrađuje događaj. Registracija ne poziva funkciju odmah, stoga početno stanje pročitaj zasebno. Za uklanjanje slušača proslijedi istu funkciju metodi removeEventListener.

Možeš, primjerice, pauzirati nepotrebna ažuriranja sučelja dok je dokument skriven i nastaviti ih kad ponovno postane vidljiv. Prijelaz u "hidden" ne znači da je stranica zatvorena. Nemoj računati ni na to da će preglednik kodu dati vremena da dovrši posao. To je API web-platforme, a ne dio ECMAScripta. Dostupnost ovisi o izvršnom okruženju.

Primjeri

const stopVisibilityLog = (() => {
  const hasDocument = typeof document !== "undefined";
  const page = hasDocument ? document : new EventTarget();
  let simulatedHidden = false;

  if (!hasDocument) {
    // Node.js fixture: simulate visibility without a browser document.
    Object.defineProperty(page, "hidden", { get: () => simulatedHidden });
  }

  const logVisibility = () => {
    console.log(page.hidden ? "hidden" : "visible");
  };

  page.addEventListener("visibilitychange", logVisibility);
  logVisibility();

  const stop = () => {
    page.removeEventListener("visibilitychange", logVisibility);
  };

  if (!hasDocument) {
    const changeVisibility = (hidden) => {
      simulatedHidden = hidden;
      page.dispatchEvent(new Event("visibilitychange", { bubbles: true }));
    };

    changeVisibility(true);
    changeVisibility(false);
    stop();
    changeVisibility(true); // No log after removing the listener.
  }

  return stop;
})();

Rezultat

visible
hidden
visible

Pokreni kôd jednom u konzoli preglednika za vidljivu stranicu. Prijeđi na drugu karticu pa se vrati. Prikazani ispis pretpostavlja točno te dvije promjene nakon početnog očitanja. Za prekid ispisa pozovi `stopVisibilityLog()`. U okruženju Node.js primjer simulira promjene vidljivosti bez upotrebe dokumenta preglednika.

Povezane lekcije

  • JavaScript · Lekcija 27 · Srednje · Verzija: 3
  • JavaScript · Lekcija 29 · Srednje · Verzija: 3
  • JavaScript · Lekcija 31 · Srednje · Verzija: 3

Izvori