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

المراجعة الحالية بتاريخ 14:30، 7 أكتوبر 2022

تُعيد عنصر Element الذي هو العنصر الجذر في المستند document (على سبيل المثال، العنصر <html> في مستندات HTML).

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

var element = document.documentElement;

مثال

var rootElement = document.documentElement;
var firstTier = rootElement.childNodes;

for (var i = 0; i < firstTier.length; i++) {
   // نفّذ عمليّة ما مع كل واحد من الأولاد المُباشِرين للعنصر الجذر
   // firstTier[i]
}

في المثال أعلاه، المتغير firstTier هو كائن من النوع NodeList الذي يحوي الأولاد المُباشِرين للعنصر الجذر.

ملاحظات

مُستندات HTML تحتوي في العادة على عقدة ولد واحدة فقط، وهي العنصر <html> وربما مع تعريف DOCTYPE قبلها. أمّا مُستندات XML فعادة ما تحتوي على العديد من العقد الأولاد: العنصر الجذر، تعريف DOCTYPE، وتعليمات المُعالجة (processing instructions).

لهذا يجب عليك استعمال document.documentElement عوضًا عن document.firstChild للحصول على العنصر الجذر.

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

مواصفة DOM Level 2 Core: ‏Document.documentElement.

@@ سطر 1: / سطر 1: @@
 <noinclude>{{DISPLAYTITLE:<code>Document.documentElement</code>}}</noinclude>
-تُعيد عنصر <code>Element</code> الذي هو العنصر الجذر في المستند <code>document</code> (على سبيل المثال، العنصر <code>[[HTML/html|<html>]]</code> في مستندات HTML).
+تُعيد عنصر <code>Element</code> الذي هو العنصر الجذر في المستند <code>document</code> (على سبيل المثال، العنصر <code>[[HTML/html|<html>]]</code> في مستندات [[HTML]]).
 ==البنية العامّة==
@@ سطر 23: / سطر 23: @@
 لهذا يجب عليك استعمال <code>[[JavaScript/Document/documentElement|document.documentElement]]</code> عوضًا عن <code>document.firstChild</code> للحصول على العنصر الجذر.
-== المواصفات ==
+== مصادر ومواصفات ==
 * مواصفة [http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-87CD092 DOM Level 2 Core: ‏Document.documentElement].
 [[تصنيف:JavaScript]]