Home >
Online Product Documentation >
Table of Contents >
xsl:number
xsl:number
Inserts a formatted number into the result tree.
Format
Description
You can use the
value
attribute to specify an expression for the number to be inserted. The XSLT processor evaluates the expression. The resulting object is converted to a number as if by a call to the
number()
function. The processor rounds the number to an integer and then uses the specified attributes to convert it to a string. The value of each attribute is interpreted as an attribute value template. After conversion, the resulting string is inserted in the result tree.
The following attributes control how the current node is to be numbered:
- The
level
attribute specifies what levels of the source tree should be considered. The default is
single
.
- The
count
attribute is a pattern that specifies what nodes should be counted at those levels.
- The
from
attribute is a pattern that specifies where counting starts.
- The
value
attribute can specify an expression that represents the number you want to insert. If no value attribute is specified, the XSLT processor inserts a number based on the position of the current node in the source tree.
- The
format
attribute specifies the format for each number in the list. The default is
1
.
- The
lang
attribute specifies which language's alphabet is to be used.
- The
letter-value
attribute distinguishes between the numbering sequences that use letters.
- The
grouping-separator
attribute specifies the separator used as a grouping (for example, thousands) separator in decimal numbering sequences.
- The
grouping-size
attribute specifies the size of the grouping. Normally, this is
3
.
Example
The following example numbers a sorted list: