xsl:message

Causes a message to be displayed.

Category: instruction
Content: sequence-constructor
Permitted parent elements: any XSLT element whose content model is sequence-constructor; any literal result element

Attributes

select?

expression

The content of the message may be specified using either or both of the select attribute and the enclosed sequence constructor. If a select attribute is used, then the value must be an XPath expression, and the effect is the same as if a single xsl:copy-of element with this select attribute were added to the start of the sequence constructor.

terminate?

{ boolean }

If the value is set to yes, processing of the stylesheet is terminated after issuing the message. The default is no. This attribute may be supplied as an attribute value template.

error-code?

{ eqname }

New in XSLT 3.0. Specifies the error code associated with the message. The effective value should be an EQName. The default is Q{http://www.w3.org/2005/xqt-errors}XTMM9000.

Notes on the Saxon implementation

From Saxon 9.5 the new feature of text value templates is implemented, which is particularly useful with xsl:message. For example:

<xsl:message expand-text="yes">Id: {@id} Age: {@age} Status: {@status}</xsl:message>

The attribute expand-text="yes" can appear on any ancestor element to enable the feature.

Details

By default the message is displayed on the standard error output stream. You can supply your own message receiver if you want it handled differently. This must be a class that implements the Receiver interface. The content of the message is in general an XML fragment. You can supply the Receiver using the -m option on the command line, or the setMessageEmitter() method of the Controller class.

The sequence of calls to this Receiver is as follows: there is a single open() call at the start of the transformation, and a single close() call at the end; and each evaluation of an xsl:message instruction starts with a startDocument() call and ends with endDocument(). The startDocument() event has a properties argument indicating whether terminate="yes" was specified, and the locationId on calls such as startElement() and characters() can be used to identify the location in the stylesheet where the message data originated (this is achieved by passing the supplied locationId in a call to getPipelineConfiguration().getLocator().getSystemId(locationId), or to getLineNumber() on the same object).

Select the class MessageWarner to have xsl:message output notified to the JAXP ErrorListener, as described in the JAXP documentation.

Links to W3C specifications

XSLT 2.0 Specification

XSLT 3.0 Specification

See also

xsl:result-document