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