XSLT <xsl:message>Element
Complete XSLT Element Reference Manual
Definition and Usage
The <xsl:message> element writes a message to the output. This element is mainly used for reporting errors.
This element can contain almost any other XSLT elements (<xsl:text>, <xsl:value-of>, and so on).
The terminate attribute allows you to choose whether to exit processing or continue processing when an error occurs.
Syntax
<xsl:message terminate="yes|no">
<!-- Content:template -->
</xsl:message>
<!-- Content:template -->
</xsl:message>
Attributes
| Attribute | Value | Description |
|---|---|---|
| terminate | yes no |
Optional. "yes": terminates processing after the message is written to the output. "no": continues processing after the message is written to the output. Default is "no". |
Example 1
Checks whether the artist is an empty string. If so, it exits the XSL processor and displays 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>
<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>
Complete XSLT Element Reference Manual Other Extensions