xsl:number Element

9/8/2008

Insere um formatado número na árvore de resultado.

Syntax

<xsl:number
  level = "single" | "multiple" | "any"
  count = pattern 
  from = pattern 
  value = number-expression 
  format = { string }
  lang = { nmtoken }
  letter-value = { "alphabetic" | "traditional" }
  grouping-separator = { char }
  grouping-size = { number } />

Atributos

• nível
  Especifica quais níveis da árvore de origem devem ser considerado; Ele tem o único valores, múltiplo ou qualquer. O usar como padrão é único.

• contagem
  Um padrão que especifica quais nós deve ser considerado esses níveis. Se a pasta contagem atributo não é especificado, então ele padrão é o padrão que Corresponde qualquer nó com o mesmo tipo de nó como o atual nó e, se o atual nó possui uma expandida-nome, com a mesma nome como o atual expandida nó.

• a partir
  Um padrão que especifica onde contagem é iniciado.

• valor
  Especifica a expressão a ser convertido em um número e saída para a árvore de resultados. Se nenhum valor atributo for especificado, em seguida, o < xsl:number > elemento insere um número baseia a posição do atual nó na árvore de origem.

• formato
  Uma seqüência de símbolos que especifica o formato a ser usado para cada número na lista. Não se houver tokens nenhum formato, em seguida, o valor usar como padrão de 1 é usada que gera uma seqüência 1 2... 10 11 12.... Cada número após o primeiro é separado a partir de acima número pelo token separador acima o token formato usado para formato desse número. Se não houver nenhum tokens separador, um caractere período será usado ". ".

  Formato token	Seqüência gerada
  1	1 2 3 4 5 ... 10 11 12 ...
  01	01 02 03 ... 19 10 11 ... 99 100 101...
  A	Um C B... Z aa AB corrente alternada
  i	i II III IV v vi VII VIII ix x
  Eu	Eu III II IV IX X VII VIII vi V

• Lang
  Especifica alfabeto do qual linguagem é usado. Se nenhum valor Lang for especificado, a linguagem é determinada do ambiente de sistema.

• letra-valor
  Disambiguates entre numeração seqüências que usam letras. Numeração uma seqüência atribui valores numéricos a letras em alfabético seqüência e o outro atribui valores numéricos para cada letra de alguns outra maneira tradicional dessa linguagem. Em inglês, esses corresponder para a numeração seqüências especificadas por símbolos de formato "um" e "i". Em alguns idiomas, o primeiro membro de cada seqüência é o mesmo e, portanto, o token formato sozinho seria ambíguo. Um valor de "alfabético" Especifica o alfabético seqüência; Um valor de "tradicional" Especifica a outra seqüência. O padrão é "alfabético."

• agrupamento-separador
  Retorna o separador usada como um agrupamento (por exemplo, milhares) separador em decimal numeração seqüências. Por exemplo agrupamento-separador= "," e agrupamento-tamanho= "3" Seria gerar números da forma 1,000,000. Se apenas um do agrupamento-separador e agrupamento-tamanho Atributos é especificado, então ele será ignorado.

• agrupamento-tamanho
  Especifica o tamanho (geralmente 3) do agrupamento. Por exemplo agrupamento-separador= "," e agrupamento-tamanho= "3" Seria gerar números da forma 1,000,000. Se apenas um do agrupamento-separador e agrupamento-tamanho Atributos é especificado, então ele será ignorado.

Elemento informações

Número de ocorrências	Ilimitado
Elementos pai	xsl:Copy, xsl:element, xsl: for-each, IF, xsl:otherwise, xsl:param, xsl: template, xsl:variable, xsl: when, xsl: com-param, saída elementos
Elementos filho	(Nenhum elementos filho)

Remarks

O número a ser inserido é especificado por uma expressão contido o valor atributo. A expressão é avaliada e o objeto resultante é convertido em um número. O número é arredondado para um inteiro e em seguida, convertido em um seqüência de caracteres e inserido na árvore de resultado.

O < xsl:number > elemento primeiro constrói uma lista de números inteiros positivos usando o nível, contagem e de atributos:

