Document (rozszerzenie)#
Document.visibilityState#
Właściwość visibilityState zwraca łańcuch znakowy reprezentujący aktualny stan widoczności danego dokumentu. Właściwość jest tylko do odczytu.
Składnia#
Samo wywołanie i poszczególne jego części najlepiej objaśnić na zapisie składniowym:
var visibility_state = document.visibilityState;
gdzie poszczególne człony oznaczają:
visibility_state- aktualny stan widoczności dokumentu w postaci łańcucha znakowego. Dostępne są następujące wartości:"hidden"- Identyczne działanie, jak dla właściwości
Document.hiddenzwracającej boolowskietrue. "visible"- Identyczne działanie, jak dla właściwości
Document.hiddenzwracającej boolowskiefalse. "prerender"- Dokument zawarty w kontekście przeglądania najwyższego poziomu jest ładowany poza ekranem i nie jest widoczny (tzw. wstępne renderowanie). Dokument może wystartować z tym stanem, ale nigdy nie może do niego przejść z innej wartości. Obsługa tej wartości przez aplikacje klienckie jest opcjonalna.
"unloaded"Dokument zawarty w kontekście przeglądania najwyższego poziomu ma zostać rozładowany. Obsługa tej wartości przez aplikacje klienckie jest opcjonalna.
document- dokument będący obiektem kontekstu.
Praktyczne operowanie właściwością visibilityState najczęściej odbywa się poprzez nasłuchiwanie dedykowanego zdarzenia typu visibilitychange.
Alternatywnie można skorzystać z ogólniejszej właściwości Document.hidden.
Prosty przykład:
<script>
document.write(document); // [object HTMLDocument]
document.write("<br>");
document.write(document.defaultView); // [object Window]
document.write("<br>");
document.write(document.visibilityState); // visible
document.write("<br><br>");
var new_doc = document.implementation.createHTMLDocument("Samotny dokument");
document.write(new_doc); // [object HTMLDocument]
document.write("<br>");
document.write(new_doc.defaultView); // null
document.write("<br>");
document.write(new_doc.visibilityState); // hidden
</script>Interfejs Web IDL#
readonly attribute VisibilityState visibilityState;
enum VisibilityState {
"hidden",
"visible",
"prerender",
"unloaded"
};Specyfikacje i inne materiały#
Pasek społecznościowy