CKTIS / JavaScript
Document.hidden — provjera vidljivosti dokumenta
Document.hidden je svojstvo samo za čitanje koje pokazuje smatra li preglednik dokument skrivenim. Promjene možeš pratiti pomoću događaja visibilitychange.
Verzija: 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, očitan kao document.hidden, vraća true kada vrijedi document.visibilityState === "hidden"; u suprotnom vraća false. Samo očitavanje ne skriva stranicu.
Preglednik određuje vidljivost uzimajući u obzir, među ostalim, karticu u pozadini ili minimizirani prozor. Nemoj brkati ovo svojstvo sa svojstvom HTMLElement.hidden, koje upravlja skrivenim stanjem elementa.
Slušaj događaj visibilitychange na objektu document i ponovno očitaj svojstvo. Primjer prikazuje početno stanje vidljivosti trenutačne stranice u odlomku status i ažurira taj odlomak pri svakoj promjeni vidljivosti. U konzolu ispisuje samo vrijednost svojstva hidden zasebno stvorenog dokumenta koji nije povezan s trenutačnom stranicom. Ovo je web API opisan u HTML Standard, a ne značajka ECMAScript; prisutnost Node 24 ne potvrđuje njegovu dostupnost.
Primjeri
<!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
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.