Tech Stuff - getElementsByTagName
W3C Reference. Part of the Document Interface.
getElementsByTagName Method
One of the three basic methods of getting a reference to a node using the DOM. Gets a reference (a NodeList aka HTMLCollection) to all the nodes which have the same HTML tag name.
Syntax
nodelist = document.getElementsByTagName(tag)
Related Stuff
getElementById
Parameters
| Name |
Description |
Notes |
| tag |
any valid HTML tag, for example, 'p' or 'div'.
|
|
Examples
// get all the paragraphs in the document
listofparagraphs = document.getElementsByTagName("p");
// find the one with our special text
for(i = 0; i < listofparagraphs.length; i++)
{
if(listofparagraphs[i].firstChild.nodeValue == "boring")
{
// gottcha
}
}
The example gets a NodeList(array) Nodes with a nodeType = 1 (ELEMENT_NODE) of all the paragraph (<p>) HTML tags in our document. It then loops using the length attribute (of the NodeList) and tests the firstChild attribute (of the paragraph node) and the nodeValue attribute (of the text node) to search for a specific text string.
Notes:
Problems, comments, suggestions, corrections (including broken links) or something to add? Please take the time from a busy life to 'mail us' (at top of screen), the webmaster (below) or info-support at zytrax. You will have a warm inner glow for the rest of the day.
