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

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

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

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:<code>Document.fullscreenElement</code>}}</noinclude>
-تُعيد الخاصية <code>Document.fullscreenElement</code> القابلة للقراءة فقط العنصر <code>[[JavaScript/Element|Element]]</code> الذي في وضع ملء الشاشة حاليا ضمن عناصر المستند الحالي، أو تُعيد القيمة <code>null</code> في حالة لم يكن وضع ملء الشاشة مُفعلًا.
+تُعيد الخاصية <code>Document.fullscreenElement</code> القابلة للقراءة فقط العنصر <code>[[JavaScript/Element|Element]]</code> الذي في وضع ملء الشاشة حاليًا ضمن عناصر المستند الحالي، أو تُعيد القيمة <code>null</code> في حالة لم يكن وضع ملء الشاشة مُفعلًا.
-ورغم أن هذه الخاصية قابلة للقراءة فقط، إلا أنّها لن ترمي استثناءا عند تغيير قيمتها (حتى في وضع strict)، وستُتجاهل أية عمليّة ضبط قيمة لها.
+ورغم أن هذه الخاصية قابلة للقراءة فقط، إلا أنّها لن ترمي استثناءً عند تغيير قيمتها (حتى في [[JavaScript/Strict Mode|نمط strict]])، وستُتجاهل أية عمليّة ضبط قيمة لها.
-==البنية العامّة==
+== البنية العامة ==
 <syntaxhighlight lang="javascript">
 var element = document.fullscreenElement;
 </syntaxhighlight>
-سيتكون قيمة المتغيّر <code>element</code> العنصر الذي في وضع ملء الشاشة حاليا، أو القيمة <code>null</code> في حالة لم يكن وضع ملء الشاشة مُعتمَدا في المستند حاليا.
+ستكون قيمة المتغيّر <code>element</code> هي إشارةٌ إلى العنصر الموجود في وضع ملء الشاشة حاليًا، أو القيمة <code>null</code> في حالة لم يكن وضع ملء الشاشة مُعتمَدًا في المستند حاليًا.
 ==مثال==
@@ سطر 21: / سطر 21: @@
 </syntaxhighlight>
+== دعم المتصفحات ==
-==دعم المتصفحات==
 {| class="wikitable"
 !الميزة
 !|Chrome
-!Edge
 !Internet Explorer
 !Firefox
@@ سطر 34: / سطر 32: @@
 ! الدعم الأساسي
 |53
-|نعم
 |نعم
 |نعم
@@ سطر 43: / سطر 40: @@
 * مواصفة [https://fullscreen.spec.whatwg.org/#dom-document-fullscreenelement 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/fullscreen|Document.fullscreen]]</code>
-* <code>[[JavaScript/Document/fullscreenElement|Document.fullscreenElement]]</code>
+* ‎<code>[[CSS/:fullscreen|:fullscreen]]</code>
-* <code>[[CSS/:fullscreen|:fullscreen]]</code>