Document.documentElement

من موسوعة حسوب

تُعيد عنصر 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 للحصول على العنصر الجذر.

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