الفرق بين المراجعتين لصفحة: «JavaScript/Document/visibilityState»
< JavaScript | Document
إضافة الصّفحة |
استخدام المصطلح «ظهور»، وإجراء بعد الأمور التنظيمية |
||
| (1 مراجعات متوسطة بواسطة نفس المستخدم غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>Document.visibilityState</code>}}</noinclude> | <noinclude>{{DISPLAYTITLE:<code>Document.visibilityState</code>}}</noinclude> | ||
تُعيد الخاصيّة <code>Document.visibilityState</code> القابلة للقراءة فقط حالةَ | تُعيد الخاصيّة <code>Document.visibilityState</code> القابلة للقراءة فقط حالةَ ظهور المُستند، أي سياق وضوح العنصر الحالي. إذ من المُفيد معرفة ما إذا كان المُستند في الخلفيّة أو في تبويب (لسان، tab) غير مرئي حاليًّا، أو أنّ الصّفحة قد حُمّلت فقط من أجل ما قبل التّصيير (pre-rendering). القيم المُمكنة هي كما يلي: | ||
* <code>'visible'</code>: تُشير إلى أنّ مُحتويات الصّفحة قد تكون | * <code>'visible'</code>: تُشير إلى أنّ مُحتويات الصّفحة قد تكون ظاهرة ولو جزئيّا. هذا يعني بأنّ الصفحة موجودة على تبويب أمامي في نافذة غيرِ مُصغّرة. | ||
* <code>'hidden'</code>: مُحتويات الصّفحة غير واضحة للمستخدم. هذا يعني أنّ المستند إما في تبويب خلفي أو في نافذة مُصغّرة، أو أنّ قفل شاشة النِّظام مُفعّل. | * <code>'hidden'</code>: مُحتويات الصّفحة غير واضحة للمستخدم. هذا يعني أنّ المستند إما في تبويب خلفي أو في نافذة مُصغّرة، أو أنّ قفل شاشة النِّظام مُفعّل. | ||
* <code>'prerender'</code>: مُحتويات الصّفحة في حالة تصييرٍ مُسبَق وغير واضحة للمُستخدم (وتُعتبر مخفيّة من ناحيّة <code>[[JavaScript/Document|document.hidden]]</code>). يُمكن للمُستند أن يبدأ في هذه الحالة، لكنّه لن ينتقل أبدا إليها من قيمة أخرى. لاحظ أنّ دعم المُتصفحات اختياري هنا. | * <code>'prerender'</code>: مُحتويات الصّفحة في حالة تصييرٍ مُسبَق وغير واضحة للمُستخدم (وتُعتبر مخفيّة من ناحيّة <code>[[JavaScript/Document|document.hidden]]</code>). يُمكن للمُستند أن يبدأ في هذه الحالة، لكنّه لن ينتقل أبدا إليها من قيمة أخرى. لاحظ أنّ دعم المُتصفحات اختياري هنا. | ||
| سطر 8: | سطر 8: | ||
* <code>'unloaded'</code>: تُحمَّلُ الصّفحة حاليّا من الذّاكرة. لاحظ أنّ دعم المُتصفحات اختياري هنا. | * <code>'unloaded'</code>: تُحمَّلُ الصّفحة حاليّا من الذّاكرة. لاحظ أنّ دعم المُتصفحات اختياري هنا. | ||
يتمّ إرسال الحدث <code>visibilitychange</code> إلى المُستند عند تغيّر قيمة هذه الخاصيّة. | يتمّ إرسال الحدث <code>visibilitychange</code> إلى المُستند (الكائن <code>[[JavaScript/Document|Document]]</code>) عند تغيّر قيمة هذه الخاصيّة. | ||
تُستعمل هذه الخاصيّة عادة لإيقاف تنزيل بعض الأصول (assets) عند التصيير المُسبق للمُستند أو لإيقاف نشاطات عندما يكون المُستند في الخلفيّة أو في نافذة مُصغّرة. | تُستعمل هذه الخاصيّة عادة لإيقاف تنزيل بعض الأصول (assets) عند التصيير المُسبق للمُستند أو لإيقاف نشاطات عندما يكون المُستند في الخلفيّة أو في نافذة مُصغّرة. | ||
| سطر 17: | سطر 17: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
==مثال== | |||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
document.addEventListener("visibilitychange", function() { | document.addEventListener("visibilitychange", function() { | ||
| سطر 51: | سطر 51: | ||
==مصادر ومواصفات== | ==مصادر ومواصفات== | ||
* مواصفة [https://www.w3.org/TR/page-visibility/#dom-document-visibilitystate Page Visibility (Second Edition)]. | * مواصفة [https://www.w3.org/TR/page-visibility/#dom-document-visibilitystate Page Visibility (Second Edition)]. | ||
[[تصنيف:JavaScript]] | [[تصنيف:JavaScript]] | ||
المراجعة الحالية بتاريخ 06:36، 17 مارس 2018
تُعيد الخاصيّة Document.visibilityState القابلة للقراءة فقط حالةَ ظهور المُستند، أي سياق وضوح العنصر الحالي. إذ من المُفيد معرفة ما إذا كان المُستند في الخلفيّة أو في تبويب (لسان، tab) غير مرئي حاليًّا، أو أنّ الصّفحة قد حُمّلت فقط من أجل ما قبل التّصيير (pre-rendering). القيم المُمكنة هي كما يلي:
'visible': تُشير إلى أنّ مُحتويات الصّفحة قد تكون ظاهرة ولو جزئيّا. هذا يعني بأنّ الصفحة موجودة على تبويب أمامي في نافذة غيرِ مُصغّرة.'hidden': مُحتويات الصّفحة غير واضحة للمستخدم. هذا يعني أنّ المستند إما في تبويب خلفي أو في نافذة مُصغّرة، أو أنّ قفل شاشة النِّظام مُفعّل.'prerender': مُحتويات الصّفحة في حالة تصييرٍ مُسبَق وغير واضحة للمُستخدم (وتُعتبر مخفيّة من ناحيّةdocument.hidden). يُمكن للمُستند أن يبدأ في هذه الحالة، لكنّه لن ينتقل أبدا إليها من قيمة أخرى. لاحظ أنّ دعم المُتصفحات اختياري هنا.
'unloaded': تُحمَّلُ الصّفحة حاليّا من الذّاكرة. لاحظ أنّ دعم المُتصفحات اختياري هنا.
يتمّ إرسال الحدث visibilitychange إلى المُستند (الكائن Document) عند تغيّر قيمة هذه الخاصيّة.
تُستعمل هذه الخاصيّة عادة لإيقاف تنزيل بعض الأصول (assets) عند التصيير المُسبق للمُستند أو لإيقاف نشاطات عندما يكون المُستند في الخلفيّة أو في نافذة مُصغّرة.
البنية العامة
var string = document.visibilityState
مثال
document.addEventListener("visibilitychange", function() {
console.log( document.visibilityState );
// افعل شيئا ما
});
دعم المتصفحات
| الميزة | Chrome | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| الدعم الأساسي | 13، مع السابقة -webkit-
33 دون سابقة |
18 | 10 | 12.10 | 7 |
prerender
|
نعم | 49 | ؟ | ؟ | ؟ |