<xsl:number>

<xsl:number> 元素按順序對內容進行計數。它還可以用於快速格式化數字。

語法

xml
<xsl:number
  count=EXPRESSION
  level="single" | "multiple" | "any"
  from=EXPRESSION
  value=EXPRESSION
  format=FORMAT-STRING
  lang=XML:LANG-CODE
  letter-value="alphabetic" | "traditional"
  grouping-separator=CHARACTER
  grouping-size=NUMBER  />

必需屬性

無。

可選屬性

計數

指定源樹中應按順序編號的內容。它使用 XPath 表示式。

級別

定義在生成順序號時應如何考慮源樹的級別。它有三個有效值:singlemultipleany。預設值為 single

單一

按順序對同級節點進行編號,例如列表中的專案。處理器轉到與 count 屬性匹配的ancestor-or-self 軸中的第一個節點,然後對該節點及其所有前面的同級節點進行計數(如果存在 from 屬性,則在到達與該屬性匹配的節點時停止),這些節點也與 count 屬性匹配。如果未找到匹配項,則序列將為空列表。

多個

將節點編號為一個複合序列,該序列反映了節點的層次位置,例如 1.2.2.5。(巢狀格式可以使用 format 屬性指定,例如 A.1.1)。處理器檢視當前節點的所有祖先和當前節點本身,在到達與 from 屬性匹配的節點時停止。對於此列表中與 count 屬性匹配的每個節點,處理器都會計算它前面有多少個匹配的同級節點,併為該節點本身新增 1。如果未找到匹配項,則序列將為空列表。

any(目前不支援。)

對所有匹配的節點進行編號,而不管級別如何,按順序進行。考慮所有祖先自身前面 軸。處理器從當前節點開始,並以相反的文件順序進行,如果到達與任何 from 屬性匹配的節點則停止。如果未找到與 count 屬性匹配的項,則序列將為空列表。此級別目前不受支援。

指定編號應從何處開始或重新開始。序列從與 from 屬性匹配的節點的第一個後代開始。

將給定的格式應用於數字。這是一種快速方法,可以在任何標準 <xsl:number> 格式中格式化使用者提供的數字(而不是節點序列號)。

格式

定義生成的數字的格式

format="1"

1 2 3 ...(這是目前唯一支援的格式)

format="01"

01 02 03 . . . 09 10 11 . . .

format="a"

a b c ...y z aa ab ...

format="A"

A B C ... Y Z AA AB ...

format="i"

i ii iii iv v ...

format="I"

I II III IV V ...

lang(目前不支援。)

指定在基於字母的編號格式中應使用哪種語言的字母表。

字母值

消除使用字母的編號序列之間的歧義。某些語言有多個使用字母的編號系統。如果兩個系統都以相同的標記開頭,則可能會產生歧義。此屬性可以具有值“alphabetic”或“traditional”。預設為“alphabetic”。

分組分隔符

指定應將哪個字元用作組(例如千位)分隔符。預設為逗號 (,)。

分組大小

指示構成數字組的數字位數。預設值為“3”。

型別

指令,出現在模板內。

規範

XSLT,第 7.7 節

Gecko 支援

部分支援。請參閱以上註釋。