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)

؟ ؟ ؟

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

انظر أيضًا