عرض مصدر JavaScript/ParentNode/firstElementChild

<noinclude>{{DISPLAYTITLE:<code>ParentNode.firstElementChild</code>}}</noinclude>
تُعيد الخاصيّة <code>ParentNode.firstElementChild</code> القابلة للقراءة فقط أول عنصِرٍ إبن للكائن، أو القيمة <code>null</code> إن لم يكن هناك أي عنصرٍ إبن.

==البنية العامة==
<syntaxhighlight lang="javascript">
var element = node.firstElementChild;
</syntaxhighlight>

===مثال===
<syntaxhighlight lang="javascript">
<ul id="foo">
  <li>القيمة الأولى</li>
  <li>القيمة الثّانية</li>
  <li>القيمة الثّالثة</li>
</ul>

<script>
var foo = document.getElementById('foo');
// تُسجّل القيمة الأولى
console.log(foo.firstElementChild.textContent);
</script>
</syntaxhighlight>

==إضافة لدعم المتصفحات غير المدعومة ==
الشيفرة التّالية تقوم بالكتابة فوق الكائن <code>firstElementChild</code> الذي يُعتبر كائنا من النّوع <code>prototype</code> وتُضيف دعم كلّ من <code>Document</code> و<code>DocumentFragment</code> لمُتصفّحي IE9 وSafari. لكنّها تُرجع مصفوفة عوضا عن مجموعة من النّوع <code>HTMLCollection</code>.

<syntaxhighlight lang="javascript">
;(function(constructor) {
    if (constructor &&
        constructor.prototype &&
        constructor.prototype.firstElementChild == null) {
        Object.defineProperty(constructor.prototype, 'firstElementChild', {
            get: function() {
                var node, nodes = this.childNodes, i = 0;
                while (node = nodes[i++]) {
                    if (node.nodeType === 1) {
                        return node;
                    }
                }
                return null;
            }
        });
    }
})(window.Node || window.Element);
</syntaxhighlight>

== دعم المتصفحات ==
{| class="wikitable"
!الميزة
!|Chrome
!Edge
!Firefox
!Internet Explorer
!Opera
!Safari
|-
! الدعم الأساسي
|1
|؟
|3.5
|9
|10
|4
|-
!الدعم على كلّ من  <code>Document</code> و<code>DocumentFragment</code> (ميّزة تجريبيّة)
|29
|؟
|25
|لا
|16
|لا
|}

==انظر أيضًا==
* الواجهة <code>[[JavaScript/ParentNode|ParentNode]]</code> والواجهة <code>[[JavaScript/ChildNode|ChildNode]]</code>
* أنواع الكائنات التي تُطبّق هذه الواجهة: <code>[[JavaScript/Document|Document]]</code> و<code>[[JavaScript/Element|Element]]</code> و<code>[[JavaScript/DocumentFragment|DocumentFragment]]</code>


==مصادر ومواصفات==
* مواصفة [https://dom.spec.whatwg.org/#dom-parentnode-firstelementchild DOM]. فرّقت هذه المواصفة الواجهة <code>ElementTraversal</code> إلى كلّ من الواجهة <code>ChildNode</code> والواجهة <code>ParentNode</code>، هذه الخاصيّة معرّفة الآن على الواجهة الأخيرة. تُطبّق كلّ من الواجهة <code>Document</code> والواجهة <code>DocumentFragment</code> الواجهتين الجديدتين.
* مواصفة [https://dom.spec.whatwg.org/#dom-parentnode-firstelementchild Element Traversal Specification].

[[تصنيف:JavaScript]]
[[تصنيف:Web API]]
[[تصنيف:DOM]]
[[تصنيف:Document]]