CKTIS / JavaScript
Document.hidden — de zichtbaarheid van een document uitlezen
Document.hidden is een alleen-lezen eigenschap die aangeeft of de browser het document als verborgen beschouwt. Volg wijzigingen met visibilitychange.
Versie: 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, uitgelezen als document.hidden, geeft true terug wanneer document.visibilityState === "hidden"; anders geeft het false terug. Door de eigenschap uit te lezen, wordt de pagina niet verborgen.
De browser bepaalt de zichtbaarheid en houdt daarbij onder meer rekening met een tabblad op de achtergrond of een geminimaliseerd venster. Verwar deze eigenschap niet met HTMLElement.hidden, dat de verborgen toestand van een element regelt.
Luister naar visibilitychange op document en lees de eigenschap opnieuw uit. Het voorbeeld laat in de alinea status zien of de huidige pagina aanvankelijk zichtbaar is en werkt die alinea bij zodra de zichtbaarheid verandert. In de console verschijnt alleen de hidden-waarde van het apart aangemaakte document dat niet aan de huidige pagina is gekoppeld. Dit is een Web-API die in HTML Standard is beschreven, geen ECMAScript-functie; de aanwezigheid van Node 24 bewijst niet dat de API beschikbaar is.
Voorbeelden
<!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>Resultaat
Detached document.hidden: true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.