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>

Table of Contents