ویژگی firstChild HTML DOM Element

تعریف و استفاده

firstChild ویژگی بازگرداننده اولین فرزند گره مشخص شده، به عنوان یک گره Node است.

firstChild ویژگی‌ها فقط خوانا هستند.

firstChild ویژگی childNodes[0] مشابه.

توجه داشته باشید

firstChild بازگرداندن اولین گره: گره عناصر، گره متن یا گره نظارتی.

فاصله‌های بین عناصر نیز گره‌های متن هستند.

راه حل جایگزین:

ویژگی firstElementChild - firstElementChild ویژگی بازگرداننده اولین فرزند عناصر (گره‌های متن و ویرایش‌های نظارتی را نادیده می‌گیرد).

لطفاً به بخش

ویژگی childNodes

ویژگی lastChild

ویژگی nextSibling

ویژگی previousSibling

ویژگی‌های گره

ویژگی parentNode

ویژگی nodeName

ویژگی nodeType

ویژگی nodeValue

مثال

مثال 1

محتوای HTML اولین فرزند گره <ul> را بازگردانید:

document.getElementById("myList").firstChild.innerHTML;

آزمایش کنید

مثال 2

نوشتار اولین فرزند گره <select> را به دست آورید:

let text = document.getElementById("mySelect").firstChild.text;

آزمایش کنید

مثال 3

این مثال نمایشگر تأثیر اختلالات فضای خالی است.

سعی کنید نام گره اولین فرزند "myDIV" را به دست آورید:

<div id="myDIV">
  <p>به نظر می‌رسد فرزند اول است</p>
  <p>به نظر می‌رسد فرزند آخر است</p>
</div>
<script>
let text = document.getElementById("myDIV").firstChild.nodeName;
</script>

آزمایش کنید

مثال 4

اما اگر از فضاهای خالی در منبع حذف کنید، گره #text در "myDIV" وجود ندارد:

<div id="myDIV"><p>فرزند اول</p><p>فرزند آخر</p></div>
<script>
let text = document.getElementById("myDIV").firstChild.nodeName;
</script>

آزمایش کنید

گره‌های HTML و عناصر

در HTML DOMدر (مدل مستند) HTML مستند است که مجموعه‌ای از گره‌هایی هستند که (دارند یا ندارند) فرزند.

گرهگره‌های عناصر، گره‌های متن و نظرات هستند.

عناصرفضاهای خالی بین آن‌ها نیز گره‌های متن هستند.

عناصر فقط گره‌های عناصر هستند.

گره‌ها و فرزندان

childNodes بازگشتفرزندان((گره‌های عناصر، گره‌های متن و نظرات)).

children بازگشتفرزند‌های زیر((در عوض گره‌های متن و نظرات)).

firstChild و firstElementChild

firstChild اولینفرزندان((گره‌های عناصر، گره‌های متن و گره‌های نظرات). فضاهای خالی بین عناصر نیز گره‌های متن هستند.

firstElementChild اولینفرزند‌های زیر((نمایش گره‌های متن و گره‌های نظرات را باز نمی‌گرداند)).

lastChild و lastElementChild

lastChild آخرینفرزندان((گره‌های عناصر، گره‌های متن و گره‌های نظرات). فضاهای خالی بین عناصر نیز گره‌های متن هستند.

lastElementChild آخرینفرزند‌های زیر((نمایش گره‌های متن و گره‌های نظرات را باز نمی‌گرداند)).

منظور از

element.firstChild

یا

گره.firstChild

مقدار بازگشتی

نوع توضیح
گره

اولین فرزند گره.

اگر هیچ فرزندی نداشته باشد، null برمی‌گرداند.

پشتیبانی مرورگر

element.firstChild این یک ویژگی DOM Level 1 (1998) است.

همه مرورگرها به طور کامل از آن پشتیبانی می‌کنند:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
پشتیبانی 9-11 پشتیبانی پشتیبانی پشتیبانی پشتیبانی