Microsoft Developer Network

Sets or retrieves the value of a node.

Syntax

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

Possible Values

sValue

String or Integer 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, ABBR, 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