Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Vidnost dokumenta: `Document.hidden` in `visibilitychange`

Z `document.hidden` preberi trenutno vidnost dokumenta in se z dogodkom `visibilitychange` odzovi na spremembe brez ponavljajočega se preverjanja.

Različica: Current web platform; runtime support varies

Sintaksa

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

document.hidden je logična lastnost samo za branje. Njena vrednost je true, ko je document.visibilityState enak "hidden", in false, ko je enak "visible". Zavihek v ozadju ali pomanjšano okno sta običajna primera, ko je dokument skrit. Stanje ne pove, ali ima stran fokus, ali je določen element viden ali ali kdo gleda stran.

Ko se stanje spremeni v katero koli smer, brskalnik na objektu document sproži visibilitychange. To je navaden Event, ki se širi navzgor in ga ni mogoče preklicati. Ne vsebuje novega stanja, zato lastnost preberi v funkciji za obravnavo dogodka. Registracija funkcije je ne pokliče takoj, zato začetno stanje preberi posebej. Če želiš poslušalca odstraniti, posreduj isto funkcijo metodi removeEventListener.

Medtem ko je dokument skrit, lahko na primer začasno ustaviš nepotrebne posodobitve vmesnika in jih nadaljuješ, ko je dokument spet viden. Prehod v "hidden" ne pomeni, da se je stran zaprla. Prav tako ne računaj, da bo brskalnik kodi dal čas za dokončanje dela. To je API spletne platforme in ne del ECMAScripta. Razpoložljivost je odvisna od izvajalnega okolja.

Primeri

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

Kodo enkrat zaženi v konzoli brskalnika na vidni strani. Preklopi na drug zavihek in se vrni. Prikazani izpis predpostavlja natanko ti dve spremembi po začetnem branju. Za ustavitev izpisovanja pokliči `stopVisibilityLog()`. V okolju Node.js primer simulira spremembe vidnosti brez uporabe dokumenta brskalnika.

Povezane lekcije

  • JavaScript · Lekcija 27 · Srednja · Različica: 3
  • JavaScript · Lekcija 29 · Srednja · Različica: 3
  • JavaScript · Lekcija 31 · Srednja · Različica: 3

Viri