الفرق بين المراجعتين ل"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]]).
 ==البنية العامّة==