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