Name
Element.getElementsByTagName( ): find descendant elements with a specified tag name â DOM Level 1 Core:
Synopsis
Element[] getElementsByTagName(Stringname
);
Arguments
-
name
The tag name of the desired elements, or the value â*â to specify that all descendant elements should be returned, regardless of their tag names.
Returns
A read-only array (technically, a NodeList) of Element objects that are descendants of this element and have the specified tag name.
Description
This method traverses all descendants of this element and returns an array (really a NodeList object) of Element nodes representing all document elements with the specified tag name. The elements in the returned array appear in the same order in which they appear in the source document.
Note that the Document interface also has a getElementsByTagName( )
method that works
just like this one but that traverses the entire document, rather
than just the descendants of a single element. Do not confuse this
method with HTMLDocument.getElementsByName(
)
, which searches for elements based on the value of their
name
attributes rather than by
their tag names.
Example
You can find all <div<
tags in a document with code
like the following:
var divisions = document.body.getElementsByTagName("div");
And you can find all <p>
tags within the first <div>
tag with code like
this:
var paragraphs = divisions[0].getElementsByTagname("p");
See Also
Document.getElementById(
)
|
Document.getElementsByTagName(
)
|
HTMLDocument.getElementsByName( ... |
Get JavaScript: The Definitive Guide, 5th Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.