CKTIS / JavaScript
Vyhľadanie prvku podľa ID a reakcia na viditeľnosť dokumentu
Nájdi prvok pomocou `getElementById()`, zisti viditeľnosť z `document.hidden` a pri udalosti `visibilitychange` aktualizuj používateľské rozhranie.
Verzia: 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) očakáva hodnotu ID bez predpony # a rozlišuje veľké a malé písmená. Vráti zodpovedajúci Element v strome dokumentu alebo null, ak ho nenájde. ID majú byť jedinečné; pri duplicitách sa vráti prvý prvok v poradí stromu. Vyhľadávaj až po vložení prvku a pred čítaním vlastností skontroluj výsledok: čítanie vlastnosti z null vyvolá TypeError.
document.hidden je logická vlastnosť len na čítanie, ktorá zodpovedá výrazu document.visibilityState === "hidden". Stav dokumentu je "hidden" alebo "visible" a môže sa zmeniť napríklad pri prepnutí karty. Neurčuje, či je konkrétny prvok v zobrazenej časti stránky ani či má stránka fokus. HTMLElement.hidden sa týka jednotlivého prvku a nemení stav viditeľnosti dokumentu.
Prehliadač vyvolá visibilitychange na document po zmene stavu. Tento Event nemožno zrušiť a neobsahuje nový stav; načítaj ho z dokumentu v obslužnej funkcii. Funkciu zaregistruj a raz ju zavolaj na inicializáciu rozhrania. Pri odstraňovaní komponentu odober poslucháča z toho istého dokumentu s rovnakou funkciou a nastavením capture.
Keď je dokument skrytý, pozastav zbytočnú prácu. Tento stav však nepovažuj za dôkaz opustenia stránky, pozornosti používateľa ani oprávnenia. Ide o API webovej platformy, nie o súčasť ECMAScriptu 2024. Prostredie bez DOM prehliadača nemusí poskytovať document; podpora sa líši podľa prostredia vykonávania.
Príklady
(() => {
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);
})();Výsledok
ready hidden visible
Vlož kód raz do konzoly novej aktívnej karty `about:blank`. Skontroluj `ready`, prepni sa na inú kartu, krátko počkaj a vráť sa. Ak prehliadač oznámi oba prechody, konzola vypíše `hidden` a potom `visible`; odsek znova zobrazí `visible`. Opätovným načítaním karty obnovíš východiskový stav príkladu. Ak chceš overiť obslužnú funkciu v Node.js, ulož kód ako `main.js` a spusti `node main.js`. Oba prechody simuluje testovací dokument.
Súvisiace lekcie
- JavaScript · Lekcia 13 · Pokročilá · Verzia: 4