HTML DOM Document getElementsByTagName() -menetelmä

Määritelmä ja käyttötapa

getElementsByTagName() Menetelmä palauttaa kaikki määritellyn nimellä varustetut elementtien kokoelman.

getElementsByTagName() Menetelmä palauttaa HTMLCollection

getElementsByTagName() Ominaisuus on kirjoitussuojattu.

Huomautus:getElementsByTagName("*") Palauttaa dokumentin kaikki elementit.

HTMLCollection

HTMLCollection On HTML-elementtien muistollinen kokoelma (lista).

Kokoelmassa olevia elementtejä voidaan saavuttaa indeksin avulla (alkaen indeksistä 0).

length Ominaisuus palauttaa kokoelmassa olevien elementtien määrän.

Lisätietoja:

getElementById() -menetelmä

getElementsByClassName() -menetelmä

querySelector() -menetelmä

querySelectorAll() -menetelmä

HTMLCollection-objekti

Esimerkki

Esimerkki 1

Hanki kaikki "li"-nimiset elementit:

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

Kokeile itse

Esimerkki 2

Hanki dokumentin kaikki elementit:

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

Kokeile itse

Esimerkki 3

Muuta dokumentin ensimmäisen <p>-elementin sisäistä HTML:ää:

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

Kokeile itse

Esimerkki 4

Dokumentissa olevien <li>-elementtien määrä:

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

Kokeile itse

Esimerkki 5

Muuta kaikkien <p>-elementtien taustaväriä:

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

Kokeile itse

Syntaksi

document.getElementsByTagName(tagName)

Parametrit

Parametrit Kuvaus
tagName Välttämätön. Elementin merkintä.

Palautusarvo

Tyyppi Kuvaus
Objekti

HTMLCollection-objekti.

Määritellyn nimisen elementtien joukko.

Järjestetään elementtien ilmestymisjärjestyksen mukaan.

Tekninen yksityiskohta

Tämä menetelmä palauttaa NodeList-objektin (voidaan käsitellä vain lukuina olevana taulukkona), joka sisältää kaikki asiakirjassa olevat elementit, joilla on määritelty tietty merkintä, niiden järjestys on sama kuin ne ilmestyvät alkuperäisessä asiakirjassa.

NodeList-objekti on "elävä", eli jos asiakirjaan lisätään tai poistetaan elementtejä, jotka ovat määritetty tietyn nimellä, sen sisältö päivitetään automaattisesti.

HTML-asiakirjat eivät tee eroa kirjaimenmuodosta, joten voit määritellä minkä tahansa kirjainmuodon. tagNameSe sopii kaikkiin samannimisiin merkinnöihin asiakirjassa, riippumatta siitä, mikä on niiden alkuperäisessä asiakirjassa oleva kirjainmuoto. Mutta XML-asiakirjat eroavat kirjaimenmuodosta.tagName Soveltuu vain alkuperäisessä asiakirjassa oleviin nimisiin ja kirjainmuotoihin täysin samanmuotoisiin merkinnöihin.

Vinkki:Element -liittymä määrittelee samannimisen menetelmän, joka hakee vain asiakirjan alihakemistoa. Lisäksi HTMLDocument -liittymä määrittelee getElementByName() -menetelmäSe perustuu name-ominaisuuden arvoon (ei merkinnän nimeen).

Selaimen tuki

document.getElementsByTagName() Se on DOM Level 1 (1998) -ominaisuus.

Kaikki selaimet tukevat sitä:

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

Tiedotuslehdet

JavaScript-ohjekirja:element.getElementsByTagName()

JavaScript-opas:JavaScript HTML DOM solmujen luettelo