CKTIS / JavaScript
Document.hidden — preverjanje vidnosti dokumenta
Document.hidden je lastnost samo za branje, ki pove, ali brskalnik dokument obravnava kot skrit. Spremembe spremljaj z dogodkom visibilitychange.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
document.hiddenDocument.hidden, prebran kot document.hidden, vrne true, kadar velja document.visibilityState === "hidden"; sicer vrne false. Branje te lastnosti strani ne skrije.
Vidnost določi brskalnik, pri čemer med drugim upošteva zavihek v ozadju ali pomanjšano okno. Te lastnosti ne zamenjuj z HTMLElement.hidden, ki upravlja skrito stanje elementa.
Na objektu document poslušaj dogodek visibilitychange in lastnost znova preberi. Primer prikaže začetno stanje vidnosti trenutne strani v odstavku status in ta odstavek posodobi ob vsaki spremembi vidnosti. V konzolo izpiše samo vrednost hidden ločeno ustvarjenega dokumenta, ki ni povezan s trenutno stranjo. To je spletni API, opisan v HTML Standard, ne funkcija ECMAScript; prisotnost Node 24 ne potrjuje njegove razpoložljivosti.
Primeri
<!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>Rezultat
Detached document.hidden: true
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.