Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Wyszukiwanie elementu po ID i reagowanie na widoczność dokumentu

Znajdź element za pomocą `getElementById()`, odczytaj stan widoczności z `document.hidden` i zaktualizuj interfejs po zdarzeniu `visibilitychange`.

Wersja: Current web platform; runtime support varies

Składnia

// 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) przyjmuje wartość id, bez prefiksu #, i rozróżnia wielkość liter. Zwraca pasujący Element z drzewa dokumentu albo null, jeśli go nie ma. Identyfikatory powinny być unikatowe; przy duplikatach metoda zwraca pierwszy element w kolejności drzewa. Szukaj po wstawieniu elementu i sprawdź wynik przed użyciem: odczyt właściwości z null powoduje TypeError.

document.hidden to właściwość logiczna tylko do odczytu, równoważna document.visibilityState === "hidden". Stan dokumentu to "hidden" albo "visible"; może się zmienić na przykład po przełączeniu karty. Nie informuje, czy dany element widać w obszarze widoku ani czy strona ma fokus. HTMLElement.hidden dotyczy pojedynczego elementu i nie zmienia stanu widoczności dokumentu.

Przeglądarka wysyła na document zdarzenie visibilitychange po zmianie stanu. To zwykły Event, którego nie można anulować i który nie zawiera nowego stanu; odczytaj go z dokumentu w funkcji obsługi. Zarejestruj tę funkcję i od razu wywołaj ją raz, aby ustawić początkowy interfejs. Przy demontażu komponentu usuń nasłuch z tego samego dokumentu, podając tę samą funkcję i tę samą wartość capture.

Gdy dokument jest ukryty, możesz wstrzymać zbędną pracę. Nie traktuj jednak tego stanu jako dowodu opuszczenia strony, uwagi użytkownika ani uprawnień. To interfejsy platformy webowej, nie ECMAScript 2024; środowisko bez przeglądarkowego DOM może nie udostępniać document, a obsługa zależy od środowiska wykonawczego.

Przykłady

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

Wynik

ready
hidden
visible

Wklej kod raz do konsoli świeżej, aktywnej karty `about:blank`. Sprawdź komunikat `ready`, przełącz się na inną kartę, chwilę poczekaj i wróć. Jeśli przeglądarka zgłosi oba przejścia, konsola wypisze `hidden`, a potem `visible`; akapit znów pokaże `visible`. Odśwież kartę, aby zresetować przykład. Aby sprawdzić funkcję obsługi w Node.js, zapisz kod jako `main.js` i uruchom `node main.js`; oba przejścia symuluje dokument testowy.

Powiązane lekcje

  • JavaScript · Lekcja 13 · Zaawansowany · Wersja: 4

Źródła