الفرق بين المراجعتين ل"JavaScript/Document/documentElement"
< JavaScript | Document
اذهب إلى التنقل
اذهب إلى البحث
(إضافة الصّفحة) |
جميل-بيلوني (نقاش | مساهمات) ط |
||
| (4 مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة) | |||
| سطر 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 | + | * مواصفة [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 للحصول على العنصر الجذر.