namedItem method

Syntax

Parameters

A String that specifies the name or id property of the object to retrieve. A collection is returned if more than one match is made.

pdisp [out, retval]

C++

The address of a pointer to a variable that receives an IDispatch interface for the object or collection if successful, or null otherwise.

JavaScript

Returns an object or a collection of objects if successful, or null otherwise.

Return value

Type: Object

The address of a pointer to a variable that receives an IDispatch interface for the object or collection if successful, or null otherwise.Returns an object or a collection of objects if successful, or null otherwise.

Standards information

There are no standards that apply here.

Remarks

The namedItem method was introduced in Microsoft Internet Explorer 6

This method first searches for an object with a matching id attribute. If a match is not found, then the method searches for an object with a matching
name attribute, but only on those elements that are allowed a name attribute.

Examples

The following example shows how to use the namedItem method to retrieve a div and change its innerHTML property.