Retrieves an object or a collection from a specified collection.

Syntax

oItem = object.namedItem(sName)

Parameters

sName

Required. 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.

Return Value

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

Remarks

  Internet Explorer 8 and later. In IE8 mode, the namedItem method does not return collections if more than one named item is found; instead, it returns the first case-insensitive matched element. For more information on IE8 mode, see Defining Document Compatibility.

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, the method searches for an object with a matching name attribute, but only on those elements that are allowed a name attribute.

Example

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

<div id="oDIV1">This text will not change.</div>
<div id="oDIV2">This text will change.</div>
<button onclick="document.all.namedItem('oDIV2').innerHTML='Changed!';">
   Change Option
</button>

Applies To

all, anchors, applets, boundElements, cells, embeds, filters, forms, frames, images, links, mimeTypes, plugins, rows, scripts, tBodies, TextRange, TextRectangle, HTMLCollection Constructor