Elemento <xsl:value-of>

Inserta el valor del nodo seleccionado como texto.

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

Atributos

  • select
    Necesario. La Expresiones que se debe evaluar en función del contexto actual. Los resultados se convierten en una cadena, como consecuencia de la llamada de la función string(). Un conjunto de nodos se convierte en una cadena insertando el valor de la cadena del primer nodo en el conjunto.
  • disable-output-escaping
    El valor predeterminado es "no". Si el valor es "yes", se obtendrá sin escape un nodo de texto generado mediante la creación de instancias para el elemento <xsl:value-of>. Por ejemplo, a continuación se muestra cómo se genera el carácter único "<".

    <xsl:value-of disable-output-escaping="yes" select="string('&lt;')"/>
    

    Nota

    Como puede utilizarse disable-output-escaping="yes" para generar documentos que no están bien formados, debe emplearse con cuidado. Un resultado que no está bien formado puede generar errores en determinadas circunstancias. Por ejemplo, transformNodeToObject en un documento XML precisa que el resultado esté bien formado, por lo que es posible que no se complete si disable-output-escaping ha afectado a la correcta formación del documento. Considere disable-output-escaping="yes" como una función avanzada que sólo debe utilizarse cuando se conocen los posible peligros.

Información del elemento

Número de apariciones

Ilimitado

Elementos primarios

xsl:attribute, xsl:comment, xsl:copy, xsl:element, xsl:fallback, xsl:for-each, xsl:if, xsl:message, xsl:otherwise, xsl:param, xsl:processing-instruction, xsl:template, xsl:variable, xsl:when, xsl:with-param, elementos resultantes

Elementos secundarios

(No hay elementos secundarios)

Comentarios

El elemento <xsl:value-of> inserta una cadena de texto que representa el valor del primer elemento (en orden de documento) especificado por el atributo select.

Si la expresión del lenguaje XML Path (XPath) devuelve más de un nodo, el elemento <xsl:value-of> devuelve el texto del primer nodo devuelto (equivalente al método selectSingleNode del objeto XMLDOMNode). Si el nodo devuelto es un elemento con subestructura, <xsl:value-of> devuelve los nodos de texto concatenados del subárbol de ese elemento con el elemento de marcado eliminado.

Ejemplo

El siguiente archivo XSLT crea un elemento <p> a partir de un elemento <person> con los elementos secundarios <given-name> y <family-name>. El elemento <p> contendrá el valor de cadena del primer elemento secundario <given-name> del nodo actual, seguido de un espacio y el valor de cadena del primer elemento secundario <family-name> del nodo actual.

Archivo XML (family.xml)

<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="family.xsl"?>
<family>
  <person>
    <given-name age="10">Fred</given-name>
    <family-name>Smith</family-name>
  </person>
  <person>
    <given-name age="13">Jill</given-name>
    <family-name>Jones</family-name>
  </person>
</family>

Archivo XSLT (family.xsl)

<?xml version='1.0'?>
<xsl:stylesheet version="1.0"
      xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

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

</xsl:stylesheet>

Resultados

Este es el resultado con formato:

Fernando Martínez

Cristina García

Este es el resultado del procesador:

<?xml version="1.0" encoding="UTF-16"?>
  <p>Fred Smith</p>
  <p>Jill Jones</p>