Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Pronalaženje elementa po ID-u i reagiranje na vidljivost dokumenta

Pronađi element s pomoću `getElementById()`, očitaj vidljivost iz `document.hidden` i ažuriraj sučelje nakon događaja `visibilitychange`.

Verzija: 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) prima vrijednost ID-a bez prefiksa # i razlikuje velika i mala slova. Vraća odgovarajući Element u stablu dokumenta ili null ako ga ne pronađe. ID-evi trebaju biti jedinstveni; pri duplikatima vraća se prvi element prema redoslijedu u stablu. Traži element nakon što je umetnut i provjeri rezultat prije pristupa svojstvima: čitanje svojstva na null izaziva TypeError.

document.hidden je logičko svojstvo samo za čitanje, jednako izrazu document.visibilityState === "hidden". Stanje dokumenta je "hidden" ili "visible" i može se promijeniti, primjerice, pri prelasku na drugu karticu. Ne govori je li određeni element u vidljivom području ni ima li stranica fokus. HTMLElement.hidden odnosi se na pojedinačni element i ne mijenja stanje vidljivosti dokumenta.

Preglednik pokreće visibilitychange na objektu document nakon promjene stanja. Taj se Event ne može otkazati i ne sadrži novo stanje; očitaj ga iz dokumenta u funkciji za obradu događaja. Registriraj funkciju pa je pozovi jednom za početno postavljanje sučelja. Pri uklanjanju komponente ukloni slušača s istog dokumenta, uz istu funkciju i postavku capture.

Dok je dokument skriven, pauziraj nepotrebne zadatke. To stanje ipak nije dokaz da je stranica napuštena, da korisnik obraća pozornost ili da je ovlašten. To su API-ji web-platforme, a ne dio ECMAScripta 2024. Okruženje bez DOM-a preglednika možda ne nudi document; podrška ovisi o izvršnom okruženju.

Primjeri

(() => {
  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

Jednom zalijepi kôd u konzolu nove aktivne kartice `about:blank`. Provjeri pojavljuje li se `ready`, prijeđi na drugu karticu, pričekaj trenutak i vrati se. Ako preglednik prijavi oba prijelaza, konzola ispisuje `hidden`, a zatim `visible`; odlomak ponovno prikazuje `visible`. Ponovno učitaj karticu za povratak na početno stanje. Za provjeru funkcije za obradu događaja u okruženju Node.js spremi kôd kao `main.js` i pokreni `node main.js`. Testni dokument simulira oba prijelaza.

Povezane lekcije

  • JavaScript · Lekcija 13 · Napredno · Verzija: 4

Izvori