EN
Este conteúdo não está disponível em seu idioma, mas aqui está a versão em inglês.

namedItem method

Retrieves an object or a collection from a specified collection.

Syntax

object.namedItem(name)

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.

Return value

Type: Object

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 a Windows Store app using JavaScript.

The namedItem method does not return collections if more than one named item is found; instead, it returns the first case-insensitive matched element.

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.

Examples

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>

See also

all
anchors
applets
boundElements
cells
embeds
forms
frames
images
links
rows
scripts
tBodies
TextRange
TextRectangle

 

 

Mostrar:
© 2014 Microsoft