Document.fullscreenEnabled

من موسوعة حسوب

تُعيد الخاصية 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)

؟ ؟ ؟

انظر أيضًا

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