• Quando nível= "simples", ele vai backup para o primeiro nó no eixo ancestor-or-Self que corresponda ao padrão de contagem e constrói uma lista de comprimento contendo uma mais o número de acima irmãos do que predecessor que correspondam ao padrão de contagem. Se não houver nenhum tal predecessor, ela constrói um vazio lista. Se a pasta a partir atributo for especificado, então os predecessores apenas que são pesquisados são aqueles que são descendentes do predecessor mais próximo que corresponde a a partir padrão. Anterior-irmãos tem o mesmo significado aqui como com o eixo preceding-sibling.
• Quando nível= "múltiplo", ela constrói uma lista de todos os predecessores do atual nó na ordem documento seguido o elemento próprio; Ele, em seguida, seleciona a partir de lista os nós que correspondem a contagem padrão; Ela mapeia, em seguida, cada nó na lista para uma mais o número de acima irmãos desse nó que correspondam ao padrão de contagem. Se do atributo é especificado, então os predecessores apenas que são pesquisados são aqueles que são descendentes do predecessor mais próximo que corresponde a a partir padrão. Anterior irmãos tem o mesmo significado aqui como com o eixo preceding-sibling.
• Quando nível= "Qualquer", ela constrói uma lista de comprimento um contendo o número de nós que coincidir com o padrão contagem e que pertençam ao conjunto que contém o atual nó e todos os nós em qualquer nível do documento que estão antes o atual nó na ordem documento, excluindo qualquer nome nós espaço e atributo (in other words a união dos membros da acima e eixos predecessor-ou-auto). Se a pasta a partir atributo é especificados, somente nós após o primeiro nó antes de atual nó que correspondem a a partir padrão são considerados.

O seguinte idiomas/numeração esquemas são com suporte. " Formatar token" Corresponde à formato atributo, "Idioma" corresponde ao "Lang" atributo e "carta-valor" Corresponde à letra-valor atributo.

Descrição	Formatar token	Idioma	Letra-valor
Idiomas da Europa Ocidental	0x0031 (1)	n/d	n/d
Superior-maiúsculas e minúsculas letra	0x0041 (A)	n/d	n/d
Letra minúscula	0x0061 (um)	n/d	n/d
Superior-maiúsculas e minúsculas Roman	0x0049 (I)	n/d	n/d
Romano minúscula	0x0069 (i)	n/d	n/d
Superior-maiúsculas e minúsculas russo (cirílico)	0x0410	n/d	n/d
MINÚSCULA russo (cirílico)	0x0430	n/d	n/d
Hebraico alfabético	0x05d0	n/d	Alfabético
Hebraico tradicional	0x05d0	n/d	Tradicional
Árabe	0x0623	n/d	n/d
Consonants em hindi	0x0905	n/d	n/d
Vowels em hindi	0x0915	n/d	n/d
Os números em hindi	0x0967	n/d	n/d
Cartas em tailandês	0x0e01	n/d	n/d
Números tailandeses	0x0e51	n/d	n/d
Aiueo em Japonês (duplo-byte)	0x30a2	n/d	n/d
Iroha em Japonês (duplo-byte)	0x30a4	n/d	n/d
Chosung em coreano	0x3131	n/d	n/d
Decimal Taiwanês	0x4e01	"zh-tw"	n/d
Casas decimais em coreano	0x4e01	"Ko"	n/d
Muito Leste decimal	0x4e01	Quaisquer outros Lang	n/d
Kanji do Extremo Oriente	0x58f1	n/d	n/d
Taiwanese tradicional	0x58f9	"zh-tw"	n/d
Chinês Tradicional	0x58f9	Quaisquer outros Lang	n/d
Chinês "Zodiacal" 12	0x5b50	n/d	n/d
Chinês "Zodiacal" 10	0x7532	n/d	n/d
Chinês "Zodiacal" 60	0x7532, 0x5b50	n/d	n/d
Ganada em coreano	0xac00	n/d	n/d
Casas decimais em coreano	0xc77c	n/d	n/d
99 Coreano	0xd558	n/d	n/d
Idiomas da Europa Ocidental (duplo-byte)	0xff11	n/d	n/d
Aiueo em Japonês (único-byte)	0xff71	n/d	n/d
Iroha em Japonês (único-byte)	0xff72	n/d	n/d

Se o token formato sozinho for suficiente para disambiguate um determinado esquema numerado, não é necessário para especificar a linguagem ou letra-valor.

Example

O seguinte exemplo demonstra o uso do < xsl:number > elemento.

<xsl:template match="items">
  <xsl:for-each select="item">
    <xsl:sort select="."/>
    <p>
      <xsl:number value="position()" format="1. "/>
      <xsl:value-of select="."/>
    </p>
  </xsl:for-each>
</xsl:template>

Aqui estão alguns exemplos das especificações conversão.

format="ア" specifies Katakana numbering.
format="イ" specifies Katakana numbering in the "iroha" order.
format="๑" specifies numbering with Thai digits.
format="א" letter-value="traditional" specifies "traditional" Hebrew numbering.
format="ა" letter-value="traditional" specifies Georgian numbering.
format="α" letter-value="traditional" specifies "classical" Greek numbering.
format="а" letter-value="traditional" specifies Old Slavic numbering.

See Also

Reference

XSLT Elements