<html>
<head>


<title>&lt;xsl:message&gt;</title>
</head>
<body bgcolor="#FFFFFF" text="#000000">
<div id="Description">
<table cellpadding="0" cellspacing="0" border="0" width="100%" class="main">
<tr>
<td valign="top" class="NAME">&lt;xsl:message&gt;</td>
<td valign="top" class="COMPATIBILITY">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="divider"><img src="dwres:18084" width="100%" height="1"></td>
</tr>
<tr>
<td valign="top" colspan="2" class="description">
Envoie un message. La m&eacute;thode d'envoi du message peut varier d'un processeur XSLT &agrave; l'autre, mais le message est g&eacute;n&eacute;ralement &eacute;crit dans le p&eacute;riph&eacute;rique de sortie standard. Cet &eacute;l&eacute;ment permet de d&eacute;boguer des feuilles de style.</td></tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Cat&eacute;gorie</td>
</tr>
<tr>
<td colspan="2" class="description">
<p>Instruction</p>
</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Attributs obligatoires</td>
</tr>
<tr>
<td colspan="2" class="description">
<p>Aucun.</p>
</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Attributs facultatifs</td>
</tr>
<tr>
<td colspan="2" class="description">
<dl>
<dt>
terminate= &quot; yes &quot; | &quot; no &quot;
</dt>
<dd>
Si la valeur de cet attribut est <span class="LITERAL">yes</span>, le processeur XSLT arr&ecirc;te l'ex&eacute;cution apr&egrave;s avoir d&eacute;livr&eacute; ce message. La valeur par d&eacute;faut de cet attribut est <span class="LITERAL">no</span>&nbsp;; si l'attribut <span class="LITERAL">&lt; xsl:message &gt;</span> ne termine pas le processeur, le message est envoy&eacute; et le traitement se poursuit.
<P></p>
</dl>
</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Contenu</td>
</tr>
<tr>
<td colspan="2" class="description">
<p>Un mod&egrave;le XSLT.</p>
</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Appara&icirc;t dans</td>
</tr>
<tr>
<td colspan="2" class="description">
<p>
<span class="LITERAL">&lt;xsl:message&gt;</span> appara&icirc;t dans un mod&egrave;le. </p>
</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">D&eacute;fini dans</td>
</tr>
<tr>
<td colspan="2" class="description">
<p>XSLT section 13, Messages.</p>
</td>
</tr>
<tr>
<td colspan="2" class="CLEARSEPARATION">&nbsp;</td>
</tr>
<tr>
<td colspan="2" class="TITLE">Exemple</td>
</tr>
<tr>
<td colspan="2" class="description">
<p>La feuille de style suivante utilise l'&eacute;l&eacute;ment <span class="LITERAL">&lt;xsl:message&gt;</span> pour tracer la transformation d'un document XML. Reprenons notre liste d'albums r&eacute;cemment achet&eacute;s&nbsp;:</p>
<span class="PROGRAMLISTING"><pre>
&lt;?xml version=&quot;1.0&quot;?&gt;
&lt;list xml:lang=&quot;en&quot;&gt;
  &lt;title&gt;Albums I've bought recently:&lt;/title&gt;
  &lt;listitem&gt;The Sacred Art of Dub&lt;/listitem&gt;
  &lt;listitem&gt;Only the Poor Man Feel It&lt;/listitem&gt;
  &lt;listitem&gt;Excitable Boy&lt;/listitem&gt;
  &lt;listitem xml:lang=&quot;sw&quot;&gt;Aki Special&lt;/listitem&gt;
  &lt;listitem xml:lang=&quot;en-gb&quot;&gt;Combat Rock&lt;/listitem&gt;
  &lt;listitem xml:lang=&quot;zu&quot;&gt;Talking Timbuktu&lt;/listitem&gt;
  &lt;listitem xml:lang=&quot;jz&quot;&gt;The Birth of the Cool&lt;/listitem&gt;
