الفرق بين المراجعتين لصفحة: «JavaScript/Document/documentElement»
< JavaScript | Document
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
|||
| (3 مراجعات متوسطة بواسطة مستخدم واحد آخر غير معروضة) | |||
| سطر 1: | سطر 1: | ||
<noinclude>{{DISPLAYTITLE:<code>Document.documentElement</code>}}</noinclude> | <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></code> في مستندات HTML). | |||
==البنية العامّة== | ==البنية العامّة== | ||
| سطر 8: | سطر 7: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
== مثال == | |||
==مثال== | |||
<syntaxhighlight lang="javascript"> | <syntaxhighlight lang="javascript"> | ||
var rootElement = document.documentElement; | var rootElement = document.documentElement; | ||
| سطر 20: | سطر 18: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
في المثال أعلاه، المتغير <code>firstTier</code> هو كائن من النوع <code>NodeList</code> الذي يحوي الأولاد المُباشِرين للعنصر الجذر. | في المثال أعلاه، المتغير <code>firstTier</code> هو كائن من النوع <code>NodeList</code> الذي يحوي الأولاد المُباشِرين للعنصر الجذر. | ||
== | ==ملاحظات== | ||
مُستندات HTML تحتوي في العادة على عقدة ولد واحدة فقط، وهي العنصر <code><html></code> وربما مع تعريف DOCTYPE قبلها. أمّا مُستندات XML فعادة ما تحتوي على العديد من العقد الأولاد: العنصر الجذر، تعريف DOCTYPE، وتعليمات المُعالجة (processing instructions) | مُستندات HTML تحتوي في العادة على عقدة ولد واحدة فقط، وهي العنصر <code>[[HTML/html|<html>]]</code> وربما مع تعريف DOCTYPE قبلها. أمّا مُستندات XML فعادة ما تحتوي على العديد من العقد الأولاد: العنصر الجذر، تعريف DOCTYPE، وتعليمات المُعالجة (processing instructions). | ||
لهذا يجب عليك استعمال <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: | * مواصفة [http://www.w3.org/TR/DOM-Level-2-Core/core.html#ID-87CD092 DOM Level 2 Core: Document.documentElement]. | ||
[[تصنيف:JavaScript]] | |||
[[تصنيف:Web API]] | |||
[[تصنيف:DOM]] | |||
[[تصنيف:Document]] | |||
المراجعة الحالية بتاريخ 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 للحصول على العنصر الجذر.