Share via

xsl:value-of Element (Compact 2013)

  • Article

3/26/2014

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 string function. 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 "<".

    <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, transformNodeToObject to 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 select attribute.

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 XMLDOMNode object'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,

<?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.

<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

Reference

XSLT Elements