CKTIS / JavaScript
Document.hidden — zjištění viditelnosti dokumentu
Document.hidden je vlastnost pouze pro čtení, která udává, zda prohlížeč považuje dokument za skrytý. Změny lze sledovat pomocí visibilitychange.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
document.hiddenDocument.hidden, čtené jako document.hidden, vrací true, když platí document.visibilityState === "hidden"; jinak vrací false. Samotné čtení stránku neskryje.
Viditelnost určuje prohlížeč a zohledňuje přitom mimo jiné kartu na pozadí nebo minimalizované okno. Nezaměňuj tuto vlastnost za HTMLElement.hidden, která řídí skrytý stav prvku.
Na objektu document naslouchej události visibilitychange a vlastnost znovu přečti. Příklad zobrazí počáteční stav viditelnosti aktuální stránky v odstavci status a při každé změně viditelnosti tento odstavec aktualizuje. Do konzole vypíše pouze hodnotu hidden samostatně vytvořeného dokumentu, který není připojen k aktuální stránce. Jde o webové API popsané v HTML Standard, nikoli o funkci ECMAScript; přítomnost Node 24 nedokládá jeho dostupnost.
Pří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ýsledek
Detached document.hidden: true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.