Élément <xsl:message>
L'élément <xsl:message> envoie un message texte au tampon des messages ou à une boîte de dialogue de message, selon l'environnement dans lequel l'élément est appelé. Il génère également un message d'erreur au niveau du système qui peut être utilisé dans les mécanismes normaux de traitement des erreurs.
<xsl:message
terminate = "yes" | "no" >
</xsl:message>
Attributs
- terminate
Spécifie si la transformation doit s'achever lors de l'exécution de cette instruction. Cet attribut peut avoir l'une des deux valeurs de chaîne suivantes : « yes » ou « no ». Si l'attribut terminate est défini sur « yes », le contenu de l'élément est affiché comme partie du message d'erreur au niveau du système et la transformation s'achève. S'il est défini sur « no », la transformation se poursuit et ignore le message d'erreur. La valeur par défaut est "no".
Informations sur les éléments
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 |
xsl:apply-templates, xsl:attribute, xsl:call-template, xsl:choose, xsl:comment, xsl:copy, xsl:copy-of, xsl:element, xsl:for-each, xsl:if, xsl:processing-instruction, xsl:text, xsl:value-of, xsl:variable, éléments de sortie |
Notes
L'élément <xsl:message> fournit un mécanisme de débogage des feuilles de style XSLT en cours. Lorsqu'un élément <xsl:message> est rencontré, si l'indicateur terminate est défini sur "yes", le processeur XSLT se ferme et envoie un message d'erreur au niveau du système. Les expressions contenues dans l'élément <xsl:message> sont évaluées en fonction du contexte actuel, faisant de <xsl:message> un bon moyen de visualiser les éléments individuels.
Exemple
La rubrique suivante fournit un exemple d'élément <xsl:message>.