xsl:number

value?

expression

Used to format a number obtained from an expression. If this attribute is present, the count, level, and from attributes are ignored.

select?

expression

If present, this is an expression that selects the node to be numbered. The default is ".", the context node.

level?

"single" | "multiple" | "any"

Defines the rules for calculating a number. The default is single. For details see the from attribute description.

count?

pattern

Pattern indicating which nodes to count; the default is to match all nodes of the same type and name as the current node.

from?

pattern

Pattern whose exact meaning of this depends on the level. The calculation is as follows:

format?

{ string }

Controls the output format. This contains an alternating sequence of format-tokens and punctuation-tokens. A format-token is any sequence of alphanumeric characters, a punctuation-token is any other sequence. The following values (among others) are supported for the format-token:

There is also support for various Japanese sequences (Hiragana, Katakana, and Kanji) using the format tokens &#x3042, &#x30a2, &#x3044, &#x30a4, &#x4e00, and for Greek and Hebrew sequences.

The format token "w" gives the sequence "one", "two", "three", ... , while "W" gives the same in upper-case, and "Ww" in title case. The language is determined by the lang attribute, for example lang="en" for English. Saxon currently supports Belgian French (fr-BE), Danish (da), Dutch (nl), English (en), Flemish (nl-BE), French (fr), German (de), Italian (it), Swedish (sw). Additional languages can be achieved by writing a Numberer class, as described in Localizing numbers and dates.

The default format is "1".

A sequence of Unicode digits other than ASCII digits (for exaple, Tibetan digits) can be used, and will result in decimal numbering using those digits.

Similarly, any other character classified as a letter can be used, and will result in "numbering" using all consecutive Unicode letters following the one provided. For example, specifying "x" will give the sequence x, y, z, xx, xy, xz, yx, yy, yz, etc. Specifying the Greek letter alpha (²) will cause "numbering" using the Greek letters up to "Greek letter omega with tonos" (Î). Only "i" and "I" (for roman numbering), and the Japanese characters listed above, are exceptions to this rule.

Successive format-tokens in the format are used to process successive numbers in the list. If there are more format-tokens in the format than numbers in the list, the excess format-tokens and punctuation-tokens are ignored. If there are fewer format-tokens in the format than numbers in the list, the last format-token and the punctuation-token that precedes it are used to format all excess numbers, with the final punctuation-token being used only at the end.

This character may be preceded or followed by arbitrary punctuation (anything other than these characters or XML special characters such as "<") which is copied to the output verbatim. For example, the value 3 with format "(a)" produces output "(c)".

lang?

{ language }

letter-value?

{ "alphabetic" | "traditional" }

ordinal?

{ string }

start-at?

{ integer }

New in XSLT 3.0. Allows numbering to start at a number other than one.

grouping-separator?

{ char }

grouping-size?

{ integer }

3

(1)

(3)

12

I

XII

2,3

1.1

2.3

2,3

1(i)

2(iii)

2,3

1.

2.3.

2,3

A.1.1

B.3.

2,3,4,5

1.1

2.3.4.5