`Document.fullscreenElement`

تُعيد الخاصية Document.fullscreenElement القابلة للقراءة فقط العنصر Element الذي في وضع ملء الشاشة حاليًا ضمن عناصر المستند الحالي، أو تُعيد القيمة null في حالة لم يكن وضع ملء الشاشة مُفعلًا.

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

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

var element = document.fullscreenElement;

ستكون قيمة المتغيّر element هي إشارةٌ إلى العنصر الموجود في وضع ملء الشاشة حاليًا، أو القيمة null في حالة لم يكن وضع ملء الشاشة مُعتمَدًا في المستند حاليًا.

مثال

function isVideoInFullscreen() {
  if (document.fullscreenElement && document.fullscreenElement.nodeName == 'VIDEO') {
    console.log('مقطع الفيديو يعمل في وضع ملء الشّاشة');
  }
}

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

الميزة	Chrome	Internet Explorer	Firefox	Opera	Safari
الدعم الأساسي	53	نعم	نعم	40	نعم

المواصفات

مواصفة Fullscreen API.

انظر أيضًا