nodeValue Property

Internet Development Index

---

Sets or retrieves the value of a node.

Syntax

HTML	N/A
Scripting	object.nodeValue [ = sValue ]

Possible Values

sValue

Variant that specifies or receives the node value or null.

The property is read/write. The property has no default value.

Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties.

Remarks

If the object is a TextNode, the nodeValue property returns a string representing the text contained by the node.

Expressions cannot be used to change the nodeValue of a TextNode object.

If the object is an attribute object retrieved from the attributes collection, the nodeValue property returns the value of the attribute if it has been specified, or null otherwise.

If the object is an element, the nodeValue returns null. Use the nodeName property to determine the element name.

Example

This example alters the text of the specified list item by setting the nodeValue property of the text node contained by that list item.

<SCRIPT>
function fnChangeValue(oList, iItem, sValue){
// only perform the operation on lists
if (oList.nodeName != "UL" && oList.nodeName != "OL")
return false;
// only perform the operation if the specified index is
// within the acceptable range of available list items
if (iItem > oList.childNodes.length -1)
return false;
// get a reference to the specified list item
var oLI = oList.childNodes(i);
if (!oLI)
return false;
// get a reference to the text node contained by the list item
var oText = oLI.childNodes(0);
// ensure that the node is a text node
if (oText.nodeType != 3)
return false;
oText.nodeValue = sValue;
return true;
}
</SCRIPT>
<UL ID="oList" onclick="fnChangeValue(this, 0, 'New Node value')">
<LI>Old Node Value
</UL>

Standards Information

This property is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 .

Applies To

A, ACRONYM, ADDRESS, APPLET, AREA, attribute, B, BASE, BASEFONT, BDO, BGSOUND, BIG, BLOCKQUOTE, BODY, BR, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, COMMENT, DD, DEL, DFN, DIR, DIV, DL, DT, EM, EMBED, FIELDSET, FONT, FORM, FRAME, FRAMESET, HEAD, hn, HR, HTML, I, IFRAME, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=hidden, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, INS, KBD, LABEL, LEGEND, LI, LINK, LISTING, MAP, MARQUEE, MENU, nextID, OBJECT, OL, OPTION, P, PLAINTEXT, PRE, Q, S, SAMP, SCRIPT, SELECT, SMALL, SPAN, STRIKE, STRONG, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TextNode, TFOOT, TH, THEAD, TITLE, TR, TT, U, UL, VAR, XMP

See Also

value, About the W3C Document Object Model