CKTIS / JavaScript
visibilitychange — wijzigingen in de zichtbaarheid van het document
De visibilitychange-gebeurtenis meldt een wijziging in de zichtbaarheid van het document. Lees de huidige status uit met document.visibilityState.
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.addEventListener("visibilitychange", handler);visibilitychange is een gebeurtenis op document die wordt geactiveerd nadat de zichtbaarheidsstatus ervan verandert. document.visibilityState geeft "visible" of "hidden" terug; document.hidden is het booleaanse equivalent van de tweede waarde.
De browser bepaalt de zichtbaarheid, bijvoorbeeld wanneer je naar een ander tabblad gaat of een venster minimaliseert. De gebeurtenis bubbelt omhoog. Je kunt deze gebruiken om onnodig werk op een verborgen pagina te beperken.
Het voorbeeld activeert met dispatchEvent één synthetische visibilitychange-gebeurtenis, zonder van tabblad te wisselen of de zichtbaarheid van het document te wijzigen. De listener is geregistreerd met once: true en wordt dus maar één keer uitgevoerd. In de console duidt de listener de gebeurtenis aan als synthetic en toont hij het booleaanse resultaat (true) van de controle of document.visibilityState gelijk is aan "visible" of "hidden", niet de zichtbaarheidsstatus zelf.
Voorbeelden
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Testing a visibilitychange listener</title>
</head>
<body>
<script>
document.addEventListener('visibilitychange', (event) => {
// In normal use, read the current state when the browser fires this event.
const state = document.visibilityState;
const valid = state === 'visible' || state === 'hidden';
console.log(`${event.type} (${event.isTrusted ? 'browser' : 'synthetic'}): valid visibilityState = ${valid}`);
}, { once: true });
// Exercise the listener without switching tabs or changing visibility.
document.dispatchEvent(new Event('visibilitychange'));
</script>
</body>
</html>Resultaat
visibilitychange (synthetic): valid visibilityState = 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.