База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Намиране на елемент по ID и реакция при промяна на видимостта на документа

Намери елемент с `getElementById()`, прочети състоянието от `document.hidden` и обнови интерфейса при събитието `visibilitychange`.

Версия: Current web platform; runtime support varies

Синтаксис

// 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) приема стойността на идентификатора без префикс # и прави разлика между главни и малки букви. Връща съответстващ Element в дървото на документа или null, ако няма такъв. Идентификаторите трябва да са уникални; при повторения се връща първият елемент по реда в дървото. Търси след добавянето на елемента и провери резултата преди достъп до свойствата му: четенето на свойство от null предизвиква TypeError.

document.hidden е булево свойство само за четене, равностойно на document.visibilityState === "hidden". Състоянието на документа е "hidden" или "visible" и може да се промени например при смяна на раздела. То не показва дали конкретен елемент е във видимата област или дали страницата е на фокус. HTMLElement.hidden се отнася за отделен елемент и не променя състоянието на видимост на документа.

Браузърът изпраща visibilitychange към document след промяната на състоянието. Това е Event, който не може да бъде отменен и не съдържа новото състояние; прочети го от документа в обработчика. Регистрирай обработчика и го извикай веднъж за начално настройване на интерфейса. При премахване на компонент премахни слушателя от същия документ със същата функция и настройка capture.

Когато документът е скрит, спри временно ненужните задачи. Не приемай обаче това състояние като доказателство, че страницата е напусната, че потребителят внимава или че е упълномощен. Това са интерфейси на уеб платформата, а не част от ECMAScript 2024. Среда без браузърен DOM може да не предоставя document; поддръжката зависи от средата за изпълнение.

Примери

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

Резултат

ready
hidden
visible

Постави кода веднъж в конзолата на нов активен раздел с `about:blank`. Провери дали се появява `ready`, премини към друг раздел, изчакай малко и се върни. Ако браузърът отчете и двата прехода, конзолата ще изпише `hidden`, а след това `visible`; абзацът отново ще показва `visible`. Презареди раздела, за да върнеш примера в начално състояние. За да провериш обработчика в Node.js, запази кода като `main.js` и изпълни `node main.js`. Тестов документ симулира и двата прехода.

Свързани уроци

  • JavaScript · Урок 13 · Напреднало · Версия: 4

Източници