setNamedItem method
[This documentation is preliminary and is subject to change.]
Adds an attribute to an element by using an attributes collection.
 |
Syntax
var retval = attributes.setNamedItem(ppNode);Standards information
Parameters
- ppNode [in]
-
Type: IHTMLDOMAttribute
An attribute object.
Return value
Type: ObjectReturns 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.
setNamedItem was introduced in Microsoft Internet Explorer 6.
Examples
The following example shows how to add an attribute to an element using the setNamedItem method.
Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/setNamedItemEx1.htm
<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>
See also
- attributes
- Reference
- getNamedItem
- removeNamedItem
Build date: 2/14/2012