<xsl:number>
<xsl:number> 元素用於順序計數。它還可以用於快速格式化數字。
語法
<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-
定義在生成順序編號時應如何考慮源樹的級別。它有三個有效值:
single、multiple和any。預設值為single。single-
順序編號同級節點,就像列表中的項一樣。處理器會轉到
ancestor-or-self軸上與count屬性匹配的第一個節點,然後計數該節點及其所有前面的同級節點(如果存在from屬性,則在遇到匹配from屬性的節點時停止),這些節點也與count屬性匹配。如果沒有找到匹配項,則序列將是一個空列表。 multiple-
將節點編號為一個複合序列,反映節點的層級位置,例如:1.2.2.5。(巢狀格式可以透過
format屬性指定,例如 A.1.1)。處理器會檢視當前節點的所有祖先節點以及當前節點本身,如果在from屬性處有匹配項,則在此停止。對於此列表中的每個與count屬性匹配的節點,處理器會計算其有多少個前面的匹配同級節點,並加上該節點本身。如果沒有找到匹配項,則序列將是一個空列表。 any(目前不支援。)-
無論級別如何,順序編號所有匹配的節點。會考慮
ancestor、self和preceding軸。處理器從當前節點開始,按文件的倒序進行,如果在任何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-
消除使用字母的編號序列之間的歧義。有些語言有不止一種使用字母的編號系統。如果兩個系統以相同的標記開頭,可能會產生歧義。此屬性可以取值
alphabetic或traditional。預設為alphabetic。 grouping-separator-
指定用作分組(例如千位)分隔符的字元。預設為逗號 (
,)。 grouping-size-
指示構成數字組的位數。預設值為
3。
型別
指令,出現在模板內。
規範
XSLT,第 7.7 節
Gecko 支援情況
部分支援。請參閱上面的註釋。