setNamedItem Method

Internet Development Index

Adds an attribute to an element using an attributes collection.

Syntax

newretNode = attributes.setNamedItem(oNamedItem)

Parameters

oNamedItem Required. An attribute.

Return Value

Returns the previously existing attribute if it has the same name as the new attribute, otherwise null.

Remarks

An attribute that is set with this method does not have to apply to the element.

If an attribute with the same name is already present, it is replaced by the new attribute.

Example

The following example shows how to add an attribute to an element using the setNamedItem method. 

<HTML>
<HEAD>
<SCRIPT>
function fnSetNamedItem(){
var nnm = myDIV.attributes;
var namedItem = document.createAttribute("title");
namedItem.value = "This is a ToolTip";
nnm.setNamedItem(namedItem);
}
</SCRIPT>
</HEAD>
<BODY onload="fnSetNamedItem();">
<DIV ID="myDIV">This DIV now has a ToolTip.</DIV>
</BODY>
</HTML>
This feature requires Microsoft® Internet Explorer 6 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

This method is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 Non-Microsoft link.

Applies To

attributes