&lt;/list&gt;</pre></span>
<p>Tous les albums achet&eacute;s sont r&eacute;pertori&eacute;s dans une table HTML dont la couleur d'arri&egrave;re-plan de chaque ligne alterne entre diff&eacute;rentes couleurs. La feuille de style utilise un &eacute;l&eacute;ment <span class="LITERAL">&lt;xsl:choose&gt;</span> dans un &eacute;l&eacute;ment <span class="LITERAL">&lt;xsl:attribute&gt;</span> pour d&eacute;terminer la valeur de l'attribut <span class="LITERAL">bgcolor</span>. Si un &eacute;l&eacute;ment <span class="LITERAL">&lt;listitem&gt;</span> donn&eacute; est converti en &eacute;l&eacute;ment HTML <span class="LITERAL">&lt;tr&gt;</span> avec pour couleur d'arri&egrave;re-plan <span class="LITERAL">lavender</span>, un message d'avertissement est envoy&eacute;&nbsp;:</p>
<span class="PROGRAMLISTING"><pre>
&lt;?xml version=&quot;1.0&quot;?&gt;
&lt;xsl:stylesheet version=&quot;1.0&quot; xmlns:xsl=&quot;http://www.w3.org/1999/XSL/Transform&quot;&gt;

  &lt;xsl:output method=&quot;html&quot;/&gt;

  &lt;xsl:template match=&quot;/&quot;&gt;
    &lt;html&gt;
      &lt;head&gt;
        &lt;title&gt;
          &lt;xsl:value-of select=&quot;list/title&quot;/&gt;
        &lt;/title&gt;
      &lt;/head&gt;
      &lt;body&gt;
        &lt;h1&gt;&lt;xsl:value-of select=&quot;list/title&quot;/&gt;&lt;/h1&gt;
        &lt;table border=&quot;1&quot;&gt;
          &lt;xsl:for-each select=&quot;list/listitem&quot;&gt;
            &lt;tr&gt;
              &lt;td&gt;
                &lt;xsl:attribute name=&quot;bgcolor&quot;&gt;
                  &lt;xsl:choose&gt;
                    &lt;xsl:when test=&quot;position() mod 4 = 0&quot;&gt;
                      &lt;xsl:text&gt;papayawhip&lt;/xsl:text&gt;
                    &lt;/xsl:when&gt;
                    &lt;xsl:when test=&quot;position() mod 4 = 1&quot;&gt;
                      &lt;xsl:text&gt;mintcream&lt;/xsl:text&gt;
                    &lt;/xsl:when&gt;
                    &lt;xsl:when test=&quot;position() mod 4 = 2&quot;&gt;
                      &lt;xsl:text&gt;lavender&lt;/xsl:text&gt;
                      &lt;xsl:message terminate=&quot;no&quot;&gt;
                        &lt;xsl:text&gt;Table row #&lt;/xsl:text&gt;
                        &lt;xsl:value-of select=&quot;position()&quot;/&gt;
                        &lt;xsl:text&gt; is lavender!&lt;/xsl:text&gt;
                      &lt;/xsl:message&gt;
                    &lt;/xsl:when&gt;
                    &lt;xsl:otherwise&gt;
                      &lt;xsl:text&gt;whitesmoke&lt;/xsl:text&gt;
                    &lt;/xsl:otherwise&gt;
                  &lt;/xsl:choose&gt;
                &lt;/xsl:attribute&gt;
                &lt;xsl:value-of select=&quot;.&quot;/&gt;
              &lt;/td&gt;
            &lt;/tr&gt;
          &lt;/xsl:for-each&gt;
        &lt;/table&gt;
      &lt;/body&gt;
    &lt;/html&gt;
  &lt;/xsl:template&gt;

&lt;/xsl:stylesheet&gt;</pre></span>
<p>La sp&eacute;cification XSLT ne d&eacute;finit pas la m&eacute;thode d'envoi du message. L'utilisation de la feuille de style avec Xalan 2.0.1 a permis d'obtenir les r&eacute;sultats suivants&nbsp;:</p>
<span class="PROGRAMLISTING"><pre>
file:///D:/O'Reilly/XSLT/bookSamples/AppendixA/message.xsl; Line 32; Column 51;
Table row #2 is lavender!
file:///D:/O'Reilly/XSLT/bookSamples/AppendixA/message.xsl; Line 32; Column 51;
Table row #6 is lavender!</pre></span> <!--<?troff .Nd 10?>-->
<p>Xalan fournit un compte-rendu sur la partie de la feuille de style ayant g&eacute;n&eacute;r&eacute; chaque message. Saxon, en revanche, vous simplifie la vie&nbsp;:</p>
<span class="PROGRAMLISTING"><pre>
Table row #2 is lavender!
Table row #6 is lavender!</pre></span>
<p>Par souci de diversit&eacute;, voici la m&eacute;thode employ&eacute;e par XT pour traiter l'&eacute;l&eacute;ment <span class="LITERAL">&lt;xsl:message&gt;</span>&nbsp;:</p>
<span class="PROGRAMLISTING"><pre>
file:/D:/O'Reilly/XSLT/bookSamples/AppendixA/test4.xml:5: Table row #2 is lavender!
file:/D:/O'Reilly/XSLT/bookSamples/AppendixA/test4.xml:9: Table row #6 is lavender!</pre></span>
<p>XT fournit des informations concernant la ligne du document XML source qui a g&eacute;n&eacute;r&eacute; le message.</p>
</td>
</tr>
</table>
</div>
</body>
</html>
