CKTIS / JavaScript
Viditelnost dokumentu: `Document.hidden` a `visibilitychange`
Pomocí `document.hidden` zjistíš aktuální viditelnost dokumentu a pomocí `visibilitychange` můžeš reagovat na změny bez opakovaných kontrol.
Verze: Current web platform; runtime support varies
Syntaxe
document.hidden
document.visibilityState
document.addEventListener("visibilitychange", listener)
document.removeEventListener("visibilitychange", listener)document.hidden je booleovská vlastnost pouze pro čtení. Má hodnotu true, když je document.visibilityState rovno "hidden", a false, když je rovno "visible". Karta na pozadí nebo minimalizované okno jsou běžné případy, kdy je dokument skrytý. Stav neříká, jestli je stránka zaměřená, jestli je vidět konkrétní prvek ani jestli se někdo na stránku dívá.
Po změně stavu v kterémkoli směru prohlížeč vyvolá událost visibilitychange na objektu document. Jde o obyčejnou událost Event, která probublává a nelze ji zrušit. Nový stav neobsahuje, proto vlastnost přečti v obslužné funkci. Registrace funkci hned nezavolá, takže počáteční stav přečti zvlášť. Pro odebrání obsluhy předej stejnou funkci metodě removeEventListener.
Můžeš třeba pozastavit zbytečné aktualizace rozhraní, když je dokument skrytý, a obnovit je, jakmile je znovu viditelný. Přechod na "hidden" neznamená, že se stránka zavřela. Nespoléhej ani na to, že prohlížeč nechá kód dokončit práci. Jde o API webové platformy, nikoli o součást ECMAScriptu. Dostupnost závisí na prostředí, ve kterém kód běží.
Pří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ýsledek
visible hidden visible
Spusť kód jednou v konzoli prohlížeče na viditelné stránce. Přepni na jinou kartu a pak se vrať. Uvedený výstup předpokládá přesně tyto dvě změny po počátečním čtení. Pro ukončení výpisu zavolej `stopVisibilityLog()`. V Node.js příklad simuluje změny viditelnosti bez použití dokumentu prohlížeče.
Související lekce
- JavaScript · Lekce 27 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 29 · Středně pokročilá · Verze: 3
- JavaScript · Lekce 31 · Středně pokročilá · Verze: 3