XSLT <xsl:message> Element

XSLT Element

Definition and Usage

The <xsl:message> element can write a message to the output. This element is mainly used for reporting errors.

This element can contain almost any other XSL element (<xsl:text>, <xsl:value-of>, etc.).

The terminate attribute allows you to choose whether to terminate the transformation when an error occurs.

Syntax

<xsl:message terminate="yes|no">
  <!-- Content:template -->
</xsl:message>

Attribute

Attribute Value Description
terminate
  • yes
  • no
 Optional. "yes": Terminate processing after writing the message to the output. "no": Continue processing after writing the message. The default is "no".

Instance

Example 1

Check if the artist is an empty string. If it is, exit the XSL processor and display a message:

<?xml version="1.0" encoding="ISO-8859-1"?>
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:template match="/">
  <html>
  <body>
  <xsl:for-each select="catalog/cd">
    <p>Title: <xsl:value-of select="title"/><br />
    Artist:
    <xsl:if test="artist=''">
      <xsl:message terminate="yes">
        Error: Artist is an empty string!
      </xsl:message>
    </xsl:if>
    <xsl:value-of select="artist"/>
    </p>
  </xsl:for-each>
  </body>
  </html>
</xsl:template>
</xsl:stylesheet>

XSLT Element