CKTIS / JavaScript
Een element op ID zoeken en reageren op documentzichtbaarheid
Zoek een element met `getElementById()`, lees de zichtbaarheid uit via `document.hidden` en werk de interface bij na een `visibilitychange`-event.
Versie: Current web platform; runtime support varies
Syntax
// Browser DOM and HTML APIs; support depends on the browser, not on the ECMAScript edition.
document.getElementById(id) // Element | null
// Read-only visibility properties:
document.hidden // boolean
document.visibilityState // "hidden" | "visible"
// Register and later remove the same listener:
document.addEventListener("visibilitychange", handler)
document.removeEventListener("visibilitychange", handler)document.getElementById(id) neemt de ID-waarde zonder # en is hoofdlettergevoelig. De methode geeft een overeenkomend Element in de documentboom terug, of null als er geen is. ID's moeten uniek zijn; bij dubbele ID's krijg je het eerste element in boomvolgorde. Zoek pas nadat het element is ingevoegd en controleer het resultaat voordat je eigenschappen leest: een eigenschap lezen op null veroorzaakt een TypeError.
document.hidden is een alleen-lezen boolean, gelijkwaardig aan document.visibilityState === "hidden". De toestand van het document is "hidden" of "visible" en kan veranderen als je bijvoorbeeld van tabblad wisselt. De toestand zegt niet of een bepaald element in het zichtbare deel van de pagina staat of dat de pagina focus heeft. HTMLElement.hidden geldt voor één element en verandert de zichtbaarheidstoestand van het document niet.
De browser vuurt visibilitychange op document af nadat de toestand is veranderd. Dit Event kan niet worden geannuleerd en bevat de nieuwe toestand niet; lees die in de handler uit op het document. Registreer de handler en roep die daarna één keer aan om de interface te initialiseren. Verwijder bij het opruimen van een component de listener van hetzelfde document met dezelfde functie en capture-instelling.
Pauzeer onnodig werk zolang het document verborgen is, maar zie die toestand niet als bewijs dat de pagina is verlaten, dat de gebruiker oplet of dat die bevoegd is. Dit zijn webplatform-API's, geen functies van ECMAScript 2024. Zonder browser-DOM is document mogelijk niet beschikbaar; ondersteuning verschilt per uitvoeringsomgeving.
Voorbeelden
(() => {
function mount(document) {
const id = "cktis-page-visibility-status";
const status = document.createElement("p");
status.id = id;
document.body.append(status);
function render(event) {
const element = document.getElementById(id);
if (element === null) return;
element.textContent = document.hidden ? "hidden" : "visible";
if (event) console.log(element.textContent);
}
document.addEventListener("visibilitychange", render);
render();
console.log("ready");
}
if (typeof document !== "undefined") {
mount(document);
return;
}
// Node.js fixture: model only the document operations used above.
class TestDocument extends EventTarget {
#elements = [];
#hidden = false;
body = { append: (element) => this.#elements.push(element) };
createElement(tagName) {
return { tagName, id: "", textContent: "" };
}
getElementById(id) {
return this.#elements.find((element) => element.id === id) ?? null;
}
get hidden() {
return this.#hidden;
}
setHidden(hidden) {
if (this.#hidden === hidden) return;
this.#hidden = hidden;
this.dispatchEvent(new Event("visibilitychange"));
}
}
const testDocument = new TestDocument();
mount(testDocument);
testDocument.setHidden(true);
testDocument.setHidden(false);
})();Resultaat
ready hidden visible
Plak de code één keer in de console van een nieuw, actief `about:blank`-tabblad. Controleer of `ready` verschijnt, wissel van tabblad, wacht even en ga terug. Meldt de browser beide overgangen, dan toont de console eerst `hidden` en daarna `visible`; de alinea toont weer `visible`. Herlaad het tabblad om het voorbeeld te resetten. Wil je de handler in Node.js controleren, sla de code dan op als `main.js` en voer `node main.js` uit. Een testdocument simuleert beide overgangen.
Gerelateerde lessen
- JavaScript · Les 13 · Gevorderd · Versie: 4