Skip to main content

XSLT <xsl:message> Element

The <xsl:message> element is used to display error messages to help debug XSLT processing.

It is similar to JavaScript alerts.

This element buffers a message to the XSLT processor that finishes processing and sends a message to the calling application to display an error message.

<xsl:message> Element

Syntax

The syntax of <xsl:message> is as follows:

<xsl:message 
terminate="yes|no" >
</xsl:message>

Attributes

The table describes the meaning of the attributes of <xsl:message>:

NameDescription
terminateIt specifies whether the transformation should terminate upon executing this instruction or not. Default value is "yes".

Example

Let's see an example:

books.xml
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet type="text/xsl" href="books.xsl"?>

<bookstore>
<book category="children">
<title lang="en">Harry Potter</title>
<author>J K. Rowling</author>
<year>2005</year>
<price>29.99</price>
</book>
<book category="web">
<title lang="en">XQuery Tips</title>
<author>Tom Nolan</author>
<year>2022</year>
<price>39.99</price>
</book>
<book category="web">
<title lang="en">Learn XML</title>
<author>Tutorial Reference</author>
<year>2022</year>
<price>9.99</price>
</book>
</bookstore>
books.xsl
<?xml version="1.0" encoding="UTF-8"?>

<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">

<xsl:template match="/">
<html>
<body>
<h2>The Bookstore</h2>
<table border="1">
<tr bgcolor="#6565d5">
<th>Title</th>
<th>Author</th>
<th>Year</th>
<th>Price</th>
</tr>
<xsl:for-each select="bookstore/book">

<xsl:if test="author = ''">
<xsl:message terminate="yes">An author field is empty.
</xsl:message>
</xsl:if>

<tr>
<td><xsl:value-of select="title"/></td>
<td><xsl:value-of select="author"/></td>
<td><xsl:value-of select="year"/></td>
<td><xsl:value-of select="price"/></td>
</tr>
</xsl:for-each>
</table>
</body>
</html>
</xsl:template>

</xsl:stylesheet>