Élément <xsl:value-of>

Article
08/23/2008

Insère la valeur du nœud sélectionné sous la forme de texte.

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

Attributs

select
Obligatoire. Une Expressions à comparer au contexte actuel. Les résultats sont convertis en une chaîne, comme avec la fonction string(). La conversion en chaîne de la collection de nœuds s'effectue en insérant la valeur de la chaîne du premier nœud de la collection.

disable-output-escaping
La valeur par défaut est "no". Si la valeur est "yes", un nœud de texte généré par instanciation de l'élément <xsl:value-of> sera sorti sans aucun échappement. Par exemple, l'expression suivante génère le caractère unique "<".
```
<xsl:value-of disable-output-escaping="yes" select="string('&lt;')"/>
```
Notes

Puisque disable-output-escaping="yes" peut être utilisé pour générer des documents incorrectement construits, il y a lieu de l'utiliser avec précaution. Une sortie qui n'est pas correctement construite peut générer des erreurs dans certaines circonstances. Par exemple, transformNodeToObject vers un document XML exige que le résultat soit correctement construit et peut donc échouer si disable-output-escaping a affecté la bonne construction du document. Considérez disable-output-escaping="yes" comme une fonction avancée, à n'utiliser que lorsque les dangers potentiels sont maîtrisés.

Informations sur l'élément

Nombre d'occurrences	Illimité
Éléments parents	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, éléments de sortie
Éléments enfants	(Pas d'éléments enfants)

Notes

L'élément <xsl:value-of> insère une chaîne de texte représentant la valeur du premier élément (dans l'ordre du document) spécifié par l'attribut select.

Si l'expression XPath retourne plus d'un nœud, l'élément <xsl:value-of> retourne le texte du premier nœud (ce qui équivaut à la méthode selectSingleNode de l'objet XMLDOMNode). Si le nœud retourné est un élément possédant une sous-structure, <xsl:value-of> retourne les nœuds de texte concaténés de la sous-arborescence de cet élément, sans les balises.

Exemple

Le fichier XSLT suivant crée un élément <p> à partir d'un élément <person> avec les éléments enfants <given-name> et <family-name>. L'élément <p> contient la valeur de chaîne du premier élément <given-name> enfant du nœud actuel, suivi d'un espace et de la valeur de chaîne du premier élément <family-name> enfant du nœud actuel.

Fichier 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>

Fichier 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>

Sortie

Voici les données en sortie formatées :

Fred Smith

Jill Jones

Voici les données en sortie du processeur :

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