روش getElementsByTagName() از HTML DOM Document

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

getElementsByTagName() این روش مجموعه‌ای از عناصر با نام برچسب مشخص شده را برمی‌گرداند.

getElementsByTagName() این روش HTMLCollection.

getElementsByTagName() این属性 فقط خواندنی است.

نکته:getElementsByTagName("*") همه عناصر موجود در مستند را برمی‌گرداند.

HTMLCollection

HTMLCollection مجموعه‌ای شبیه به آرایه از عناصر HTML است (لیست).

می‌توان به عناصر موجود در مجموعه از طریق شمارنده دسترسی کرد (از 0 شروع می‌شود).

length این属性 تعداد عناصر موجود در مجموعه را برمی‌گرداند.

لطفاً به: بنگرید

روش getElementById()

روش getElementsByClassName()

روش querySelector()

روش querySelectorAll()

مجموعه HTMLCollection

مثال

مثال 1

دسترسی به همه عناصر با نام برچسب "li":

const collection = document.getElementsByTagName("li");

亲自试一试

مثال 2

دسترسی به همه عناصر مستند:

const collection = document.getElementsByTagName("*");

亲自试一试

مثال 3

تغییر HTML داخلی اولین عناصر <p> در مستند:

document.getElementsByTagName("p")[0].innerHTML = "Hello World!";

亲自试一试

مثال 4

تعداد عناصر <li> در مستند:

let numb = document.getElementsByTagName("li").length;

亲自试一试

مثال 5

تغییر رنگ پس‌زمینه همه عناصر <p>:

const collection = document.getElementsByTagName("P");
برای (بجای i = 0; i < collection.length; i++) {
  collection[i].style.backgroundColor = "red";
}

亲自试一试

语法

document.getElementsByTagName(tagName)

参数

参数 描述
tagName 必需。元素的标记名。

返回值

类型 描述
对象

HTMLCollection 对象。

拥有指定标签名称的元素的集合。

按照元素在文档中出现顺序进行排序。

技术细节

该方法将返回 NodeList 对象（可以作为只读数组处理），该对象存放文档中拥有指定标签名的所有 Element 节点，它们存放的顺序就是在源文档中出现的顺序。

NodeList کا اوبجیکٹ 'زنده' ہوتا ہے، یعنی اگر دستاویز میں کسی عناصر کو شامل یا کسی عناصر کو حذف کیا جائے تو اس کی ضروری تازگی خودکار طور پر اپدیت ہوتی ہے۔

HTML دستاویز چھوٹی بڑی حروف کا فرق نہیں رکھتا، لہذا کسی بھی چھوٹی بڑی حروف کی کسی طرح کی تبدیلی کی جائیں گی tagName، یہ دستاویز میں تمام نام کی تگ کا نمائندہ چھوٹی بڑی حروف کا نام کی تگ سے ماتحت کیا جاتا ہے، بغیر کسی بھی چھوٹی بڑی حروف کی کسی طرح کی تبدیلی کی جائیں گی، لیکن XML دستاویز چھوٹی بڑی حروف کا فرق رکھتا ہے،tagName فقط اصل دستاویز میں نام اور کپچا میں پوری طرح ساتھ کی گئی چھوٹی بڑی حروف کا نام کی تگ کا نمائندہ چھوٹی بڑی حروف کا نام کی تگ سے ماتحت کیا جاتا ہے۔

نکات:Element کے انٹرافیس نے ایک نام کا طریق دینا ہے، جو صرف مستند کے پودے میں تلاش کرتا ہے۔ مزید برآمد، HTMLDocument کے انٹرافیس نے getElementByName() طریق، یہ نام کی خصوصیت کی بنیاد پر عناصر تلاش کرتا ہے (تگ نام کا نام نہیں ہے)۔

براوزر سپورٹ

document.getElementsByTagName() یہ DOM Level 1 (1998) خصوصیات کی حامل ہے۔

تمام براوزر اس کا سپورٹ کرتے ہیں:

کروم آئی ای ایج فائرفاکس سافری آپریا
کروم آئی ای ایج فائرفاکس سافری آپریا
پشتیبندگی 9-11 پشتیبندگی پشتیبندگی پشتیبندگی پشتیبندگی

متعلقہ صفحات

JavaScript مرجع دستورelement.getElementsByTagName()

JavaScript تعلیم:JavaScript HTML DOM نود لیست