HTML DOM Document getElementsByTagName() metoden

Definition og brug

getElementsByTagName() Metoden returnerer en samling af alle elementer med det angivne tagnavn.

getElementsByTagName() Metoden returnerer HTMLCollection.

getElementsByTagName() Egenskaben er skrivebeskyttet.

Bemærk:getElementsByTagName("*") Returnerer alle elementer i dokumentet.

HTMLCollection

HTMLCollection Er en array-lignende samling af HTML-elementer (liste).

Elementer i samlingen kan nås via indeks (fra 0).

length Egenskaben returnerer antallet af elementer i samlingen.

Se også:

getElementById() metoden

getElementsByClassName() metoden

querySelector() metoden

querySelectorAll() metoden

HTMLCollection objekt

Eksempel

Eksempel 1

Få fat i alle elementer med tagnavnet "li":

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

Prøv det selv

Eksempel 2

Få fat i alle elementer i dokumentet:

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

Prøv det selv

Eksempel 3

Ændre den interne HTML for det første <p> element i dokumentet:

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

Prøv det selv

Eksempel 4

Antallet af <li> elementer i dokumentet:

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

Prøv det selv

Eksempel 5

Ændre baggrundsfar på alle <p> elementer:

const collection = document.getElementsByTagName("P");
for (let i = 0; i < collection.length; i++) {
  collection[i].style.backgroundColor = "red";
}

Prøv det selv

Syntaks

document.getElementsByTagName(tagName)

Parameter

Parameter Beskrivelse
tagName Obligatorisk. Elementets mærkenavn.

Returværdi

Type Beskrivelse
Objekt

HTMLCollection objekt.

Samling af elementer med angivet tagnavn.

Sorterer efter elementernes optræden i dokumentet.

Tekniske detaljer

Denne metode vil returnere NodeList objekt (kan håndteres som en skrivebeskyttet array), som indeholder alle Element-noder med angivet tagnavn i dokumentet, og deres rækkefølge er den samme som de optræder i kildefilen.

NodeList objektet er “levende”，dvs. hvis der tilføjes eller fjernes elementer med angivet tagnavn i dokumentet, vil indholdet automatisk opdateres nødvendigt.

HTML 文档不区分大小写，因此可以使用任意的大小写形式指定 tagName匹配文档中所有同名标签，无论这些标签在源文档中采用的大小写形式是什么。但 XML 文档区分大小写，tagName kun matcher mærker med navn og store/kleine bogstaver som helt identisk i kildefilen.

Bemærk:Element interface definerer en metode med samme navn, som kun søger i dokumentets subtreet. Desuden definerer HTMLDocument interface getElementByName() metoden检索元素基于 name 属性的值（而不是标签名）。

Browser support

document.getElementsByTagName() er en DOM Level 1 (1998) funktion.

Det understøttes af alle browsere:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Support 9-11 Support Support Support Support

Relaterede sider

JavaScript Reference Manual:element.getElementsByTagName()

JavaScript Tutorial:JavaScript HTML DOM node liste