الفرق بين المراجعتين ل"JavaScript/Document/fullscreenElement"

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

المراجعة الحالية بتاريخ 06:56، 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 نعم

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

انظر أيضًا