Name
HTMLCollection — array of HTML elements accessible by position or name
Availability
DOM Level 1 HTML
Properties
-
readonly unsigned long length
The number of elements in the collection.
Methods
-
item( )
Returns the element at the specified position in the collection. You can also simply specify the position within array brackets instead of calling this method explicitly.
-
namedItem( )
Returns the element from the collection that has the specified value for its
id
orname
attribute, ornull
if there is no such element. You may also place the element name within array brackets instead of calling this method explicitly.
Description
An HTMLCollection is a collection of HTML elements with methods that
allow you to retrieve the elements by their position in the document
or by their id
or name
attribute. In JavaScript, HTMLCollection objects behave like
read-only arrays, and you may use JavaScript square-bracket notation
to index an HTMLCollection by number or by name instead of calling
the item( )
and namedItem( )
methods.
A number of the properties of the HTMLDocument interface (which standardizes the DOM Level 0 Document object) are HTMLCollection objects, which provide convenient access to document elements such as forms, images, and links. The HTMLCollection object also provides a convenient way to traverse the elements of an HTML form, the rows of an HTML table, the cells of a table row, and the areas of a client-side image map.
HTMLCollection objects are read-only: you cannot assign ...
Get JavaScript: The Definitive Guide, Fourth 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.