Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

Inserts the value of the selected node as text.

Syntax 

<xsl:value-of
  select = 
expression
  disable-output-escaping = "yes" | "no" 
</xsl:value-of>

Attributes

select

[required] Expression to be evaluated against the current context. The results are converted to a string as by a call to the stringfunction. A node-set is converted to a string by inserting the string value of the first node in the set.

disable-output-escaping

Default is "no". If the value is "yes", a text node generated by instantiating the <xsl:text> element will be output without any escaping. For example, the following generates the single character "<".

Copy Code 
<xsl:text
disable-output-escaping="yes">&lt;</xsl:text>
Note:
disable-output-escaping="yes" can be used to generate non-well-formed documents, and thus should be used with caution, because non-well-formed output may generate errors in certain circumstances. For example, transformNodeToObjectto an XML document requires that the result be well-formed and thus may not complete if disable-output-escaping has affected the well-formed appearance of the document. Consider disable-output-escaping="yes" an advanced feature to be used only when the potential dangers are understood.

Element Information

Number of occurrences

Unlimited

Parent elements

xsl:attribute, xsl:comment, xsl:copy, xsl:element, xsl:for-each, xsl:if, xsl:otherwise, xsl:param, xsl:processing-instruction, xsl:template, xsl:variable, xsl:when, xsl:with-param, output elements

Child elements

(No child elements)

Remarks

The <xsl:value-of> element inserts a text string representing the value of the first element (in document order) specified by the selectattribute.

If the XML Path Language (XPath) expression returns more than a single node, the <xsl:value-of> element returns the text of the first node returned (equivalent to the XMLDOMNodeobject's selectSingleNode method). If the node returned is an element with substructure, <xsl:value-of> returns the concatenated text nodes of that element's subtree with the markup removed.

Example

Given this XML,

Copy Code 
<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="family.xsl"?>
<family>
  <person>
	<given-name age="30">John</given-name>
	<family-name>Peoples</family-name>
  </person>
  ...
</family>

the following creates an HTML paragraph from a "person" element with "given-name" and "family-name" child elements. The paragraph will contain the string-value of the first "given-name" child element of the current node, followed by a space and the string-value of the first "family-name" child element of the current node.

Copy Code 
<xsl:template match="person">
  <p>
	<xsl:value-of select="given-name"/>
	<xsl:text> </xsl:text>
	<xsl:value-of select="family-name"/>
  </p>
</xsl:template>

See Also