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

<noinclude>{{DISPLAYTITLE:<code>Document.children</code>}}</noinclude>
تُعيد الخاصيّة <code>children</code> القابلة للقراءة فقط والمُعرّفة على الواجهة <code>[[JavaScript/ParentNode|ParentNode]]</code> كائنا من النّوع <code>[[JavaScript/HTMLCollection|HTMLCollection]]</code> الذي يحتوي على جميع العناصِرِ الأولاد الخاصّة بالعقدة التي استُدعَت عليها.

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

===القيمة===
القيمة المُعادة عبارة عن كائن من النّوع <code>HTMLCollection</code> والذي هو مجموعة حيّة ومُرتّبة من عناصر DOM الذين هم أولاد العقدة. يُمكنك الوصول إلى العقد الأولاد كل على حدة في المجموعة عبر استعمال إمّا التّابع <code>item()‎</code> على المجموعة أو باستعمال طريقة مصفوفات جافاسكربت.

إن لم يكن للعُقدة أية عناصِرَ أولاد، فستكون القائمة <code>children</code> فارغة بقيمة طول <code>length</code> تُساوي <code>0</code>.

==مثال==
<syntaxhighlight lang="javascript">
var foo = document.getElementById('foo');
for (var i = 0; i < foo.children.length; i++) {
    console.log(foo.children[i].tagName);
}
</syntaxhighlight>

==إضافة لدعم المتصفحات غير المدعومة ==
الشيفرة التّالية تقوم بالكتابة فوق الكائن <code>children</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.children == null) {
        Object.defineProperty(constructor.prototype, 'children', {
            get: function() {
                var i = 0, node, nodes = this.childNodes, children = [];
                while (node = nodes[i++]) {
                    if (node.nodeType === 1) {
                        children.push(node);
                    }
                }
                return children;
            }
        });
    }
})(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>SVGElement</code> (ميّزة تجريبيّة)
|نعم
|لا
|نعم
|لا
|؟
|لا
|}

==انظر أيضًا==
* الواجهة <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>
* <code>[[JavaScript/Node/childNodes|Node.childNodes]]</code>

==مصادر ومواصفات==
* مواصفة [https://dom.spec.whatwg.org/#dom-parentnode-children DOM].

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