CKTIS / JavaScript
Document.hidden — zistenie viditeľnosti dokumentu
Document.hidden je vlastnosť iba na čítanie, ktorá udáva, či prehliadač považuje dokument za skrytý. Zmeny možno sledovať pomocou visibilitychange.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
document.hiddenDocument.hidden, čítané ako document.hidden, vracia true, keď platí document.visibilityState === "hidden"; inak vracia false. Samotné čítanie stránku neskryje.
Viditeľnosť určuje prehliadač a zohľadňuje pritom okrem iného kartu na pozadí alebo minimalizované okno. Nezamieňaj túto vlastnosť za HTMLElement.hidden, ktorá riadi skrytý stav prvku.
Na objekte document počúvaj udalosť visibilitychange a vlastnosť znova prečítaj. Príklad zobrazí počiatočný stav viditeľnosti aktuálnej stránky v odseku status a pri každej zmene viditeľnosti tento odsek aktualizuje. Do konzoly vypíše iba hodnotu hidden samostatne vytvoreného dokumentu, ktorý nie je pripojený k aktuálnej stránke. Ide o webové API opísané v HTML Standard, nie o funkciu ECMAScript; prítomnosť Node 24 nedokazuje jeho dostupnosť.
Príklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document.hidden</title>
</head>
<body>
<h1>Document visibility</h1>
<p id="status" role="status"></p>
<script>
const detached = document.implementation.createHTMLDocument('Detached example');
console.log('Detached document.hidden: ' + detached.hidden);
const status = document.getElementById('status');
function showVisibility() {
status.textContent = document.hidden ? 'This page is hidden.' : 'This page is visible.';
}
document.addEventListener('visibilitychange', showVisibility);
showVisibility();
</script>
</body>
</html>Výsledok
Detached document.hidden: true
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.