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

CKTIS / JavaScript

Viditeľnosť dokumentu: `Document.hidden` a `visibilitychange`

Pomocou `document.hidden` zisti aktuálnu viditeľnosť dokumentu a cez `visibilitychange` reaguj na zmeny bez opakovaného zisťovania stavu.

Verzia: Current web platform; runtime support varies

Syntax

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

document.hidden je logická vlastnosť určená len na čítanie. Má hodnotu true, keď je document.visibilityState rovné "hidden", a false, keď je rovné "visible". Karta na pozadí alebo minimalizované okno sú bežné prípady, keď je dokument skrytý. Stav nehovorí, či má stránka fokus, či je viditeľný konkrétny prvok ani či sa niekto na stránku pozerá.

Po zmene stavu v ktoromkoľvek smere prehliadač vyvolá visibilitychange na objekte document. Je to obyčajná udalosť Event, ktorá prebubláva a nedá sa zrušiť. Neobsahuje nový stav, preto vlastnosť prečítaj v obslužnej funkcii. Registrácia funkciu hneď nezavolá, takže počiatočný stav prečítaj zvlášť. Ak chceš obslužnú funkciu odobrať, odovzdaj tú istú funkciu metóde removeEventListener.

Môžeš napríklad pozastaviť zbytočné aktualizácie rozhrania, kým je dokument skrytý, a obnoviť ich, keď je znovu viditeľný. Prechod na "hidden" neznamená, že sa stránka zatvorila. Nespoliehaj sa ani na to, že prehliadač dá kódu čas dokončiť prácu. Ide o API webovej platformy, nie o súčasť ECMAScriptu. Dostupnosť závisí od prostredia, v ktorom kód beží.

Príklady

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;
})();

Výsledok

visible
hidden
visible

Spusti kód raz v konzole prehliadača na viditeľnej stránke. Prepni sa na inú kartu a potom sa vráť. Uvedený výstup predpokladá presne tieto dve zmeny po počiatočnom čítaní. Na zastavenie výpisu zavolaj `stopVisibilityLog()`. V Node.js príklad simuluje zmeny viditeľnosti bez použitia dokumentu prehliadača.

Súvisiace lekcie

  • JavaScript · Lekcia 27 · Stredne pokročilá · Verzia: 3
  • JavaScript · Lekcia 29 · Stredne pokročilá · Verzia: 3
  • JavaScript · Lekcia 31 · Stredne pokročilá · Verzia: 3

Zdroje