Section 25.146. HTMLCollection.namedItem( ): get an element by name


25.146. HTMLCollection.namedItem( ): get an element by name

DOM Level 2 HTML

25.146.1. Synopsis

 Node namedItem(String name); 

25.146.1.1. Arguments

name

The name of the element to be returned.

25.146.1.2. Returns

The element in the collection that has the specified value for its id or name attribute, or null if no elements in the HTMLCollection have that name.

25.146.2. Description

This method finds and returns an element from the HTMLCollection that has the specified name. If any element has an id attribute whose value is the specified name, that element is returned. If no such element is found, an element whose name attribute has the specified value is returned. If no such element exists, namedItem( ) returns null.

Note that any HTML element may be given an id attribute, but only certain HTML elementssuch as forms, form elements, images, and anchorsmay have a name attribute.

In JavaScript, it is easier to treat the HTMLCollection as an associative array and to specify name between square brackets using array notation.

25.146.3. Example

 var forms = document.forms;                // An HTMLCollection of forms var address = forms.namedItem("address");  // Finds <form name="address"> var payment = forms["payment"]  // Simpler syntax: finds <form name="payment"> var login = forms.login;        // Also works: finds <form name="login"> 




JavaScript. The Definitive Guide
JavaScript: The Definitive Guide
ISBN: 0596101996
EAN: 2147483647
Year: 2004
Pages: 767

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net