Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

namedItem method

Retrieves a form object or an object from an elements collection.

Syntax

object.namedItem(name, pdisp)

Parameters

name [in]

Type: String

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


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

See also

elements
form

 

 

Show:
© 2017 Microsoft