<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 表示式。

level

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

single

順序編號同級節點,就像列表中的項一樣。處理器會轉到 ancestor-or-self 軸上與 count 屬性匹配的第一個節點,然後計數該節點及其所有前面的同級節點(如果存在 from 屬性,則在遇到匹配 from 屬性的節點時停止),這些節點也與 count 屬性匹配。如果沒有找到匹配項,則序列將是一個空列表。

multiple

將節點編號為一個複合序列,反映節點的層級位置,例如:1.2.2.5。(巢狀格式可以透過 format 屬性指定,例如 A.1.1)。處理器會檢視當前節點的所有 祖先 節點以及當前節點本身,如果在 from 屬性處有匹配項,則在此停止。對於此列表中的每個與 count 屬性匹配的節點,處理器會計算其有多少個前面的匹配同級節點,並加上該節點本身。如果沒有找到匹配項,則序列將是一個空列表。

any (目前不支援。)

無論級別如何,順序編號所有匹配的節點。會考慮 ancestorselfpreceding 軸。處理器從當前節點開始,按文件的倒序進行,如果在任何 from 屬性處遇到匹配項則停止。如果沒有找到匹配 count 屬性的節點,則序列將是一個空列表。此級別目前不支援。

from

指定編號的起始位置或重置編號的位置。序列從匹配 from 屬性的節點的第一個後代開始。

value

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

格式(format)

定義生成的數字的格式

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 (目前不支援。)

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

letter-value

消除使用字母的編號序列之間的歧義。有些語言有不止一種使用字母的編號系統。如果兩個系統以相同的標記開頭,可能會產生歧義。此屬性可以取值 alphabetictraditional。預設為 alphabetic

grouping-separator

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

grouping-size

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

型別

指令,出現在模板內。

規範

XSLT,第 7.7 節

Gecko 支援情況

部分支援。請參閱上面的註釋。