CKTIS / JavaScript
Vyhledání prvku podle ID a reakce na viditelnost dokumentu
Najdi prvek pomocí `getElementById()`, zjisti viditelnost z `document.hidden` a při události `visibilitychange` aktualizuj uživatelské rozhraní.
Verze: Current web platform; runtime support varies
Syntaxe
// 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čekává hodnotu ID bez předpony # a rozlišuje velká a malá písmena. Vrátí odpovídající Element ve stromu dokumentu, nebo null, pokud žádný nenajde. ID mají být jedinečná; u duplicit se vrátí první prvek v pořadí stromu. Hledej až po vložení prvku a před čtením vlastností výsledek zkontroluj: čtení vlastnosti z null vyvolá TypeError.
document.hidden je logická vlastnost pouze pro čtení, která odpovídá výrazu document.visibilityState === "hidden". Stav dokumentu je "hidden" nebo "visible" a může se změnit třeba při přepnutí karty. Neříká, zda je konkrétní prvek v zobrazené části stránky ani zda má stránka fokus. HTMLElement.hidden se týká jednotlivého prvku a stav viditelnosti dokumentu nemění.
Prohlížeč vyvolá visibilitychange na document po změně stavu. Tento Event nelze zrušit a nenese nový stav; přečti ho z dokumentu v obslužné funkci. Funkci zaregistruj a jednou ji zavolej, aby se nastavilo počáteční rozhraní. Při odstraňování komponenty odeber posluchač ze stejného dokumentu se stejnou funkcí a nastavením capture.
Když je dokument skrytý, pozastav zbytečnou práci. Tento stav ale nepovažuj za důkaz opuštění stránky, pozornosti uživatele ani oprávnění. Jde o API webové platformy, nikoli ECMAScriptu 2024. Prostředí bez DOM prohlížeče nemusí poskytovat document; podpora se liší podle běhového prostředí.
Pří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ýsledek
ready hidden visible
Vlož kód jednou do konzole nové aktivní karty `about:blank`. Zkontroluj `ready`, přepni na jinou kartu, krátce počkej a vrať se. Pokud prohlížeč ohlásí oba přechody, konzole vypíše `hidden` a poté `visible`; odstavec znovu zobrazí `visible`. Načti kartu znovu, pokud chceš příklad uvést do výchozího stavu. Chceš-li ověřit obslužnou funkci v Node.js, ulož kód jako `main.js` a spusť `node main.js`. Oba přechody simuluje testovací dokument.
Související lekce
- JavaScript · Lekce 13 · Pokročilá · Verze: 4