الفرق بين المراجعتين لصفحة: «JavaScript/Document/fullscreenEnabled»

من موسوعة حسوب
طلا ملخص تعديل
لا ملخص تعديل
سطر 1: سطر 1:
<noinclude>{{DISPLAYTITLE:<code>Document.fullscreenEnabled</code>}}</noinclude>
<noinclude>{{DISPLAYTITLE:<code>Document.fullscreenEnabled</code>}}</noinclude>


تُعيد الخاصية <code>Document.fullscreenEnabled</code> القابلة للقراءة فقط كائنا من النوع <code>[[JavaScript/Boolean|Boolean]]</code> يُشير إلى ما إذا كان وضع ملء الشاشة مُتاحا أو لا. وضع ملء الشاشة مُتاح للصفحات التي لا تحتوي على إضافات ذات نوافِذَ في أي من مُستنداتها فقط، وفي حالة كانت جميع عناصر <code><iframe></code> التي تحوي المُستند ذات خاصيّة <code>allowfullscreen</code>  مضبوطة.
تُعيد الخاصية <code>Document.fullscreenEnabled</code> القابلة للقراءة فقط كائنًا من النوع <code>[[JavaScript/Boolean|Boolean]]</code> يُشير إلى ما إذا كان وضع ملء الشاشة مُتاحًا أم لا. وضع ملء الشاشة مُتاح للصفحات التي لا تحتوي على إضافات ذات نوافِذَ في أي من مُستنداتها فقط، وفي حالة كانت جميع عناصر <code><iframe></code> التي تحوي المُستند ذات خاصيّة <code>allowfullscreen</code>  مضبوطة.


ورغم أن هذه الخاصية قابلة للقراءة فقط، إلا أنّها لن ترمي استثناءا عند تغيير قيمتها (حتى في وضع strict)، وستُتجاهل أية عمليّة ضبط قيمة لها.
ورغم أن هذه الخاصية قابلة للقراءة فقط، إلا أنّها لن ترمي استثناءً عند تغيير قيمتها (حتى في [[JavaScript/Strict Mode|نمط strict]])، وستُتجاهل أية عمليّة ضبط قيمة لها.
 
==البنية العامة==
 
==البنية العامّة==
<syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">
var isFullscreenAvailable = document.fullscreenEnabled;
var isFullscreenAvailable = document.fullscreenEnabled;
سطر 12: سطر 10:
يحمل المتغيّر <code>isFullscreenAvailable</code> القيمة <code>true</code> في حالة أمكَنَ نقل المُستند إلى وضع ملء الشاشة.
يحمل المتغيّر <code>isFullscreenAvailable</code> القيمة <code>true</code> في حالة أمكَنَ نقل المُستند إلى وضع ملء الشاشة.


 
== مثال ==
==مثال==
<syntaxhighlight lang="javascript">
<syntaxhighlight lang="javascript">
function requestFullScreen() {
function requestFullScreen() {
سطر 24: سطر 21:
</syntaxhighlight>
</syntaxhighlight>


 
== دعم المتصفحات ==
==دعم المتصفحات==
{| class="wikitable"
{| class="wikitable"
!الميزة
!الميزة
سطر 43: سطر 39:
|}
|}
==المواصفات==
==مصادر ومواصفات==
* مواصفة [https://fullscreen.spec.whatwg.org/#dom-document-fullscreenenabled Fullscreen API].
* مواصفة [https://fullscreen.spec.whatwg.org/#dom-document-fullscreenenabled Fullscreen API].


==انظر أيضا==
==انظر أيضًا==
* <code>[[JavaScript/Element/requestFullscreen|Element.requestFullscreen()]]</code>
* <code>[[JavaScript/Element/requestFullscreen|Element.requestFullscreen()]]</code>
* <code>[[JavaScript/Document/exitFullscreen|document.exitFullscreen()]]</code>
* <code>[[JavaScript/Document/exitFullscreen|document.exitFullscreen()]]</code>
* <code>[[JavaScript/Document/cancelFullscreen|document.cancelFullscreen()]]</code>
* <code>[[JavaScript/Document/cancelFullscreen|document.cancelFullscreen()]]</code>
* <code>[[JavaScript/Document/fullscreen|Document.fullscreen]]</code>
* <code>[[JavaScript/Document/fullscreen|Document.fullscreen]]</code>
* <code>[[JavaScript/Document/fullscreenElement|Document.fullscreenElement]]</code>
* <code>[[JavaScript/Document/fullscreenElement|Document.fullscreenElement]]</code>
* <code>[[CSS/:fullscreen|:fullscreen]]</code>
* <code>[[CSS/:fullscreen|:fullscreen]]</code>

مراجعة 06:23، 13 مارس 2018


تُعيد الخاصية Document.fullscreenEnabled القابلة للقراءة فقط كائنًا من النوع Boolean يُشير إلى ما إذا كان وضع ملء الشاشة مُتاحًا أم لا. وضع ملء الشاشة مُتاح للصفحات التي لا تحتوي على إضافات ذات نوافِذَ في أي من مُستنداتها فقط، وفي حالة كانت جميع عناصر <iframe> التي تحوي المُستند ذات خاصيّة allowfullscreen مضبوطة.

ورغم أن هذه الخاصية قابلة للقراءة فقط، إلا أنّها لن ترمي استثناءً عند تغيير قيمتها (حتى في نمط strict)، وستُتجاهل أية عمليّة ضبط قيمة لها.

البنية العامة

var isFullscreenAvailable = document.fullscreenEnabled;

يحمل المتغيّر isFullscreenAvailable القيمة true في حالة أمكَنَ نقل المُستند إلى وضع ملء الشاشة.

مثال

function requestFullScreen() {
  if (document.fullscreenEnabled) {
    videoElement.requestFullScreen();
  } else {
    console.log('لا يمكن لمُتصفحك استعمال وضع ملء الشاشة حاليا');
  }
}

دعم المتصفحات

الميزة Chrome Firefox Internet Explorer Opera Safari
الدعم الأساسي نعم، مع السابقة -webkit

45 دون سابقة

10.0 باستخدام mozFullScreenEnabled

47 (وراء full-screen-api.unprefix.enabled)

؟ ؟ ؟

مصادر ومواصفات

انظر أيضًا