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

CKTIS / JavaScript

Видимост на документа: `Document.hidden` и `visibilitychange`

Провери текущата видимост на документа с `document.hidden` и реагирай на промени чрез `visibilitychange`, без да проверяваш състоянието периодично.

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

Синтаксис

document.hidden
 document.visibilityState
 document.addEventListener("visibilitychange", listener)
 document.removeEventListener("visibilitychange", listener)

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

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

Можеш например да спреш ненужните обновявания на интерфейса, докато документът е скрит, и да ги възобновиш, когато отново е видим. Преходът към "hidden" не означава, че страницата е затворена. Не разчитай и че браузърът ще даде на кода време да довърши работата си. Това е API на уеб платформата, а не част от ECMAScript. Наличността зависи от средата за изпълнение.

Примери

const stopVisibilityLog = (() => {
  const hasDocument = typeof document !== "undefined";
  const page = hasDocument ? document : new EventTarget();
  let simulatedHidden = false;

  if (!hasDocument) {
    // Node.js fixture: simulate visibility without a browser document.
    Object.defineProperty(page, "hidden", { get: () => simulatedHidden });
  }

  const logVisibility = () => {
    console.log(page.hidden ? "hidden" : "visible");
  };

  page.addEventListener("visibilitychange", logVisibility);
  logVisibility();

  const stop = () => {
    page.removeEventListener("visibilitychange", logVisibility);
  };

  if (!hasDocument) {
    const changeVisibility = (hidden) => {
      simulatedHidden = hidden;
      page.dispatchEvent(new Event("visibilitychange", { bubbles: true }));
    };

    changeVisibility(true);
    changeVisibility(false);
    stop();
    changeVisibility(true); // No log after removing the listener.
  }

  return stop;
})();

Резултат

visible
hidden
visible

Изпълни кода веднъж в конзолата на браузъра за видима страница. Премини към друг раздел и се върни. Показаният резултат предполага точно тези две промени след първоначалното прочитане. Извикай `stopVisibilityLog()`, за да спреш извеждането. В Node.js примерът симулира промените във видимостта, без да използва документ от браузъра.

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

  • JavaScript · Урок 27 · Средно · Версия: 3
  • JavaScript · Урок 29 · Средно · Версия: 3
  • JavaScript · Урок 31 · Средно · Версия: 3

Източници