CKTIS / JavaScript
Widoczność dokumentu: `Document.hidden` i `visibilitychange`
Odczytaj bieżącą widoczność dokumentu przez `document.hidden` i użyj `visibilitychange`, aby reagować na jej zmiany bez odpytywania.
Wersja: Current web platform; runtime support varies
Składnia
document.hidden
document.visibilityState
document.addEventListener("visibilitychange", listener)
document.removeEventListener("visibilitychange", listener)document.hidden to właściwość logiczna obiektu document dostępna tylko do odczytu. Ma wartość true, gdy document.visibilityState wynosi "hidden", i false, gdy wynosi "visible". Karta w tle lub zminimalizowane okno to typowe sytuacje, w których dokument jest ukryty. Nie chodzi tu o fokus, widoczność pojedynczego elementu ani o to, czy użytkownik patrzy na stronę.
Przeglądarka emituje visibilitychange na obiekcie document po zmianie stanu w dowolnym kierunku. Jest to zwykłe zdarzenie Event, które propaguje się w górę i którego nie można anulować. Nie zawiera nowego stanu: odczytaj go w funkcji obsługi. Rejestracja funkcji nie wywołuje jej od razu, więc osobno odczytaj stan początkowy. Aby usunąć funkcję obsługi, przekaż tę samą funkcję do removeEventListener.
Możesz na przykład wstrzymać zbędne odświeżanie interfejsu, gdy dokument jest ukryty, i wznowić je, gdy znów jest widoczny. Stan "hidden" nie oznacza, że strona została zamknięta; nie licz też na to, że przeglądarka da kodowi czas na dokończenie pracy. To API platformy WWW, nie część ECMAScriptu. Dostępność zależy od środowiska wykonawczego.
Przykłady
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;
})();Wynik
visible hidden visible
Uruchom kod raz w konsoli przeglądarki dla widocznej strony. Przełącz się na inną kartę i wróć. Podany wynik zakłada dokładnie te dwie zmiany po pierwszym odczycie. Aby zakończyć rejestrowanie, wywołaj `stopVisibilityLog()`. W Node.js przykład symuluje zmiany widoczności zamiast korzystać z dokumentu przeglądarki.
Powiązane lekcje
- JavaScript · Lekcja 27 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 29 · Średniozaawansowany · Wersja: 3
- JavaScript · Lekcja 31 · Średniozaawansowany · Wersja: 3