About Saxon
Change history
Licensing
Configuration
Handling XML documents
Using XSLT
Using XQuery
Using XPath
Using XML Schema (XSD)
Streaming
The Gizmo utility
SaxonCS
Localization
Extensibility mechanisms
Saxon extensions
QT4 extensions
Sample Saxon applications
Saxon SQL extension
Reference: XSLT elements
- xsl:accept
- xsl:accumulator
- xsl:accumulator-rule
- xsl:analyze-string
- xsl:apply-imports
- xsl:apply-templates
- xsl:array
- xsl:array-member
- xsl:assert
- xsl:attribute
- xsl:attribute-set
- xsl:break
- xsl:call-template
- xsl:catch
- xsl:character-map
- xsl:choose
- xsl:comment
- xsl:context-item
- xsl:copy
- xsl:copy-of
- xsl:decimal-format
- xsl:document
- xsl:element
- xsl:evaluate
- xsl:expose
- xsl:fallback
- xsl:field
- xsl:for-each
- xsl:for-each-group
- xsl:fork
- xsl:function
- xsl:global-context-item
- xsl:if
- xsl:import
- xsl:import-schema
- xsl:include
- xsl:item-type
- xsl:iterate
- xsl:key
- xsl:map
- xsl:map-entry
- xsl:matching-substring
- xsl:merge
- xsl:merge-action
- xsl:merge-key
- xsl:merge-source
- xsl:message
- xsl:mode
- xsl:namespace
- xsl:namespace-alias
- xsl:next-iteration
- xsl:next-match
- xsl:non-matching-substring
- xsl:note
- xsl:number
- xsl:on-completion
- xsl:on-empty
- xsl:on-non-empty
- xsl:otherwise
- xsl:output
- xsl:output-character
- xsl:override
- xsl:package
- xsl:package-location
- xsl:param
- xsl:perform-sort
- xsl:preserve-space
- xsl:processing-instruction
- xsl:record
- xsl:record-type
- xsl:result-document
- xsl:select
- xsl:sequence
- xsl:sort
- xsl:source-document
- xsl:strip-space
- xsl:stylesheet
- xsl:switch
- xsl:template
- xsl:text
- xsl:transform
- xsl:try
- xsl:use-package
- xsl:value-of
- xsl:variable
- xsl:when
- xsl:where-populated
- xsl:with-param
- Literal result elements
- XSLT patterns
Reference: XPath syntax
Reference: Function library
Standards conformance
Using this documentation

xsl:when

Used within an xsl:choose element to indicate one of a number of choices. In XSLT 4.0, it may also appear within xsl:switch.

Content: sequence-constructor
Permitted parent elements: xsl:choose

Attributes

`test`	`expression`	If this is the first `xsl:when` element within the enclosing `xsl:choose` whose test condition matches the current element, the content of the `xsl:when` element is expanded, otherwise it is ignored.
`select?`	`expression`	New in XSLT 4.0. Provides an alternative way of supplying the return value when the `test` condition matches; if present, the contained sequence constructor must be empty.

Saxon availability

Available in XSLT 1.0 and later versions. Requires Saxon-PE or Saxon-EE. Available for all platforms.

Notes on the Saxon implementation

The select attribute is available from Saxon 13 in XSLT 4.0; it is available in Saxon 10 to 12 provided that syntax extensions are enabled.

Details

Note that forwards-compatibility mode in previous versions of XSLT does not handle the select attribute particularly well. If an XSLT 3.0 processor encounters an xsl:when instruction with a select attribute, and the instruction has an effective version of 4.0, the select attribute will simply be ignored, which will generally give incorrect results.

Links to W3C specifications

XSLT 3.0 Specification

XSLT 4.0 Specification

See also