Elemento <xsl:value-of>

Articolo
02/25/2015

Inserisce il valore del nodo selezionato come testo.

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

Attributi

select
Obbligatorio. Espressioni (XSLT) che deve essere valutata in base al contesto corrente. I risultati sono convertiti in stringa, come quando si chiama la funzione string(). Un set di nodi viene convertito in stringa inserendo nel set il valore stringa del primo nodo.
disable-output-escaping
Il valore predefinito è "no". Se il valore è "yes", un nodo di tipo text generato dalla creazione di istanze dell'elemento <xsl:value-of> genererà l'output senza alcun escape. Ad esempio, l'elemento seguente genera il carattere singolo "<".
```
<xsl:value-of disable-output-escaping="yes" select="string('&lt;')"/>
```
Nota

Poiché disable-output-escaping="yes" può generare documenti in formato non corretto, è necessario usarlo con cautela.L'output in formato non corretto può generare errori in alcune circostanze.Ad esempio, per il metodo transformNodeToObject applicato a un documento XML è necessario che il risultato sia in formato corretto, pertanto l'operazione potrebbe non essere completata se l'attributo disable-output-escaping ha impedito la corretta formattazione del documento.È consigliabile considerare disable-output-escaping="yes" come una funzione avanzata, da usare solo quando i potenziali pericoli sono chiari.

Informazioni sull'elemento

Numero di occorrenze	Illimitato
Elementi padre	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, elementi di output
Elementi figlio	(Nessun elemento figlio)

Note

L'elemento <xsl:value-of> inserisce una stringa di testo che rappresenta il valore del primo elemento (in base all'ordine con cui è riportato nel documento) specificato dall'attributo select.

Se l'espressione XPath (XML Path Language) restituisce più di un nodo, l'elemento <xsl:value-of> restituisce il testo del primo nodo restituito (equivalente al metodo XMLDOMNode dell'oggetto selectSingleNode). Se il nodo restituito è un elemento con sottostruttura, <xsl:value-of> restituisce i nodi di tipo text concatenati della sottostruttura ad albero di quell'elemento con i markup rimossi.

Esempio

Il file XSLT seguente crea un elemento <p> da un elemento <person> con elementi figlio <given-name> e <family-name>. L'elemento <p> conterrà il valore di stringa del primo elemento figlio <given-name> del nodo corrente, seguito da uno spazio e dal valore di stringa del primo elemento figlio <family-name> del nodo corrente.

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

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

Output

L'output formattato è il seguente:

Fred Smith

Jill Jones

L'output del processore è il seguente:

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

Condividi tramite