The <xslt> element

The xslt element of the configuration file contains properties specific to XSLT. Remember that these are defaults; they can always be overridden for specific queries or transformations. An attribute whose value is set to a zero-length string is ignored: the effect is the same as omitting the attribute.

Attribute

Applies to

Values

Effect

disableXslEvaluate

EE

true|false

If set, the use of the xsl:evaluate instruction in XSLT 3.0 is disabled.

enableAssertions

PE EE

true|false

Indicates whether assertions (XSLT 3.0 xsl:assert instructions) are enabled.

initialMode

HE PE EE

A mode name (QName in Clark notation {uri}local)

The name of a mode within a stylesheet in which execution should begin.

initialTemplate

HE PE EE

A template name (QName in Clark notation {uri}local)

The name of a named template within a stylesheet where execution should begin.

messageEmitter

HE PE EE

String

From Saxon 11.1, this option has no effect.

outputUriResolver

HE PE EE

Name of a class implementing OutputURIResolver

Handles documents written using xsl:result-document.

recoveryPolicy

HE PE EE

recoverWithWarnings|recoverSilently| doNotRecover

Previously used to indicate how XSLT recoverable errors were handled, but since the XSLT 3.0 specification has eliminated these, the property is deprecated from Saxon 10.0.

resultDocumentThreads

EE

integer

Indicates the maximum number of threads to be used for processing xsl:result-document instructions in parallel.

schemaAware

EE

true|false

Indicates whether stylesheet should be compiled to be able to handle schema-typed input, even if they contain no xsl:import-schema declaration.

staticErrorListener

HE PE EE

Name of a class implementing the JAXP javax.xml.transform.ErrorListener interface

Receives reports of compile-time errors in a stylesheet.

staticUriResolver

HE PE EE

Name of a class implementing the JAXP javax.xml.transform.URIResolver interface

User-defined class for dereferencing URIs on xsl:include or xsl:import.

strictStreamability

EE

true|false

Causes the XSLT processor to verify that constructs that are declared streamable are in fact "guaranteed streamable" according to the W3C rules.

styleParser

HE PE EE

Name of a class implementing the org.xml.sax.XMLReader interface; or "#DEFAULT".

XML parser used for stylesheets and schema documents.

version

HE PE EE

3.0, 4.0

XSLT language version to be supported by the processor.

versionWarning

HE PE EE

true|false

False suppresses the warning produced when the XSLT processor version is not the same as the version in the xsl:stylesheet element. From Saxon 9.8, the warning is no longer output, so this attribute is ignored.

The xslt element may also contain one or more extensionElement children defining namespaces used for extension instructions. Each extensionElement element must have the following attributes:

Attribute

Applies to

Values

Effect

factory

PE EE

Name of class implementing the Saxon interface ExtensionElementFactory

Links to the implementation of the various extension instructions in the specified namespace.

namespace

PE EE

A namespace URI

The namespace URI of the extension instructions.