diff options
Diffstat (limited to 'files/fr/web/xslt/element/number/index.md')
| -rw-r--r-- | files/fr/web/xslt/element/number/index.md | 193 |
1 files changed, 92 insertions, 101 deletions
diff --git a/files/fr/web/xslt/element/number/index.md b/files/fr/web/xslt/element/number/index.md index 3eeb7869de..3d01ed9e73 100644 --- a/files/fr/web/xslt/element/number/index.md +++ b/files/fr/web/xslt/element/number/index.md @@ -2,120 +2,111 @@ title: number slug: Web/XSLT/Element/number tags: -- Référence_XSLT + - Référence_XSLT translation_of: Web/XSLT/Element/number original_slug: Web/XSLT/number --- -<p>{{ XsltRef() }}</p> -<p>L'élément <code><xsl:number></code> compte des éléments de façon séquentielle. Il peut également être utilisé - pour formater rapidement un nombre.</p> - -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:number - count=EXPRESSION - level="single" | "multiple" | "any" - from=EXPRESSION - value=EXPRESSION - format=FORMAT-CHAÎNE - lang=XML:CODE-LANG - letter-value="alphabetic" | "traditional" - grouping-separator=CARACTÈRE - grouping-size=NOMBRE /></pre> - -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> - -<p>Aucun.</p> - -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> - -<dl> - <dt><code>count</code></dt> - <dd>Définit les éléments devant être numérotés de façon séquentielle dans l'arbre source. Il utilise une expression - XPath.</dd> - <dt><code>level</code></dt> - <dd> - <p>Définit la manière dont les niveaux de l'arbre source doivent pris en compte lors de la génération des - nombres séquentiels. Les trois valeurs possibles sont : <code>single</code>, <code>multiple</code> et - <code>any</code>. La valeur par défaut est <code>single</code> :</p> - <dl> - <dt><code>single</code></dt> - <dd>Numérote de façon séquentielle les nœuds descendants d'un même parent, à la manière des éléments d'une - liste. Le processeur va au premier nœud dans l'axe <a - href="fr/XPath/Axes/ancestor-or-self"><code>ancestor-or-self</code></a> qui correspond à l'attribut - <code>count</code>, puis compte ce nœud ainsi que tous les nœuds précédents issus de son parent (il - s'arrête lorsqu'il rencontre une référence à l'attribut <code>from</code>, si il en trouve une) qui - correspond également à l'attribut <code>count</code>. Si aucune correspondance n'est trouvée, la +{{ XsltRef() }} + +L'élément `<xsl:number>` compte des éléments de façon séquentielle. Il peut également être utilisé +pour formater rapidement un nombre. + +### Syntaxe + + <xsl:number + count=EXPRESSION + level="single" | "multiple" | "any" + from=EXPRESSION + value=EXPRESSION + format=FORMAT-CHAÎNE + lang=XML:CODE-LANG + letter-value="alphabetic" | "traditional" + grouping-separator=CARACTÈRE + grouping-size=NOMBRE /> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +- `count` + - : Définit les éléments devant être numérotés de façon séquentielle dans l'arbre source. Il utilise une expression + XPath. +- `level` + + - : Définit la manière dont les niveaux de l'arbre source doivent pris en compte lors de la génération des + nombres séquentiels. Les trois valeurs possibles sont : `single`, `multiple` et + `any`. La valeur par défaut est `single` : + + - `single` + - : Numérote de façon séquentielle les nœuds descendants d'un même parent, à la manière des éléments d'une + liste. Le processeur va au premier nœud dans l'axe [`ancestor-or-self`](fr/XPath/Axes/ancestor-or-self) qui correspond à l'attribut + `count`, puis compte ce nœud ainsi que tous les nœuds précédents issus de son parent (il + s'arrête lorsqu'il rencontre une référence à l'attribut `from`, si il en trouve une) qui + correspond également à l'attribut `count`. Si aucune correspondance n'est trouvée, la séquence produite sera une liste vide. - </dd> - <dt><code>multiple</code></dt> - <dd>Numérote les nœuds avec une séquence composite qui reflète la position hiérarchique du nœud, par exemple - 1.2.2.5. (le format peut être défini avec l'attribut <code>format</code>, par exemple A.1.1). Le - processeur vérifie tous les <a href="fr/XPath/Axes/ancestor"><code>ancestors</code></a> du nœud courant + - `multiple` + - : Numérote les nœuds avec une séquence composite qui reflète la position hiérarchique du nœud, par exemple + 1.2.2.5. (le format peut être défini avec l'attribut `format`, par exemple A.1.1). Le + processeur vérifie tous les [`ancestors`](fr/XPath/Axes/ancestor) du nœud courant ainsi que le nœud lui-même, il s'arrête lorsqu'il rencontre une correspondance avec l'attribut - <code>from</code>, si il y en a une. Pour chaque nœud de la liste qui vérifie l'attribut - <code>count</code>, le processeur compte combien il possède de frères vérifiant également cet attribut, + `from`, si il y en a une. Pour chaque nœud de la liste qui vérifie l'attribut + `count`, le processeur compte combien il possède de frères vérifiant également cet attribut, et ajoute un pour le nœud lui-même. Si aucune correspondance n'est trouvée, la séquence produite sera une liste vide. - </dd> - <dt><code>any</code> (Non supporté à l'heure actuelle)</dt> - <dd>Numérote tous les nœuds vérifiant <code>count</code> de façon séquentielle, sans considération de - niveau. Les axes <a href="fr/XPath/Axes/ancestor"><code>ancestor</code></a>, <a - href="fr/XPath/Axes/self"><code>self</code></a> et <a - href="fr/XPath/Axes/preceding"><code>preceding</code></a> sont tous pris en compte. Le processeur + - `any` (Non supporté à l'heure actuelle) + - : Numérote tous les nœuds vérifiant `count` de façon séquentielle, sans considération de + niveau. Les axes [`ancestor`](fr/XPath/Axes/ancestor), [`self`](fr/XPath/Axes/self) et [`preceding`](fr/XPath/Axes/preceding) sont tous pris en compte. Le processeur débute au nœud courant et continue dans l'ordre inverse du document, s'arrêtant s'il rencontre une - correspondance avec un attribut <code>from</code>. Si aucune correspondance avec l'attribut - <code>count</code> n'est trouvé,e la séquence produite sera une liste vide. Ce niveau n'est pas supporté + correspondance avec un attribut `from`. Si aucune correspondance avec l'attribut + `count` n'est trouvé,e la séquence produite sera une liste vide. Ce niveau n'est pas supporté à l'heure actuelle. - </dd> - </dl> - </dd> - <dt>from</dt> - <dd>Définit l'endroit où la numérotation doit débuter. La séquence débute avec le premier descendant du nœud - vérifiant l'attribut <code>from</code>.</dd> - <dt>value</dt> - <dd>Applique un format donné à un nombre. C'est un moyen rapide de formater un nombre fourni par l'utilisateur dans - un des formats standards de <code><xsl:number></code>.</dd> - <dt>format</dt> - <dd> - <p>Définit le format du nombre généré :</p> - <dl> - <dt>format="1"</dt> - <dd> <tt>1 2 3 …</tt> (C'est le seul format supporté à ce jour)</dd> - <dt>format="01"</dt> - <dd> <tt>01 02 03 … 09 10 11 …</tt></dd> - <dt>format="a"</dt> - <dd> <tt>a b c … y z aa ab …</tt></dd> - <dt>format="A"</dt> - <dd> <tt>A B C … Y Z AA AB …</tt></dd> - <dt>format="i"</dt> - <dd> <tt>i ii iii iv v …</tt></dd> - <dt>format="I"</dt> - <dd> <tt>I II III IV V …</tt></dd> - </dl> - </dd> - <dt>lang (Non supporté à l'heure actuelle)</dt> - <dd>Définit les alphabets pouvant être utilisés pour les formats de numérotation basés sur les lettres.</dd> - <dt>letter-value</dt> - <dd>Permet de lever l'ambiguïté sur les séquences numérotées qui utilisent des lettres. Certaines langues possèdent + +- from + - : Définit l'endroit où la numérotation doit débuter. La séquence débute avec le premier descendant du nœud + vérifiant l'attribut `from`. +- value + - : Applique un format donné à un nombre. C'est un moyen rapide de formater un nombre fourni par l'utilisateur dans + un des formats standards de `<xsl:number>`. +- format + + - : Définit le format du nombre généré : + + - format="1" + - : \<tt>1 2 3 …\</tt> (C'est le seul format supporté à ce jour) + - format="01" + - : \<tt>01 02 03 … 09 10 11 …\</tt> + - format="a" + - : \<tt>a b c … y z aa ab …\</tt> + - format="A" + - : \<tt>A B C … Y Z AA AB …\</tt> + - format="i" + - : \<tt>i ii iii iv v …\</tt> + - format="I" + - : \<tt>I II III IV V …\</tt> + +- lang (Non supporté à l'heure actuelle) + - : Définit les alphabets pouvant être utilisés pour les formats de numérotation basés sur les lettres. +- letter-value + - : Permet de lever l'ambiguïté sur les séquences numérotées qui utilisent des lettres. Certaines langues possèdent plus d'un système de numérotation utilisant les lettres. Si deux systèmes commencent avec le même glyphe, il - peut y avoir une ambiguïté. Ce attribut peut avoir la valeur <code>alphabetic</code> ou - <code>traditional</code>. La valeur par défaut est <code>alphabetic</code>. - </dd> - <dt>grouping-separator</dt> - <dd>Définit le caractère devant être utilisé pour les séparations des groupes (par exemple, le séparateur des - milliers). Le caractère par défaut est la virgule (<code>,</code>).</dd> - <dt>grouping-size</dt> - <dd>Définit le nombre de chiffres formant un groupe. La valeur par défaut est <code>3</code>.</dd> -</dl> + peut y avoir une ambiguïté. Ce attribut peut avoir la valeur `alphabetic` ou + `traditional`. La valeur par défaut est `alphabetic`. +- grouping-separator + - : Définit le caractère devant être utilisé pour les séparations des groupes (par exemple, le séparateur des + milliers). Le caractère par défaut est la virgule (`,`). +- grouping-size + - : Définit le nombre de chiffres formant un groupe. La valeur par défaut est `3`. -<h3 id="Type"> Type </h3> +### Type -<p>Instruction, apparaît dans un modèle.</p> +Instruction, apparaît dans un modèle. -<h3 id="D.C3.A9finition"> Définition </h3> +### Définition -<p><a href="http://www.w3.org/TR/xslt#number">XSLT 1.0, section 7.7</a>.</p> +[XSLT 1.0, section 7.7](http://www.w3.org/TR/xslt#number). -<h3 id="Support_Gecko"> Support Gecko </h3> +### Support Gecko -<p>Support partiel. Voir les commentaires ci-dessus.</p>
\ No newline at end of file +Support partiel. Voir les commentaires ci-dessus. |