CKTIS / JavaScript
Iskanje elementa po ID-ju in odziv na vidnost dokumenta
Poišči element z `getElementById()`, preberi stanje vidnosti iz `document.hidden` in ob dogodku `visibilitychange` posodobi uporabniški vmesnik.
Različica: Current web platform; runtime support varies
Sintaksa
// 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) sprejme vrednost ID-ja brez predpone # in razlikuje med malimi in velikimi črkami. Vrne ustrezen Element v drevesu dokumenta ali null, če ga ne najde. ID-ji naj bodo enolični; pri dvojnikih vrne prvi element po vrstnem redu v drevesu. Element poišči po vstavitvi in preveri rezultat, preden bereš lastnosti: branje lastnosti vrednosti null sproži TypeError.
document.hidden je logična lastnost samo za branje in ustreza izrazu document.visibilityState === "hidden". Stanje dokumenta je "hidden" ali "visible" in se lahko spremeni na primer ob preklopu zavihka. Ne pove, ali je določen element v vidnem območju ali ali je stran v fokusu. HTMLElement.hidden se nanaša na posamezen element in ne spreminja stanja vidnosti dokumenta.
Brskalnik po spremembi stanja sproži visibilitychange na document. Tega dogodka Event ni mogoče preklicati in ne vsebuje novega stanja; preberi ga iz dokumenta v funkciji za obravnavo dogodka. Funkcijo registriraj in jo nato enkrat pokliči, da nastaviš začetni vmesnik. Ko odstraniš komponento, odstrani poslušalca z istega dokumenta z isto funkcijo in nastavitvijo capture.
Ko je dokument skrit, začasno ustavi nepotrebna opravila. Tega stanja ne obravnavaj kot dokaz, da je uporabnik zapustil stran, da je pozoren ali da ima dovoljenje. To so API-ji spletne platforme, ne del ECMAScripta 2024. Okolje brez brskalnikovega DOM-a morda ne ponuja document; podpora je odvisna od izvajalnega okolja.
Primeri
(() => {
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);
})();Rezultat
ready hidden visible
Kodo enkrat prilepi v konzolo novega aktivnega zavihka `about:blank`. Preveri izpis `ready`, preklopi na drug zavihek, malo počakaj in se vrni. Če brskalnik sporoči oba prehoda, konzola izpiše `hidden` in nato `visible`, odstavek pa spet prikaže `visible`. Za ponastavitev znova naloži zavihek. Če želiš preveriti funkcijo za obravnavo dogodka v okolju Node.js, shrani kodo kot `main.js` in zaženi `node main.js`. Oba prehoda simulira preizkusni dokument.
Povezane lekcije
- JavaScript · Lekcija 13 · Napredna · Različica: 4