<xsl:text> |
Permet d'écrire du texte dans le document de sortie.
Catégorie
Instruction
Attributs obligatoires
Aucun.
Attributs facultatifs
disable-output-escaping Définit si des caractères spéciaux sont échappés lors de leur écriture dans le document de sortie. Par exemple, si le texte littéral contient le caractère >, il est généralement écrit dans le document de sortie sous la forme & gt;. Si vous codez disable-output-escaping= " yes ", le caractère > est écrit à la place. Le processeur XSLT utilise cet attribut uniquement si vous utilisez les méthodes de sortie html ou xml. Si vous utilisez < xsl:output method= " text " >, l'attribut est ignoré car la méthode de sortie text ne permet pas d'ignorer une sortie.
Contenu
#PCDATA, texte littéral et références d'entité.
Apparaît dans
<xsl:text> apparaît dans un modèle.
Défini dans
XSLT section 7.2, Création de texte.
Exemple
L'exemple de feuille de style suivant génère du texte à l'aide de <xsl:text>. On mélange des éléments <xsl:text> et des éléments <xsl:value-of> pour créer une phrase cohérente. Dans ce cas, on génère simplement un document texte, mais cette technique fonctionne également pour créer le texte d'un élément HTML ou XML. La feuille de style est la suivante :
    <?xml version="1.0"?>
    <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

      <xsl:output method="text"/>

      <xsl:variable name="newline">
    <xsl:text>
    </xsl:text>
      </xsl:variable>

      <xsl:template match="/">
        <xsl:text>Your document contains </xsl:text>
        <xsl:value-of select="count(//*)"/>
        <xsl:text> elements and </xsl:text>
        <xsl:value-of select="count(//@*)"/>
        <xsl:text> attributes. </xsl:text>
        <xsl:value-of select="$newline"/>
        <xsl:text disable-output-escaping="yes"><Have a great day!></xsl:text>
      </xsl:template>
    </xsl:stylesheet>
<xsl:variable> a également permis de générer des sauts de ligne. L'élément <xsl:text> de l'élément <xsl:variable> contient un saut de ligne, écrire la valeur de cette variable dans l'arborescence de résultat produira le saut de ligne voulu. Voici le document XML :
    <?xml version="1.0"?>
    <list xml:lang="en">
      <title>Albums I've bought recently:</title>
      <listitem>The Sacred Art of Dub</listitem>
      <listitem>Only the Poor Man Feel It</listitem>
      <listitem>Excitable Boy</listitem>
      <listitem xml:lang="sw">Aki Special</listitem>
      <listitem xml:lang="en-gb">Combat Rock</listitem>
      <listitem xml:lang="zu">Talking Timbuktu</listitem>
      <listitem xml:lang="jz">The Birth of the Cool</listitem>
    </list>
Les résultats suivants ont été générés par la feuille de style :
    Your document contains 9 elements and 5 attributes.
    <Have a great day!>
La méthode de sortie text ayant été utilisée, l'attribut disable-output-escaping n'a aucun effet. Si vous modifiez la feuille de style pour utiliser <xsl:output method="html"/> ou <xsl:output method="xml"/>, l'attribut disable-output-escaping est alors utilisé. Les résultats de disable-output-escaping="yes" sont les suivants :
    Your document contains 10 elements and 2 attributes.
    <Have a great day!>
Et les résultats de disable-output-escaping="no" sont les suivants, avec comme valeur par défaut :
    Your document contains 10 elements and 2 attributes.
    <Have a great day!>