From ea0377b93b3d290053fda7115929930b8c8d4d25 Mon Sep 17 00:00:00 2001 From: julieng Date: Thu, 11 Nov 2021 09:00:12 +0100 Subject: convert content to md --- files/fr/web/xpath/axes/ancestor-or-self/index.md | 4 +- files/fr/web/xpath/axes/ancestor/index.md | 4 +- files/fr/web/xpath/axes/attribute/index.md | 4 +- files/fr/web/xpath/axes/child/index.md | 4 +- .../fr/web/xpath/axes/descendant-or-self/index.md | 4 +- files/fr/web/xpath/axes/descendant/index.md | 4 +- files/fr/web/xpath/axes/following-sibling/index.md | 4 +- files/fr/web/xpath/axes/following/index.md | 4 +- files/fr/web/xpath/axes/index.md | 156 +++--- files/fr/web/xpath/axes/namespace/index.md | 7 +- files/fr/web/xpath/axes/parent/index.md | 4 +- files/fr/web/xpath/axes/preceding-sibling/index.md | 4 +- files/fr/web/xpath/axes/preceding/index.md | 4 +- files/fr/web/xpath/axes/self/index.md | 4 +- .../xpath/comparison_with_css_selectors/index.md | 46 +- files/fr/web/xpath/functions/boolean/index.md | 56 ++- files/fr/web/xpath/functions/ceiling/index.md | 53 +- files/fr/web/xpath/functions/concat/index.md | 43 +- files/fr/web/xpath/functions/contains/index.md | 38 +- files/fr/web/xpath/functions/count/index.md | 43 +- files/fr/web/xpath/functions/current/index.md | 53 +- files/fr/web/xpath/functions/document/index.md | 80 +-- .../web/xpath/functions/element-available/index.md | 43 +- files/fr/web/xpath/functions/false/index.md | 49 +- files/fr/web/xpath/functions/floor/index.md | 49 +- .../fr/web/xpath/functions/format-number/index.md | 66 +-- .../xpath/functions/function-available/index.md | 43 +- files/fr/web/xpath/functions/generate-id/index.md | 60 ++- files/fr/web/xpath/functions/id/index.md | 53 +- files/fr/web/xpath/functions/index.md | 78 ++- files/fr/web/xpath/functions/key/index.md | 62 +-- files/fr/web/xpath/functions/lang/index.md | 95 ++-- files/fr/web/xpath/functions/last/index.md | 41 +- files/fr/web/xpath/functions/local-name/index.md | 50 +- files/fr/web/xpath/functions/name/index.md | 50 +- .../fr/web/xpath/functions/namespace-uri/index.md | 56 ++- .../web/xpath/functions/normalize-space/index.md | 30 +- files/fr/web/xpath/functions/not/index.md | 50 +- files/fr/web/xpath/functions/number/index.md | 53 +- files/fr/web/xpath/functions/position/index.md | 58 ++- files/fr/web/xpath/functions/round/index.md | 50 +- files/fr/web/xpath/functions/starts-with/index.md | 43 +- .../fr/web/xpath/functions/string-length/index.md | 43 +- files/fr/web/xpath/functions/string/index.md | 66 +-- .../web/xpath/functions/substring-after/index.md | 64 ++- .../web/xpath/functions/substring-before/index.md | 64 ++- files/fr/web/xpath/functions/substring/index.md | 65 +-- files/fr/web/xpath/functions/sum/index.md | 50 +- .../web/xpath/functions/system-property/index.md | 54 +- files/fr/web/xpath/functions/translate/index.md | 105 ++-- files/fr/web/xpath/functions/true/index.md | 34 +- .../xpath/functions/unparsed-entity-url/index.md | 43 +- files/fr/web/xpath/index.md | 86 ++-- .../index.md | 552 +++++++++++---------- 54 files changed, 1513 insertions(+), 1415 deletions(-) (limited to 'files/fr/web/xpath') diff --git a/files/fr/web/xpath/axes/ancestor-or-self/index.md b/files/fr/web/xpath/axes/ancestor-or-self/index.md index 5094b970ea..1dcb496321 100644 --- a/files/fr/web/xpath/axes/ancestor-or-self/index.md +++ b/files/fr/web/xpath/axes/ancestor-or-self/index.md @@ -3,6 +3,4 @@ title: ancestor-or-self slug: Web/XPath/Axes/ancestor-or-self translation_of: Web/XPath/Axes/ancestor-or-self --- -

-

L'axe ancestor-or-self indique le nœud de contexte courant ainsi que tous ses ascendants, y compris le nœud racine. -

\ No newline at end of file +L'axe `ancestor-or-self` indique le nœud de contexte courant ainsi que tous ses ascendants, y compris le nœud racine. diff --git a/files/fr/web/xpath/axes/ancestor/index.md b/files/fr/web/xpath/axes/ancestor/index.md index da3da048d6..bffc0e98db 100644 --- a/files/fr/web/xpath/axes/ancestor/index.md +++ b/files/fr/web/xpath/axes/ancestor/index.md @@ -3,6 +3,4 @@ title: ancestor slug: Web/XPath/Axes/ancestor translation_of: Web/XPath/Axes/ancestor --- -

-

L'axe ancestor indique tous les ascendants du nœud de contexte, du nœud parent jusqu'au nœud racine. -

\ No newline at end of file +L'axe `ancestor` indique tous les ascendants du nœud de contexte, du nœud parent jusqu'au nœud racine. diff --git a/files/fr/web/xpath/axes/attribute/index.md b/files/fr/web/xpath/axes/attribute/index.md index 2d23fbe176..05b733ddb7 100644 --- a/files/fr/web/xpath/axes/attribute/index.md +++ b/files/fr/web/xpath/axes/attribute/index.md @@ -3,6 +3,4 @@ title: attribute slug: Web/XPath/Axes/attribute translation_of: Web/XPath/Axes/attribute --- -

-

L'axe attribute axis indique les attributs du nœud de contexte. Seuls les éléments ont des attributs. Cet axe peut être abrégé avec le signe arobase (@). -

\ No newline at end of file +L'axe `attribute` axis indique les attributs du nœud de contexte. Seuls les éléments ont des attributs. Cet axe peut être abrégé avec le signe arobase (`@`). diff --git a/files/fr/web/xpath/axes/child/index.md b/files/fr/web/xpath/axes/child/index.md index 71b117b5a7..49dafca405 100644 --- a/files/fr/web/xpath/axes/child/index.md +++ b/files/fr/web/xpath/axes/child/index.md @@ -3,6 +3,4 @@ title: child slug: Web/XPath/Axes/child translation_of: Web/XPath/Axes/child --- -

-

L'axe child indique les enfants du nœud de contexte. Si une expression XPath ne spécifie pas d'axe, il est compris par défaut. Comme seuls le nœud racine et les nœuds element ont des enfants, toute autre utilisation ne sélectionnera rien. -

\ No newline at end of file +L'axe `child` indique les enfants du nœud de contexte. Si une expression XPath ne spécifie pas d'axe, il est compris par défaut. Comme seuls le nœud racine et les nœuds element ont des enfants, toute autre utilisation ne sélectionnera rien. diff --git a/files/fr/web/xpath/axes/descendant-or-self/index.md b/files/fr/web/xpath/axes/descendant-or-self/index.md index 465710191e..5a103ab555 100644 --- a/files/fr/web/xpath/axes/descendant-or-self/index.md +++ b/files/fr/web/xpath/axes/descendant-or-self/index.md @@ -3,6 +3,4 @@ title: descendant-or-self slug: Web/XPath/Axes/descendant-or-self translation_of: Web/XPath/Axes/descendant-or-self --- -

-L'axe descendant-or-self indique le nœud de contexte et tout ses descendants. Les nœuds attribute et namespace ne sont pas compris - le parent d'un nœud attribute est un nœud element, mais les nœuds attribute ne sont pas les enfants de leur parent. -

\ No newline at end of file +L'axe `descendant-or-self` indique le nœud de contexte et tout ses descendants. Les nœuds `attribute` et `namespace` ne sont pas compris - le parent d'un nœud `attribute` est un nœud `element`, mais les nœuds `attribute` ne sont pas les enfants de leur parent. diff --git a/files/fr/web/xpath/axes/descendant/index.md b/files/fr/web/xpath/axes/descendant/index.md index 3897ddbf8b..51832fa690 100644 --- a/files/fr/web/xpath/axes/descendant/index.md +++ b/files/fr/web/xpath/axes/descendant/index.md @@ -3,6 +3,4 @@ title: descendant slug: Web/XPath/Axes/descendant translation_of: Web/XPath/Axes/descendant --- -

-

l'axe descendant indique tous les nœuds enfants du nœud de contexte, et tous leurs enfants, et ainsi de suite. Les nœuds attribute et namespace ne sont pas compris - le parent d'un nœud attribute est un nœud element, mais les nœuds attribute ne sont pas les enfants de leur parent. -

\ No newline at end of file +l'axe `descendant` indique tous les nœuds enfants du nœud de contexte, et tous leurs enfants, et ainsi de suite. Les nœuds `attribute` et `namespace` ne sont pas compris - le parent d'un nœud `attribute` est un nœud `element`, mais les nœuds `attribute` ne sont pas les enfants de leur parent. diff --git a/files/fr/web/xpath/axes/following-sibling/index.md b/files/fr/web/xpath/axes/following-sibling/index.md index 9ed21b0c4b..7c6c73f29a 100644 --- a/files/fr/web/xpath/axes/following-sibling/index.md +++ b/files/fr/web/xpath/axes/following-sibling/index.md @@ -3,6 +3,4 @@ title: following-sibling slug: Web/XPath/Axes/following-sibling translation_of: Web/XPath/Axes/following-sibling --- -

-

L'axe following-sibling indique tous les nœuds qui ont le même parent que le nœud de contexte mais qui apparaissent après lui dans le document source. -

\ No newline at end of file +L'axe `following-sibling` indique tous les nœuds qui ont le même `parent` que le nœud de contexte mais qui apparaissent après lui dans le document source. diff --git a/files/fr/web/xpath/axes/following/index.md b/files/fr/web/xpath/axes/following/index.md index ccf5191169..ee130b9d46 100644 --- a/files/fr/web/xpath/axes/following/index.md +++ b/files/fr/web/xpath/axes/following/index.md @@ -3,6 +3,4 @@ title: following slug: Web/XPath/Axes/following translation_of: Web/XPath/Axes/following --- -

-

L'axe following indique tous les nœuds situés après le nœud de contexte, excepté les nœuds descendant, attribute et namespace. -

\ No newline at end of file +L'axe `following` indique tous les nœuds situés après le nœud de contexte, excepté les nœuds `descendant`, `attribute` et `namespace`. diff --git a/files/fr/web/xpath/axes/index.md b/files/fr/web/xpath/axes/index.md index ec59c9432b..3ff8be4bd2 100644 --- a/files/fr/web/xpath/axes/index.md +++ b/files/fr/web/xpath/axes/index.md @@ -9,88 +9,74 @@ tags: - XSLT translation_of: Web/XPath/Axes --- -

{{ XsltRef() }}

-

Il existe treize axes différents dans la spécification XPath. Un axe représente une relation au nœud de contexte, et il est utilisé pour situer dans l'arbre les autres nœuds par rapport à celui-ci. La liste suivante présente très brièvement les treize axes disponibles et le niveau de leur support dans Gecko.

-

Pour plus d'informations sur l'utilisation des expressions XPath, veuillez vous reportez à la section Autres ressources à la fin du document Transformations XML avec XSLT.

-

 

-
-
- ancestor
-
- Indique tous les ancêtres du nœud de contexte, depuis le nœud parent jusqu'au nœud racine.
-
-
-
- ancestor-or-self
-
- Indique le nœud de contexte et tous ses ancêtres, y compris le nœud racine.
-
-
-
- attribute
-
- Indique les attributs du nœud de contexte. Seuls les éléments ont des attributs. Cet axe peut être abrégé avec le signe arobase (@).
-
-
-
- child
-
- Indique les enfants du nœud de contexte. Si une expression XPath ne spécifie pas d'axe, c'est l'axe choisi par défaut. Comme seuls le nœud racine et les nœuds element ont des enfants, toute autre utilisation ne sélectionnera rien.
-
-
-
- descendant
-
- Indique tous les nœuds enfants du nœud de contexte, et tous leurs enfants, et ainsi de suite. Les nœuds attribute et namespace ne sont pas compris - le parent d'un nœud attribute est un nœud element, mais les nœuds attribute ne sont pas les enfants de leur parent.
-
-
-
- descendant-or-self
-
- Indique le nœud de contexte et tous ses descendants. Les nœuds attribute et namespace ne sont pas compris - le parent d'un nœud attribute est un nœud element, mais les nœuds attribute ne sont pas les enfants de leur parent.
-
-
-
- following
-
- Indique tous les nœuds situés après le nœud de contexte, exceptés les nœuds descendant, attribute et namespace.
-
-
-
- following-sibling
-
- Indique tous les nœuds qui ont le même parent que le nœud de contexte mais qui apparaissent après lui dans le document source.
-
-
-
- namespace - - (non supporté) -
-
- Indique tous les nœuds qui sont dans le voisinage immédiat du nœud de contexte. Dans ce cas, le nœud de contexte doit être un nœud element.
-
-
-
- parent
-
- Indique le nœud parent du nœud de contexte. Il peut être abrégé par deux points (..).
-
-
-
- preceding
-
- Indique tous les nœuds qui précédent le nœud de contexte dans le document, exceptés les nœuds ancestor, attribute et namespace.
-
-
-
- preceding-sibling
-
- Indique tous les nœuds qui ont le même parent que le nœud de contexte mais qui apparaissent avant lui dans le document source.
-
-
-
- self
-
- Indique le nœud de contexte lui-même. Il peut être abrégé par un point (.).
-
+{{ XsltRef() }} + +Il existe treize axes différents dans la spécification [XPath](XPath). Un axe représente une relation au nœud de contexte, et il est utilisé pour situer dans l'arbre les autres nœuds par rapport à celui-ci. La liste suivante présente très brièvement les treize axes disponibles et le niveau de leur support dans [Gecko](Gecko). + +Pour plus d'informations sur l'utilisation des expressions XPath, veuillez vous reportez à la section [Autres ressources](Transformations_XML_avec_XSLT/Autres_ressources) à la fin du document [Transformations XML avec XSLT](Transformations_XML_avec_XSLT). + + + +- [ancestor](Axes/ancestor) + - : Indique tous les ancêtres du nœud de contexte, depuis le nœud parent jusqu'au nœud racine. + + + +- [ancestor-or-self](Axes/ancestor-or-self) + - : Indique le nœud de contexte et tous ses ancêtres, y compris le nœud racine. + + + +- [attribute](Axes/attribute) + - : Indique les attributs du nœud de contexte. Seuls les éléments ont des attributs. Cet axe peut être abrégé avec le signe arobase (`@`). + + + +- [child](Axes/child) + - : Indique les enfants du nœud de contexte. Si une expression XPath ne spécifie pas d'axe, c'est l'axe choisi par défaut. Comme seuls le nœud racine et les nœuds `element` ont des enfants, toute autre utilisation ne sélectionnera rien. + + + +- [descendant](Axes/descendant) + - : Indique tous les nœuds enfants du nœud de contexte, et tous leurs enfants, et ainsi de suite. Les nœuds `attribute` et `namespace` ne sont **pas** compris - le `parent` d'un nœud `attribute` est un nœud `element`, mais les nœuds `attribute` ne sont pas les enfants de leur parent. + + + +- [descendant-or-self](Axes/descendant-or-self) + - : Indique le nœud de contexte et tous ses descendants. Les nœuds `attribute` et `namespace` ne sont **pas** compris - le `parent` d'un nœud `attribute` est un nœud `element`, mais les nœuds `attribute` ne sont pas les enfants de leur parent. + + + +- [following](Axes/following) + - : Indique tous les nœuds situés après le nœud de contexte, exceptés les nœuds `descendant`, `attribute` et `namespace`. + + + +- [following-sibling](Axes/following-sibling) + - : Indique tous les nœuds qui ont le même `parent` que le nœud de contexte mais qui apparaissent après lui dans le document source. + + + +- [namespace](Axes/namespace) + _(non supporté)_ + - : Indique tous les nœuds qui sont dans le voisinage immédiat du nœud de contexte. Dans ce cas, le nœud de contexte doit être un nœud `element`. + + + +- [parent](Axes/parent) + - : Indique le nœud parent du nœud de contexte. Il peut être abrégé par deux points (`..`). + + + +- [preceding](Axes/preceding) + - : Indique tous les nœuds qui précédent le nœud de contexte dans le document, exceptés les nœuds `ancestor`, `attribute` et `namespace`. + + + +- [preceding-sibling](Axes/preceding-sibling) + - : Indique tous les nœuds qui ont le même `parent` que le nœud de contexte mais qui apparaissent avant lui dans le document source. + + + +- [self](Axes/self) + - : Indique le nœud de contexte lui-même. Il peut être abrégé par un point (`.`). diff --git a/files/fr/web/xpath/axes/namespace/index.md b/files/fr/web/xpath/axes/namespace/index.md index b6db3a451e..a8461f22bf 100644 --- a/files/fr/web/xpath/axes/namespace/index.md +++ b/files/fr/web/xpath/axes/namespace/index.md @@ -3,7 +3,6 @@ title: namespace slug: Web/XPath/Axes/namespace translation_of: Web/XPath/Axes/namespace --- -

-

(non supporté) -

L'axe namespace indique tous les nœuds qui sont dans le voisinage immédiat du nœud de contexte. Dans ce cas, le nœud de contexte doit être un nœud element. -

\ No newline at end of file +_(non supporté)_ + +L'axe `namespace` indique tous les nœuds qui sont dans le voisinage immédiat du nœud de contexte. Dans ce cas, le nœud de contexte doit être un nœud `element`. diff --git a/files/fr/web/xpath/axes/parent/index.md b/files/fr/web/xpath/axes/parent/index.md index a12905e03e..65f61e7c35 100644 --- a/files/fr/web/xpath/axes/parent/index.md +++ b/files/fr/web/xpath/axes/parent/index.md @@ -3,6 +3,4 @@ title: parent slug: Web/XPath/Axes/parent translation_of: Web/XPath/Axes/parent --- -

-

L'axe parent indique le nœud parent du nœud de contexte. Il peut être abrégé par deux points (..). -

\ No newline at end of file +L'axe `parent` indique le nœud parent du nœud de contexte. Il peut être abrégé par deux points (`..`). diff --git a/files/fr/web/xpath/axes/preceding-sibling/index.md b/files/fr/web/xpath/axes/preceding-sibling/index.md index 598739c27a..421e685aa1 100644 --- a/files/fr/web/xpath/axes/preceding-sibling/index.md +++ b/files/fr/web/xpath/axes/preceding-sibling/index.md @@ -3,6 +3,4 @@ title: preceding-sibling slug: Web/XPath/Axes/preceding-sibling translation_of: Web/XPath/Axes/preceding-sibling --- -

-

L'axe preceding-sibling indique tous les nœuds qui ont le même parent que le nœud de contexte mais qui apparaissent avant lui dans le document source. -

\ No newline at end of file +L'axe `preceding-sibling` indique tous les nœuds qui ont le même `parent` que le nœud de contexte mais qui apparaissent avant lui dans le document source. diff --git a/files/fr/web/xpath/axes/preceding/index.md b/files/fr/web/xpath/axes/preceding/index.md index bb6d7c977e..20b7d1936a 100644 --- a/files/fr/web/xpath/axes/preceding/index.md +++ b/files/fr/web/xpath/axes/preceding/index.md @@ -3,6 +3,4 @@ title: preceding slug: Web/XPath/Axes/preceding translation_of: Web/XPath/Axes/preceding --- -

-

L'axe preceding indique tous les nœuds qui précédent le nœud de contexte dans le document, except any ancestor, excepté les nœuds attribute et namespace. -

\ No newline at end of file +L'axe `preceding` indique tous les nœuds qui précédent le nœud de contexte dans le document, except any `ancestor`, excepté les nœuds `attribute` et `namespace`. diff --git a/files/fr/web/xpath/axes/self/index.md b/files/fr/web/xpath/axes/self/index.md index 3e604022ff..054778eeb2 100644 --- a/files/fr/web/xpath/axes/self/index.md +++ b/files/fr/web/xpath/axes/self/index.md @@ -3,6 +3,4 @@ title: self slug: Web/XPath/Axes/self translation_of: Web/XPath/Axes/self --- -

-

L'axe self indique le nœud de contexte lui-même. Il peut être abrégé par un simple point (.). -

\ No newline at end of file +L'axe `self` indique le nœud de contexte lui-même. Il peut être abrégé par un simple point (`.`). diff --git a/files/fr/web/xpath/comparison_with_css_selectors/index.md b/files/fr/web/xpath/comparison_with_css_selectors/index.md index d410038073..6d1ea9e4ac 100644 --- a/files/fr/web/xpath/comparison_with_css_selectors/index.md +++ b/files/fr/web/xpath/comparison_with_css_selectors/index.md @@ -10,41 +10,15 @@ tags: translation_of: Web/XPath/Comparison_with_CSS_selectors original_slug: Web/CSS/Sélecteurs_CSS/Comparison_with_XPath --- -
{{CSSRef("Selectors")}}{{QuickLinksWithSubpages("/fr/docs/Web/XPath")}}{{Draft}}
+{{CSSRef("Selectors")}}{{QuickLinksWithSubpages("/fr/docs/Web/XPath")}}{{Draft}} -

Dans cet article, nous listerons les différences entre les sélecteurs CSS et les fonctionnalités XPath afin que les développeurs web puissent choisir l'outil le plus pertinent.

+Dans cet article, nous listerons les différences entre les sélecteurs CSS et les fonctionnalités XPath afin que les développeurs web puissent choisir l'outil le plus pertinent. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Fonctionnalité XPathÉquivalent CSS
Axe ancestor, parent ou preceding-sibling{{CSSxRef(":has",":has()")}} selector {{experimental_inline}}
Axe attributeSélecteurs d'attribut
Axe childSélecteurs d'enfant
Axe descendantSélecteur de descendant
Axe following-siblingSélecteur de voisin général ou sélecteur de voisin direct
Axe selfSélecteur {{CSSxRef(":scope")}} ou {{CSSxRef(":host")}}
+| [Fonctionnalité XPath](/fr/docs/Web/XPath) | [Équivalent CSS](/fr/docs/Web/CSS/Sélecteurs_CSS) | +| ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Axe [`ancestor`](/fr/docs/XPath/Axes/ancestor), [`parent`](/fr/docs/XPath/Axes/parent) ou [`preceding-sibling`](/fr/docs/XPath/Axes/preceding-sibling) | {{CSSxRef(":has",":has()")}} selector {{experimental_inline}} | +| Axe [`attribute`](/fr/docs/XPath/Axes/attribute) | [Sélecteurs d'attribut](/en-US/docs/Web/CSS/Attribute_selectors) | +| Axe [`child`](/fr/docs/XPath/Axes/child) | [Sélecteurs d'enfant](/fr/docs/Web/CSS/Sélecteurs_enfant) | +| Axe [`descendant`](/fr/docs/XPath/Axes/descendant) | [Sélecteur de descendant](/fr/docs/Web/CSS/Sélecteurs_descendant) | +| Axe [`following-sibling`](/fr/docs/XPath/Axes/following-sibling) | [Sélecteur de voisin général](/fr/docs/Web/CSS/Sélecteurs_de_voisins_généraux) ou [sélecteur de voisin direct](/fr/docs/Web/CSS/Sélecteur_de_voisin_direct) | +| Axe [`self`](/fr/docs/XPath/Axes/self) | Sélecteur {{CSSxRef(":scope")}} ou {{CSSxRef(":host")}} | diff --git a/files/fr/web/xpath/functions/boolean/index.md b/files/fr/web/xpath/functions/boolean/index.md index 92e3b60b73..696c21723d 100644 --- a/files/fr/web/xpath/functions/boolean/index.md +++ b/files/fr/web/xpath/functions/boolean/index.md @@ -6,30 +6,34 @@ tags: translation_of: Web/XPath/Functions/boolean original_slug: Web/XPath/Fonctions/boolean --- -

{{ XsltRef() }} -


-la fonction boolean évalue une expression et retourne true ou false. -

-

Syntaxe

-
boolean( expression )
-
-

Arguments

-
expression -
L'expression à évaluer. L'expression peut faire référence à des nombres, des ensembles de nœuds, comme à des valeurs booléennes. -
-

Retour

-

La valeur booléenne true ou false en fonction de l'évaluation de expression. -

-

Notes

- -

Définition

-

XPath 1.0, section 4.3. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +la fonction `boolean` évalue une expression et retourne `true` ou `false`. + +### Syntaxe + + boolean( expression ) + +### Arguments + +- `expression` + - : L'expression à évaluer. L'expression peut faire référence à des nombres, des ensembles de nœuds, comme à des valeurs booléennes. + +### Retour + +La valeur booléenne `true` ou `false` en fonction de l'évaluation de `expression`. + +### Notes + +- Un nombre est évalué à `false` si c'est un zéro positif ou négatif ou `NaN`. Autrement, il est évalué à `true`. +- Un ensemble de nœuds est évalué à `true` s'il n'est pas vide. +- Une chaîne est évaluée à `false` si elle est vide. Autrement, elle est évaluée à `true`. +- Un objet de type autre que les quatre types de bases, est converti en booléen par une méthode qui dépend de son type. + +### Définition + +[XPath 1.0, section 4.3](http://www.w3.org/TR/xpath#function-boolean). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/ceiling/index.md b/files/fr/web/xpath/functions/ceiling/index.md index d7bf6f388f..5810c1b60d 100644 --- a/files/fr/web/xpath/functions/ceiling/index.md +++ b/files/fr/web/xpath/functions/ceiling/index.md @@ -6,28 +6,33 @@ tags: translation_of: Web/XPath/Functions/ceiling original_slug: Web/XPath/Fonctions/ceiling --- -

{{ XsltRef() }} -


-La fonction ceiling évalue un nombre décimal et retourne le plus petit nombre entier supérieur ou égal au nombre évalué. -

-

Syntaxe

-
ceiling( nombre )
-
-

Arguments

-
nombre -
Le nombre décimal à évaluer. -
-

Retour

-

Le plus petit entier supérieur ou égal à nombre. -

Par exemple : -

-
ceiling (5.2) = 6

-ceiling (-5.2) = -5
-
-

Définition

-

XPath 1.0, section 4.4. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `ceiling` évalue un nombre décimal et retourne le plus petit nombre entier supérieur ou égal au nombre évalué. + +### Syntaxe + + ceiling( nombre ) + +### Arguments + +- `nombre` + - : Le nombre décimal à évaluer. + +### Retour + +Le plus petit entier supérieur ou égal à `nombre`. + +Par exemple : + + ceiling (5.2) = 6 + + ceiling (-5.2) = -5 + +### Définition + +[XPath 1.0, section 4.4](http://www.w3.org/TR/xpath#function-ceiling). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/concat/index.md b/files/fr/web/xpath/functions/concat/index.md index 7ee8eeae00..9ec5e9f246 100644 --- a/files/fr/web/xpath/functions/concat/index.md +++ b/files/fr/web/xpath/functions/concat/index.md @@ -6,24 +6,27 @@ tags: translation_of: Web/XPath/Functions/concat original_slug: Web/XPath/Fonctions/concat --- -

{{ XsltRef() }} -


-La fonction concat concatène deux ou plusieurs chaînes et retourne la chaîne résultante. -

-

Syntaxe

-
concat( chaîne1 , chaîne2 [, chaînen]* )
-
-

Arguments

-
chaînen -
Cette fonction accepte deux arguments ou plus. Chacun est une chaîne. -
-

Retour

-

Une chaîne unique, résultat de la concaténation des chaînes passées en arguments à la fonction. -

-

Définition

-

XPath 1.0, section 4.2. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `concat` concatène deux ou plusieurs chaînes et retourne la chaîne résultante. + +### Syntaxe + + concat( chaîne1 , chaîne2 [, chaînen]* ) + +### Arguments + +- `chaînen` + - : Cette fonction accepte deux arguments ou plus. Chacun est une chaîne. + +### Retour + +Une chaîne unique, résultat de la concaténation des chaînes passées en arguments à la fonction. + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-concat). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/contains/index.md b/files/fr/web/xpath/functions/contains/index.md index 15eb0239d7..130783d43d 100644 --- a/files/fr/web/xpath/functions/contains/index.md +++ b/files/fr/web/xpath/functions/contains/index.md @@ -4,36 +4,32 @@ slug: Web/XPath/Functions/contains translation_of: Web/XPath/Functions/contains original_slug: Web/XPath/Fonctions/contains --- -

{{ XsltRef() }}

+{{ XsltRef() }} -


- La fonction contains détermine si la chaîne passée en premier argument contient la chaîne passée en second argument et retourne le booléen true ou false.

+La fonction `contains` détermine si la chaîne passée en premier argument contient la chaîne passée en second argument et retourne le booléen `true` ou `false`. -

Syntaxe

+### Syntaxe -
contains( meule , aiguille )
-
+ contains( meule , aiguille ) -

Arguments

+### Arguments -
-
meule
-
La chaîne dans laquelle chercher.
-
+- `meule` + - : La chaîne dans laquelle chercher. -
-
aiguille
-
La chaîne à rechercher dans meule
-
+ -

Retour

+- `aiguille` + - : La chaîne à rechercher dans `meule` -

true si meule contient aiguille. Autrement, false.

+### Retour -

Définition

+`true` si `meule` contient `aiguille`. Autrement, `false`. -

XPath 1.0, section 4.2.

+### Définition -

Support Gecko

+[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-contains). -

Supportée.

+### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/count/index.md b/files/fr/web/xpath/functions/count/index.md index 3db718509a..85c635e83c 100644 --- a/files/fr/web/xpath/functions/count/index.md +++ b/files/fr/web/xpath/functions/count/index.md @@ -6,24 +6,27 @@ tags: translation_of: Web/XPath/Functions/count original_slug: Web/XPath/Fonctions/count --- -

{{ XsltRef() }} -


-La fonction count compte le nombre de nœuds dans un ensemble de nœuds et retourne un entier. -

-

Syntaxe

-
count( ensemble-de-nœuds )
-
-

Arguments

-
ensemble-de-nœuds -
L'ensemble de nœuds à compter. -
-

Retour

-

Un entier représentant le nombre de nœuds contenus dans l'ensemble. -

-

Définition

-

1.0, section 4.1. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `count` compte le nombre de nœuds dans un ensemble de nœuds et retourne un entier. + +### Syntaxe + + count( ensemble-de-nœuds ) + +### Arguments + +- `ensemble-de-nœuds` + - : L'ensemble de nœuds à compter. + +### Retour + +Un entier représentant le nombre de nœuds contenus dans l'ensemble. + +### Définition + +[1.0, section 4.1](http://www.w3.org/TR/xpath#function-count). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/current/index.md b/files/fr/web/xpath/functions/current/index.md index 14543f6d1f..c90cae5ffb 100644 --- a/files/fr/web/xpath/functions/current/index.md +++ b/files/fr/web/xpath/functions/current/index.md @@ -6,27 +6,34 @@ tags: translation_of: Web/XPath/Functions/current original_slug: Web/XPath/Fonctions/current --- -

{{ XsltRef() }} -

La fonction current peut être utilisée pour obtenir le nœud courant dans une instruction XSLT. -

-

Syntaxe

-
current()
-
-

Retour

-

Un ensemble de nœuds contenant uniquement le nœud courant. -

-

Notes

-

Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath core. -

Le nœud courant est toujours identique au nœud de contexte. Les deux exemples suivants sont sémantiquement équivalents : -

-
<xsl:value-of select="current()"/>
-
-
<xsl:value-of select="."/>
-
-

Définition

-

XSLT 1.0, section 12.4. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `current` peut être utilisée pour obtenir le nœud courant dans une instruction XSLT. + +### Syntaxe + + current() + +### Retour + +Un ensemble de nœuds contenant uniquement le nœud courant. + +### Notes + +Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath core. + +Le nœud courant est toujours identique au nœud de contexte. Les deux exemples suivants sont sémantiquement équivalents : + + + + + + + +### Définition + +[XSLT 1.0, section 12.4](http://www.w3.org/TR/xslt#function-current). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/document/index.md b/files/fr/web/xpath/functions/document/index.md index 3f1bb98b80..66fd45dc68 100644 --- a/files/fr/web/xpath/functions/document/index.md +++ b/files/fr/web/xpath/functions/document/index.md @@ -6,38 +6,50 @@ tags: translation_of: Web/XPath/Functions/document original_slug: Web/XPath/Fonctions/document --- -

{{ XsltRef() }} -


-La fonction document recherche un ensemble de nœuds dans un ou des documents externes et retourne l'ensemble de nœuds résultant. -

-

Syntaxe

-
document( URI [, ensemble-de-nœuds] )
-
-

Arguments

-
URI -
URI absolue ou relative du document à récupérer. L'URI peut également contenir un identifiant de fragment. -
-
ensemble-de-nœuds (optionnel) -
Une expression pointant vers un ensemble de nœuds du document externe, qui doit être retourné. -
-

Retour

-

Un ensemble de nœuds. -

-

Notes

-
  • Si l'URI contient un identifiant de fragment et que celui-ci peut être repérer dans le document externe, alors ce fragment sera traité comme la racine pour rechercher l'expression de l'argument ensemble-de-nœuds. Si l'argument ensemble-de-nœuds est omis, le fragment entier sera retourné. -
-
  • Si l'argument URI est un ensemble de nœuds et que le second argument est présent, chaque nœud de l'ensemble de nœuds sera évalué comme une URI séparée, et l'ensemble de nœuds retourné sera le même que si la fonction document avait été appelée plusieurs fois, et que les résultats avait été concaténés dans un unique ensemble de nœuds. -
-
  • D'autres situations particulières existent avec des comportements bien définis. Pour plus d'informations, consultez la documentation XSLT 1.0. -
-
  • Puisque l'URI est relative au document XSL, document("") retournera le nœud racine du document courant. -
-

Cette fonction est un ajout à XPath qui est spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions de XPath core. -

-

Définition

-

XSLT 1.0, section 12.1. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `document` recherche un ensemble de nœuds dans un ou des documents externes et retourne l'ensemble de nœuds résultant. + +### Syntaxe + + document( URI [, ensemble-de-nœuds] ) + +### Arguments + +- `URI` + - : URI absolue ou relative du document à récupérer. L'URI peut également contenir un identifiant de fragment. + + + +- `ensemble-de-nœuds` (optionnel) + - : Une expression pointant vers un ensemble de nœuds du document externe, qui doit être retourné. + +### Retour + +Un ensemble de nœuds. + +### Notes + +- Si l'URI contient un identifiant de fragment et que celui-ci peut être repérer dans le document externe, alors ce fragment sera traité comme la racine pour rechercher l'expression de l'argument `ensemble-de-nœuds`. Si l'argument `ensemble-de-nœuds` est omis, le fragment entier sera retourné. + + + +- Si l'argument `URI` est un ensemble de nœuds et que le second argument est présent, chaque nœud de l'ensemble de nœuds sera évalué comme une URI séparée, et l'ensemble de nœuds retourné sera le même que si la fonction `document` avait été appelée plusieurs fois, et que les résultats avait été concaténés dans un unique ensemble de nœuds. + + + +- D'autres situations particulières existent avec des comportements bien définis. Pour plus d'informations, consultez la [documentation XSLT 1.0](http://www.w3.org/TR/xslt). + + + +- Puisque l'URI est relative au document XSL, `document("")` retournera le nœud racine du document courant. + +Cette fonction est un ajout à XPath qui est spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions de XPath core. + +### Définition + +[XSLT 1.0, section 12.1](http://www.w3.org/TR/xslt#function-document). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/element-available/index.md b/files/fr/web/xpath/functions/element-available/index.md index 1ce80f0088..4a2100c494 100644 --- a/files/fr/web/xpath/functions/element-available/index.md +++ b/files/fr/web/xpath/functions/element-available/index.md @@ -6,24 +6,27 @@ tags: translation_of: Web/XPath/Functions/element-available original_slug: Web/XPath/Fonctions/element-available --- -

{{ XsltRef() }} -


-La fonction element-available détermine si un élément est disponible et retourne la valeur booléenne true ou false. -

-

Syntaxe

-
element-available( QName )
-
-

Arguments

-
QName -
Doit s'évaluer en un QName valide. Le QName est développé en nom étendu à l'aide des déclarations d'espaces de nommage s'appliquant à l'expression. Le nom étendu est constitué d'une partie locale, une chaîne, et d'une URI d'espace de nommage. -
-

Retour

-

Retourne true si et seulement si le nom étendu est un nom d'instruction. Si le nom étendu a une URI d'espace de nommage égale à l'URI de l'espace de nommage XSLT, alors il se rapporte à un élément défini par XSLT. Autrement, il se rapporte à un élément d'extension. Si le nom étendu a une URI d'espace de nommage null, la fonction element-available retournera false. -

-

Définition

-

XSLT 1.0, section 15. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `element-available` détermine si un élément est disponible et retourne la valeur booléenne `true` ou `false`. + +### Syntaxe + + element-available( QName ) + +### Arguments + +- `QName` + - : Doit s'évaluer en un QName valide. Le QName est développé en _nom étendu_ à l'aide des déclarations d'espaces de nommage s'appliquant à l'expression. Le nom étendu est constitué d'une partie locale, une chaîne, et d'une URI d'espace de nommage. + +### Retour + +Retourne `true` si et seulement si le nom étendu est un nom d'instruction. Si le nom étendu a une URI d'espace de nommage égale à l'URI de l'espace de nommage XSLT, alors il se rapporte à un élément défini par XSLT. Autrement, il se rapporte à un élément d'extension. Si le nom étendu a une URI d'espace de nommage null, la fonction `element-available` retournera `false`. + +### Définition + +[XSLT 1.0, section 15](http://www.w3.org/TR/xslt#function-element-available). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/false/index.md b/files/fr/web/xpath/functions/false/index.md index 1914710d4a..79e162444f 100644 --- a/files/fr/web/xpath/functions/false/index.md +++ b/files/fr/web/xpath/functions/false/index.md @@ -6,27 +6,30 @@ tags: translation_of: Web/XPath/Functions/false original_slug: Web/XPath/Fonctions/false --- -

{{ XsltRef() }} -


-La fonction false retourne le booléen false. -

-

Syntaxe

-
false()
-
-

Retour

-

Booléen false. -

-

Notes

-

Cette fonction est utile dans les comparaisons : -

-
<xsl:if test="boolean((1 > 2) = false())">
- L'expression évaluée comme fausse
-</xsl:if>
-
-

Définition

-

XPath 1.0, section 4.3. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `false` retourne le booléen `false`. + +### Syntaxe + + false() + +### Retour + +Booléen `false`. + +### Notes + +Cette fonction est utile dans les comparaisons : + + + L'expression évaluée comme fausse + + +### Définition + +[XPath 1.0, section 4.3](http://www.w3.org/TR/xpath#function-false). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/floor/index.md b/files/fr/web/xpath/functions/floor/index.md index 9e986d4ea5..672327f67d 100644 --- a/files/fr/web/xpath/functions/floor/index.md +++ b/files/fr/web/xpath/functions/floor/index.md @@ -10,28 +10,27 @@ tags: translation_of: Web/XPath/Functions/floor original_slug: Web/XPath/Fonctions/floor --- -

{{ XsltRef() }}

-


- La fonction floor évalue un nombre décimal et retourne le plus grand nombre entier inférieur ou égal au nombre évalué.

-

Syntaxe

-
floor(nombre )
-
-

Arguments

-
-
- - - nombre -
-
- Le nombre décimal à évaluer.
-
-

Retour

-

Le plus grand nombre entier inférieur ou égal à - - nombre - .

-

Définition

-

XPath 1.0, section 4.4.

-

Support Gecko

-

Supportée.

+{{ XsltRef() }} + +La fonction `floor` évalue un nombre décimal et retourne le plus grand nombre entier inférieur ou égal au nombre évalué. + +### Syntaxe + + floor(nombre ) + +### Arguments + +- `nombre` + - : Le nombre décimal à évaluer. + +### Retour + +Le plus grand nombre entier inférieur ou égal à `nombre`. + +### Définition + +[XPath 1.0, section 4.4](http://www.w3.org/TR/xpath#function-floor). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/format-number/index.md b/files/fr/web/xpath/functions/format-number/index.md index 3ea1be6d11..d1b8301ab3 100644 --- a/files/fr/web/xpath/functions/format-number/index.md +++ b/files/fr/web/xpath/functions/format-number/index.md @@ -6,33 +6,41 @@ tags: translation_of: Web/XPath/Functions/format-number original_slug: Web/XPath/Fonctions/format-number --- -

{{ XsltRef() }} -


-La fonction format-number évalue un nombre et retourne une chaîne représentant le nombre dans un format donné. -

-

Syntaxe

-
format-number( nombre , motif [, format-décimal] )
-
-

Arguments

-
nombre -
Le nombre à formater. -
-
motif -
Une chaîne au format de la classe Decimal Format (en) du JDK 1.1. La notice du JDK 1.1 n'est plus disponible. Vous trouverez ici la notice pour le JSE 6: Decimal Format (en) -
-
format-décimal (optionnel) -
Le nom d'un élément xsl:decimal-format qui définit le format de nombre à utiliser. Si il est omis, le format décimal par défaut est utilisé. -
-

Retour

-

Une chaîne représentant le nombre dans le nouveau format. -

-

Notes

-

Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath principale. -

-

Définition

-

XSLT 1.0, section 12.3. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `format-number` évalue un nombre et retourne une chaîne représentant le nombre dans un format donné. + +### Syntaxe + + format-number( nombre , motif [, format-décimal] ) + +### Arguments + +- `nombre` + - : Le nombre à formater. + + + +- `motif` + - : Une chaîne au format de la classe [Decimal Format (en)](http://java.sun.com/products/jdk/1.1/docs/api/java.text.DecimalFormat.html) du JDK 1.1. La notice du JDK 1.1 n'est plus disponible. Vous trouverez ici la notice pour le JSE 6: [Decimal Format (en)](http://java.sun.com/javase/6/docs/api/java/text/DecimalFormat.html) + + + +- `format-décimal` (optionnel) + - : Le nom d'un élément [`xsl:decimal-format`](fr/XSLT/decimal-format) qui définit le format de nombre à utiliser. Si il est omis, le format décimal par défaut est utilisé. + +### Retour + +Une chaîne représentant le nombre dans le nouveau format. + +### Notes + +Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath principale. + +### Définition + +[XSLT 1.0, section 12.3](http://www.w3.org/TR/xslt#function-format-number). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/function-available/index.md b/files/fr/web/xpath/functions/function-available/index.md index 1df4e3aa24..a0b0fe9da6 100644 --- a/files/fr/web/xpath/functions/function-available/index.md +++ b/files/fr/web/xpath/functions/function-available/index.md @@ -6,24 +6,27 @@ tags: translation_of: Web/XPath/Functions/function-available original_slug: Web/XPath/Fonctions/function-available --- -

{{ XsltRef() }} -


-La fonction function-available détermine si une fonction donnée est disponible et retourne le booléen true ou false. -

-

Syntaxe

-
function-available( nom )
-
-

Arguments

-
nom -
Le nom de la fonction à tester. -
-

Retour

-

La valeur booléenne true ou false. -

-

Définition

-

XPath 1.0, section 15. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `function-available` détermine si une fonction donnée est disponible et retourne le booléen `true` ou `false`. + +### Syntaxe + + function-available( nom ) + +### Arguments + +- `nom` + - : Le nom de la fonction à tester. + +### Retour + +La valeur booléenne `true` ou `false`. + +### Définition + +[XPath 1.0, section 15](http://www.w3.org/TR/xslt#function-function-available). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/generate-id/index.md b/files/fr/web/xpath/functions/generate-id/index.md index f339308ddc..e57e416554 100644 --- a/files/fr/web/xpath/functions/generate-id/index.md +++ b/files/fr/web/xpath/functions/generate-id/index.md @@ -6,31 +6,37 @@ tags: translation_of: Web/XPath/Functions/generate-id original_slug: Web/XPath/Fonctions/generate-id --- -

{{ XsltRef() }} -


-La fonction generate-id génère un identifiant id unique pour le premier nœud d'un ensemble de nœuds donné et retourne une chaîne contenant cet id. -

-

Syntaxe

-
generate-id( [ensemble-de-nœuds] )
-
-

Arguments

-
ensemble-de-nœuds (optionnel) -
Un id sera généré pour le premier nœud de cet ensemble de nœuds. S'il est omis, le nœud de contexte courant sera utilisé. -
-

Retour

-

Une chaîne contenant l'id généré. -

-

Notes

-
  • Le même id doit être généré à chaque fois pour le même nœud dans le document courant pour la transformation courante. -
-
  • L'id généré peut ne pas être le même pour les transformations subséquentes. -
-

Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath principale. -

-

Définition

-

XSLT 1.0, section 12.4. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `generate-id` génère un identifiant `id` unique pour le premier nœud d'un ensemble de nœuds donné et retourne une chaîne contenant cet `id`. + +### Syntaxe + + generate-id( [ensemble-de-nœuds] ) + +### Arguments + +- `ensemble-de-nœuds` (optionnel) + - : Un `id` sera généré pour le premier nœud de cet ensemble de nœuds. S'il est omis, le nœud de contexte courant sera utilisé. + +### Retour + +Une chaîne contenant l'`id` généré. + +### Notes + +- Le même `id` doit être généré à chaque fois pour le même nœud dans le document courant pour la transformation courante. + + + +- L'`id` généré peut ne pas être le même pour les transformations subséquentes. + +Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath principale. + +### Définition + +[XSLT 1.0, section 12.4](http://www.w3.org/TR/xslt#function-generate-id). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/id/index.md b/files/fr/web/xpath/functions/id/index.md index d8a9ef2e72..0aca569fff 100644 --- a/files/fr/web/xpath/functions/id/index.md +++ b/files/fr/web/xpath/functions/id/index.md @@ -6,30 +6,31 @@ tags: translation_of: Web/XPath/Functions/id original_slug: Web/XPath/Fonctions/id --- -

{{ XsltRef() }} -


-La fonction id recherche les nœuds correspondant aux identifiants id donnés et retourne un ensemble de nœuds contenant les nœuds identifiés. -

-

Syntaxe

-
id( expression )
-
-

Arguments

- -
-
expression
-
Si expression est un ensemble de nœuds, alors la valeur de la chaîne de chacun des nœuds de l'ensemble est traitée individuellement. Les nœuds retournés sont ceux corespondant à ces identifiants id. Si expression est une chaîne, ou n'importe quoi d'autre qu'un ensemble de nœuds, alors expression est traitée comme une liste d'identifiants id séparés par des espaces L'ensemble de nœuds retourné comprend les nœuds corespondant à ces identifiants id.
-
- -

Retour

-

Un ensemble de nœuds contenant les nœuds identifiés par les id donnés. -

-

Notes

- -

Définition

-

XPath 1.0, section 4.1. -

-

Support Gecko

-

Partiellement supportée. -

\ No newline at end of file + +La fonction `id` recherche les nœuds correspondant aux identifiants `id` donnés et retourne un ensemble de nœuds contenant les nœuds identifiés. + +### Syntaxe + + id( expression ) + +### Arguments + +- `expression` + - : Si `expression` est un ensemble de nœuds, alors la valeur de la chaîne de chacun des nœuds de l'ensemble est traitée individuellement. Les nœuds retournés sont ceux corespondant à ces identifiants `id`. Si `expression` est une chaîne, ou n'importe quoi d'autre qu'un ensemble de nœuds, alors `expression` est traitée comme une liste d'identifiants `id` séparés par des espaces L'ensemble de nœuds retourné comprend les nœuds corespondant à ces identifiants `id`. + +### Retour + +Un ensemble de nœuds contenant les nœuds identifiés par les `id` donnés. + +### Notes + +- La DTD du document XML détermine quel attribut est un `id`. Voir [XPath 1.0, section 5.2.1](http://www.w3.org/TR/xpath#unique-id). + +### Définition + +[XPath 1.0, section 4.1](http://www.w3.org/TR/xpath#function-id). + +### Support Gecko + +Partiellement supportée. diff --git a/files/fr/web/xpath/functions/index.md b/files/fr/web/xpath/functions/index.md index e4afddab49..f985a5bb4f 100644 --- a/files/fr/web/xpath/functions/index.md +++ b/files/fr/web/xpath/functions/index.md @@ -8,43 +8,41 @@ tags: translation_of: Web/XPath/Functions original_slug: Web/XPath/Fonctions --- -

 

-

{{ XsltRef() }} La liste ci-dessous regroupe les principales fonctions de XPath et les ajouts à XPath qui sont spécifiques à XSLT. Chaque lien fournit pour la fonction correspondante description, syntaxe, liste d'arguments, types de résultats, description originelle dans les recommandations du W3C, et niveau de support actuel dans Gecko. Pour plus d'informations sur l'utilisation des fonctions XPath/XSLT, reportez-vous à la page Autres ressources.

- \ No newline at end of file +{{ XsltRef() }} La liste ci-dessous regroupe les principales fonctions de [XPath](XPath) et les ajouts à XPath qui sont spécifiques à [XSLT](/XSLT). Chaque lien fournit pour la fonction correspondante description, syntaxe, liste d'arguments, types de résultats, description originelle dans les recommandations du W3C, et niveau de support actuel dans [Gecko](/Gecko). Pour plus d'informations sur l'utilisation des fonctions XPath/XSLT, reportez-vous à la page [Autres ressources](/Transformations_XML_avec_XSLT/Autres_ressources). + +- [boolean()](Fonctions/boolean) +- [ceiling()](Fonctions/ceiling) +- [concat()](Fonctions/concat) +- [contains()](Fonctions/contains) +- [count()](Fonctions/count) +- [current()](Fonctions/current) _Spécifique à XSLT_ +- [document()](Fonctions/document) _Spécifique à XSLT_ +- [element-available()](Fonctions/element-available) +- [false()](Fonctions/false) +- [floor()](Fonctions/floor) +- [format-number()](Fonctions/format-number) _Spécifique à XSLT_ +- [function-available()](Fonctions/function-available) +- [generate-id()](Fonctions/generate-id) _Spécifique à XSLT_ +- [id()](Fonctions/id) _(partiellement supporté)_ +- [key()](Fonctions/key) _Spécifique à XSLT_ +- [lang()](Fonctions/lang) +- [last()](Fonctions/last) +- [local-name()](Fonctions/local-name) +- [name()](Fonctions/name) +- [namespace-uri()](Fonctions/namespace-uri) +- [normalize-space()](Fonctions/normalize-space) +- [not()](Fonctions/not) +- [number()](Fonctions/number) +- [position()](Fonctions/position) +- [round()](Fonctions/round) +- [starts-with()](Fonctions/starts-with) +- [string()](Fonctions/string) +- [string-length()](Fonctions/string-length) +- [substring()](Fonctions/substring) +- [substring-after()](Fonctions/substring-after) +- [substring-before()](Fonctions/substring-before) +- [sum()](Fonctions/sum) +- [system-property()](Fonctions/system-property) _Spécifique à XSLT_ +- [translate()](Fonctions/translate) +- [true()](Fonctions/true) +- [unparsed-entity-url()](Fonctions/unparsed-entity-url) _Spécifique à XSLT_ _(non supporté)_ diff --git a/files/fr/web/xpath/functions/key/index.md b/files/fr/web/xpath/functions/key/index.md index 3804327e12..d68fb9a0ad 100644 --- a/files/fr/web/xpath/functions/key/index.md +++ b/files/fr/web/xpath/functions/key/index.md @@ -6,32 +6,38 @@ tags: translation_of: Web/XPath/Functions/key original_slug: Web/XPath/Fonctions/key --- -

{{ XsltRef() }} -


-La fonction key retourne un ensemble de nœuds ayant la valeur donnée pour la clef donnée. -

-

Syntaxe

-
key( nom-de-clef , valeur )
-
-

Arguments

-
nom-de-clef -
Une chaîne contenant le nom de l'élément xsl:key à utiliser. -
-
valeur -
L'ensemble de nœuds retourné contiendra chaque nœud qui possède cette valeur pour la clef donnée. -
-

Retour

-

Un ensemble de nœuds. -

-

Notes

-
  • L'élément xsl:key définit quel attribut de quels éléments donnés sera utilisé pour la comparaison. -
-

Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath principale. -

-

Définition

-

XSLT 1.0, section 12.2. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `key` retourne un ensemble de nœuds ayant la valeur donnée pour la clef donnée. + +### Syntaxe + + key( nom-de-clef , valeur ) + +### Arguments + +- `nom-de-clef` + - : Une chaîne contenant le nom de l'élément [`xsl:key`](fr/XSLT/key) à utiliser. + + + +- `valeur` + - : L'ensemble de nœuds retourné contiendra chaque nœud qui possède cette valeur pour la clef donnée. + +### Retour + +Un ensemble de nœuds. + +### Notes + +- L'élément [`xsl:key`](fr/XSLT/key) définit quel attribut de quels éléments donnés sera utilisé pour la comparaison. + +Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath principale. + +### Définition + +[XSLT 1.0, section 12.2](http://www.w3.org/TR/xslt#function-key). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/lang/index.md b/files/fr/web/xpath/functions/lang/index.md index 56b56c7fb9..30ac163d87 100644 --- a/files/fr/web/xpath/functions/lang/index.md +++ b/files/fr/web/xpath/functions/lang/index.md @@ -6,48 +6,55 @@ tags: translation_of: Web/XPath/Functions/lang original_slug: Web/XPath/Fonctions/lang --- -

{{ XsltRef() }} -


-La fonction lang détermine si le nœud de contexte correspond à la langue indiquée et retourne le booléen true ou false. -

-

Syntaxe

-
lang( chaîne )
-
-

Arguments

-
chaîne -
Le code de langue ou de localisation (langue et pays) à vérifier. -
-

Retour

-

true si le noeud de contexte est dans la langue donnée, false autrement. -

-

Notes

-
  • La langue d'un nœud est déterminée par son attribut xml:lang. Si le nœud courant ne possède pas cet attribut, alors la valeur de l'attribut xml:lang du plus proche ancêtre le possédant déterminera la langue du nœud courant. Si la langue ne peut être déterminée (aucun ancêtre avec un attribut xml:lang), cette fonction retourne le booléen false. -
-
  • Si la chaîne donnée ne spécifie pas de code de pays, cette fonction sélectionnera les nœuds dans la langue spécifiée, suivie éventuellement de n'importe quel code de pays. La réciproque n'est pas vraie. -
-

Regardons le code XML suivant : -

-
<p xml:lang="en">I went up a floor.</p>
-<p xml:lang="en-GB">I took the lift.</p>
-<p xsl:lang="en-US">I rode the elevator.</p>
-

et ce modèle XSL : -

-
<xsl:value-of select="count(//p[lang('en')])" />
-<xsl:value-of select="count(//p[lang('en-GB')])" />
-<xsl:value-of select="count(//p[lang('en-US')])" />
-<xsl:value-of select="count(//p[lang('de')])" />
-
-

La sortie sera : -

-
3
-1
-1
-0
-
-

Définition

-

XPath 1.0, section 4.3. -

-

Support Gecko

-

Supporté. -

\ No newline at end of file + +La fonction `lang` détermine si le nœud de contexte correspond à la langue indiquée et retourne le booléen `true` ou `false`. + +### Syntaxe + + lang( chaîne ) + +### Arguments + +- `chaîne` + - : Le code de langue ou de localisation (langue et pays) à vérifier. + +### Retour + +`true` si le noeud de contexte est dans la langue donnée, `false` autrement. + +### Notes + +- La langue d'un nœud est déterminée par son attribut `xml:lang`. Si le nœud courant ne possède pas cet attribut, alors la valeur de l'attribut `xml:lang` du plus proche ancêtre le possédant déterminera la langue du nœud courant. Si la langue ne peut être déterminée (aucun ancêtre avec un attribut `xml:lang`), cette fonction retourne le booléen `false`. + + + +- Si la `chaîne` donnée ne spécifie pas de code de pays, cette fonction sélectionnera les nœuds dans la langue spécifiée, suivie éventuellement de n'importe quel code de pays. La réciproque n'est pas vraie. + +Regardons le code XML suivant : + +

I went up a floor.

+

I took the lift.

+

I rode the elevator.

+ +et ce modèle XSL : + + + + + + +La sortie sera : + + 3 + 1 + 1 + 0 + +### Définition + +[XPath 1.0, section 4.3](http://www.w3.org/TR/xpath#function-lang). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xpath/functions/last/index.md b/files/fr/web/xpath/functions/last/index.md index f7a3251081..fc282aa526 100644 --- a/files/fr/web/xpath/functions/last/index.md +++ b/files/fr/web/xpath/functions/last/index.md @@ -6,23 +6,26 @@ tags: translation_of: Web/XPath/Functions/last original_slug: Web/XPath/Fonctions/last --- -

{{ XsltRef() }} -


-La fonction last retourne un nombre égal à la taille du contexte dans le contexte d'évaluation d'expression. -

-

Syntaxe

-
last()
-
-

Retour

-

Un entier égal à la taille du contexte dans le contexte d'évaluation d'expression. -

-

Notes

-
  • Cette fonction est souvent utilisée avec la fonction position() pour déterminer si un nœud particulier est le dernier d'un ensemble de nœud. -
-

Définition

-

XPath 1.0, section 4.1. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `last` retourne un nombre égal à la taille du contexte dans le contexte d'évaluation d'expression. + +### Syntaxe + + last() + +### Retour + +Un entier égal à la taille du contexte dans le contexte d'évaluation d'expression. + +### Notes + +- Cette fonction est souvent utilisée avec la fonction [position()](fr/XPath/Fonctions/position) pour déterminer si un nœud particulier est le dernier d'un ensemble de nœud. + +### Définition + +[XPath 1.0, section 4.1](http://www.w3.org/TR/xpath#function-last). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/local-name/index.md b/files/fr/web/xpath/functions/local-name/index.md index 2d6092e1ca..41dccc07d7 100644 --- a/files/fr/web/xpath/functions/local-name/index.md +++ b/files/fr/web/xpath/functions/local-name/index.md @@ -6,27 +6,31 @@ tags: translation_of: Web/XPath/Functions/local-name original_slug: Web/XPath/Fonctions/local-name --- -

{{ XsltRef() }} -


-La fonction local-name retourne une chaîne représentant le nom local du premier nœud d'un ensemble de nœuds donné. -

-

Syntaxe

-
local-name( [ensemble-de-nœuds] )
-
-

Arguments

-
ensemble-de-nœuds (optionnel) -
Le nom local du premier nœud de cet ensemble de nœuds sera retourné. Si cet argument est omis, le nœud de contexte courant sera utilisé. -
-

Retour

-

Une chaîne. -

-

Notes

- -

Définition

-

XPath 1.0, section 4.1. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `local-name` retourne une chaîne représentant le nom local du premier nœud d'un ensemble de nœuds donné. + +### Syntaxe + + local-name( [ensemble-de-nœuds] ) + +### Arguments + +- `ensemble-de-nœuds` (optionnel) + - : Le nom local du premier nœud de cet ensemble de nœuds sera retourné. Si cet argument est omis, le nœud de contexte courant sera utilisé. + +### Retour + +Une chaîne. + +### Notes + +- Le nom local est la partie locale d'un [nom étendu](http://www.w3.org/TR/xpath#dt-expanded-name). + +### Définition + +[XPath 1.0, section 4.1](http://www.w3.org/TR/xpath#function-local-name). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/name/index.md b/files/fr/web/xpath/functions/name/index.md index 13a6961723..e6e5b05e3b 100644 --- a/files/fr/web/xpath/functions/name/index.md +++ b/files/fr/web/xpath/functions/name/index.md @@ -6,27 +6,31 @@ tags: translation_of: Web/XPath/Functions/name original_slug: Web/XPath/Fonctions/name --- -

{{ XsltRef() }} -


-La fonction name retourne une chaîne représentant le QName du premier nœud d'un ensemble de nœuds donné. -

-

Syntaxe

-
name( [ensemble-de-nœuds] )
-
-

Arguments

-
ensemble-de-nœuds (optionnel) -
Le QName du premier nœud de cet ensemble de nœuds sera retourné. Si cet argument est omis, le nœud de contexte courant sera utilisé. -
-

Retour

-

Une chaîne représentant le QName d'un nœud. -

-

Notes

-
  • Le QName est le nom qualifié du nœud, incluant le préfixe de son espace de nommage et son nom local. -
-

Définition

-

XPath 1.0, section 4.1. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `name` retourne une chaîne représentant le QName du premier nœud d'un ensemble de nœuds donné. + +### Syntaxe + + name( [ensemble-de-nœuds] ) + +### Arguments + +- `ensemble-de-nœuds` (optionnel) + - : Le QName du premier nœud de cet ensemble de nœuds sera retourné. Si cet argument est omis, le nœud de contexte courant sera utilisé. + +### Retour + +Une chaîne représentant le QName d'un nœud. + +### Notes + +- Le [QName](http://www.w3.org/TR/REC-xml-names/#NT-QName) est le _nom qualifié_ du nœud, incluant le préfixe de son espace de nommage et son nom local. + +### Définition + +[XPath 1.0, section 4.1](http://www.w3.org/TR/xpath#function-local-name). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/namespace-uri/index.md b/files/fr/web/xpath/functions/namespace-uri/index.md index 2506904f39..fc7e203e24 100644 --- a/files/fr/web/xpath/functions/namespace-uri/index.md +++ b/files/fr/web/xpath/functions/namespace-uri/index.md @@ -6,29 +6,35 @@ tags: translation_of: Web/XPath/Functions/namespace-uri original_slug: Web/XPath/Fonctions/namespace-uri --- -

{{ XsltRef() }} -


-La fonction namespace-uri retourne une chaîne représentant l'URI de l'espace de nommage du premier nœud d'un ensemble de nœuds donné. -

-

Syntaxe

-
namespace-uri( [ensemble-de-nœuds] )
-
-

Arguments

-
ensemble-de-nœuds (optionnel) -
L'URI de l'espace de nommage du premier nœud de cet ensemble de nœuds sera retournée. Si cet argument est omis, le nœud de contexte courant sera utilisé. -
-

Retour

-

Une chaîne représentant l'URI de l'espace de nommage dans lequel se trouve le nœud donné. -

-

Notes

-
  • S'il n'y a pas d'espace de nommage spécifié pour le noeud donné, la chaîne retournée sera une chaîne vide. -
-
  • Pour les nœuds autres que les nœuds element et attribute, la chaîne retournée sera toujours une chaîne vide. -
-

Définition

-

XPath 1.0, section 4.1. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `namespace-uri` retourne une chaîne représentant l'URI de l'espace de nommage du premier nœud d'un ensemble de nœuds donné. + +### Syntaxe + + namespace-uri( [ensemble-de-nœuds] ) + +### Arguments + +- `ensemble-de-nœuds` (optionnel) + - : L'URI de l'espace de nommage du premier nœud de cet ensemble de nœuds sera retournée. Si cet argument est omis, le nœud de contexte courant sera utilisé. + +### Retour + +Une chaîne représentant l'URI de l'espace de nommage dans lequel se trouve le nœud donné. + +### Notes + +- S'il n'y a pas d'espace de nommage spécifié pour le noeud donné, la chaîne retournée sera une chaîne vide. + + + +- Pour les nœuds autres que les nœuds `element` et `attribute`, la chaîne retournée sera toujours une chaîne vide. + +### Définition + +[XPath 1.0, section 4.1](http://www.w3.org/TR/xpath#function-local-name). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/normalize-space/index.md b/files/fr/web/xpath/functions/normalize-space/index.md index 36023b5a12..90ce9154c5 100644 --- a/files/fr/web/xpath/functions/normalize-space/index.md +++ b/files/fr/web/xpath/functions/normalize-space/index.md @@ -6,31 +6,27 @@ tags: translation_of: Web/XPath/Functions/normalize-space original_slug: Web/XPath/Fonctions/normalize-space --- -

{{ XsltRef() }}

+{{ XsltRef() }} -


- La fonction normalize-space supprime les espaces de début et de fin d'une chaîne et remplace les successions d’espaces par une seule puis retourne la chaîne résultante.

+La fonction `normalize-space` supprime les espaces de début et de fin d'une chaîne et remplace les successions d’espaces par une seule puis retourne la chaîne résultante. -

Syntaxe

+### Syntaxe -
normalize-space(chaîne )
-
+ normalize-space(chaîne ) -

Arguments

+### Arguments -
-
chaîne
-
La chaîne à normaliser.
-
+- `chaîne` + - : La chaîne à normaliser. -

Retour

+### Retour -

La chaîne nomalisée.

+La chaîne nomalisée. -

Définition

+### Définition -

XPath 1.0, section 4.2.

+[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-normalize-space). -

Support Gecko

+### Support Gecko -

Supportée.

+Supportée. diff --git a/files/fr/web/xpath/functions/not/index.md b/files/fr/web/xpath/functions/not/index.md index 142a814159..9caf626f21 100644 --- a/files/fr/web/xpath/functions/not/index.md +++ b/files/fr/web/xpath/functions/not/index.md @@ -6,27 +6,31 @@ tags: translation_of: Web/XPath/Functions/not original_slug: Web/XPath/Fonctions/not --- -

{{ XsltRef() }} -


-La fonction not évalue une expression booléenne et retourne la valeur opposée. -

-

Syntaxe

-
not( expression )
-
-

Arguments

-
expression (optionnel) -
L'expression est évaluée exactement comme si elle était passée en tant qu'argument à la fonction boolean(). -
-

Retour

-

True pour une expression évaluée à false ; false pour une expression évaluée à true. -

-

Notes

-
  • Cette fonction devrait se comporter de façon identique à la fonction boolean(), excepté qu'elle retourne la valeur opposée. -
-

Définition

-

XPath 1.0, section 4.3. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `not` évalue une expression booléenne et retourne la valeur opposée. + +### Syntaxe + + not( expression ) + +### Arguments + +- `expression` (optionnel) + - : L'expression est évaluée exactement comme si elle était passée en tant qu'argument à la fonction [boolean()](fr/XPath/Fonctions/boolean). + +### Retour + +`True` pour une expression évaluée à `false` ; `false` pour une expression évaluée à `true`. + +### Notes + +- Cette fonction devrait se comporter de façon identique à la fonction [boolean()](fr/XPath/Fonctions/boolean), excepté qu'elle retourne la valeur opposée. + +### Définition + +[XPath 1.0, section 4.3](http://www.w3.org/TR/xpath#function-not). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/number/index.md b/files/fr/web/xpath/functions/number/index.md index 99a1511cb8..bef612a5cc 100644 --- a/files/fr/web/xpath/functions/number/index.md +++ b/files/fr/web/xpath/functions/number/index.md @@ -6,27 +6,34 @@ tags: translation_of: Web/XPath/Functions/number original_slug: Web/XPath/Fonctions/number --- -

{{ XsltRef() }} -


-La fonction number convertit un objet en un nombre et retourne ce nombre. -

-

Syntaxe

-
number( [objet] )
-
-

Arguments

-
objet (optionnel) -
L'objet à convertir en nombre. -
-

Retour

-

Le nombre résultant après conversion de l'objet. -

-

Notes

-
  • Les chaînes sont converties en nombre en enlevant les espaces précédant le nombre dans la chaîne et en ignorant tout ce qui suit le nombre. Si la chaîne ne correspond pas à ce motif, alors elle est convertie en NaN
  • Le booléen true est converti en 1. False est converti en 0.
  • Un ensemble de nœuds est d'abord converti en chaîne comme lors d'un appel à la fonction string() puis il est traité de la même façon qu'une chaîne. -
  • Un objet qui n'est pas d'un des quatre types de base est converti en nombre avec une méthode qui dépend de son type.
-

Définition

-

XPath 1.0, section 4.4. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `number` convertit un objet en un nombre et retourne ce nombre. + +### Syntaxe + + number( [objet] ) + +### Arguments + +- _`objet`_ (optionnel) + - : L'objet à convertir en nombre. + +### Retour + +Le nombre résultant après conversion de l'objet. + +### Notes + +- Les chaînes sont converties en nombre en enlevant les espaces précédant le nombre dans la chaîne et en ignorant tout ce qui suit le nombre. Si la chaîne ne correspond pas à ce motif, alors elle est convertie en `NaN` +- Le booléen `true` est converti en 1. `False` est converti en 0. +- Un ensemble de nœuds est d'abord converti en chaîne comme lors d'un appel à la fonction [string()](fr/XPath/Fonctions/string) puis il est traité de la même façon qu'une chaîne. +- Un objet qui n'est pas d'un des quatre types de base est converti en nombre avec une méthode qui dépend de son type. + +### Définition + +[XPath 1.0, section 4.4](http://www.w3.org/TR/xpath#function-number). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/position/index.md b/files/fr/web/xpath/functions/position/index.md index 2a51e4a9f5..6576ca4ae8 100644 --- a/files/fr/web/xpath/functions/position/index.md +++ b/files/fr/web/xpath/functions/position/index.md @@ -6,47 +6,45 @@ tags: translation_of: Web/XPath/Functions/position original_slug: Web/XPath/Fonctions/position --- -

{{ XsltRef() }}

+{{ XsltRef() }} -


- La fonction position retourne un nombre égal à la position du contexte dans le contexte d'évaluation d'expression.

+La fonction `position` retourne un nombre égal à la position du contexte dans le contexte d'évaluation d'expression. -

Syntaxe

+### Syntaxe -
position()
-
+ position() -

Retour

+### Retour -

Un nombre entier égal à la position du contenu dans le contexte d'évaluation d'expression.

+Un nombre entier égal à la position du contenu dans le contexte d'évaluation d'expression. -

Notes

+### Notes -
    -
  • Notez que la numérotation de la position d'un n&oelig:ud dans un contexte commence à 1. Le premier nœud a donc la position 1.
    • -
+- Notez que la numérotation de la position d'un n\&oelig:ud dans un contexte commence à 1. Le premier nœud a donc la position 1. -
    -
  • Le contexte est déterminé par le reste du chemin :
    • -
+ -
<xsl:template match="//a[position() = 5]">
- <!-- cet exemple 'attrape' le cinquième élément "a"
-         n'importe où dans le document. -->
-</xsl:template>
-
+- Le contexte est déterminé par le reste du chemin : -
<xsl:template match="//div[@class='foo']/bar[position() = 1]">
- <!-- cet exemple 'attrape' le premier
-         élément "bar" enfant d'un élément "div"
-         avec un attribut "class" valant "foo" -->
-</xsl:template>
-
+ -

Définition

+ + + -

XPath 1.0, section 4.1.

+ -

Support Gecko

+ + + -

Supportée.

\ No newline at end of file +### Définition + +[XPath 1.0, section 4.1](http://www.w3.org/TR/xpath#function-position). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/round/index.md b/files/fr/web/xpath/functions/round/index.md index bca80c65dd..d711589de7 100644 --- a/files/fr/web/xpath/functions/round/index.md +++ b/files/fr/web/xpath/functions/round/index.md @@ -6,27 +6,31 @@ tags: translation_of: Web/XPath/Functions/round original_slug: Web/XPath/Fonctions/round --- -

{{ XsltRef() }} -


-La fonction round retourne le nombre entier le plus proche d'un nombre donné. -

-

Syntaxe

-
round( décimal )
-
-

Arguments

-
décimal -
Le nombre décimal à arrondir. -
-

Retour

-

Le plus proche nombre entier, qu'il soit plus grand, plus petit ou égal à decimal. -

-

Notes

-
  • -0.5 est arrondi à zéro négatif. 0.4 est arrondi à zéro positif. -
-

Définition

-

XPath 1.0, section 4.4. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `round` retourne le nombre entier le plus proche d'un nombre donné. + +### Syntaxe + + round( décimal ) + +### Arguments + +- `décimal` + - : Le nombre décimal à arrondir. + +### Retour + +Le plus proche nombre entier, qu'il soit plus grand, plus petit ou égal à `decimal`. + +### Notes + +- \-0.5 est arrondi à zéro négatif. 0.4 est arrondi à zéro positif. + +### Définition + +[XPath 1.0, section 4.4](http://www.w3.org/TR/xpath#function-round). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/starts-with/index.md b/files/fr/web/xpath/functions/starts-with/index.md index 56b6336b04..ecd2e42fa5 100644 --- a/files/fr/web/xpath/functions/starts-with/index.md +++ b/files/fr/web/xpath/functions/starts-with/index.md @@ -6,17 +6,32 @@ tags: translation_of: Web/XPath/Functions/starts-with original_slug: Web/XPath/Fonctions/starts-with --- -

{{ XsltRef() }}

-


-La fonction starts-with vérifie si la première chaîne débute par la seconde, et retourne true ou false.

-

Syntaxe

-
starts-with( meule , aiguille)
-
-

Arguments

-
meule
La chaîne dans laquelle chercher.
aiguille
La chaîne à rechercher.
-

Retour

-

true si meule débute par aiguille. Autrement, false.

-

Définition

-

XPath 1.0, section 4.2.

-

Support Gecko

-

Supportée.

\ No newline at end of file +{{ XsltRef() }} + +La fonction `starts-with` vérifie si la première chaîne débute par la seconde, et retourne `true` ou `false`. + +### Syntaxe + + starts-with( meule , aiguille) + +### Arguments + +- `meule` + - : La chaîne dans laquelle chercher. + + + +- `aiguille` + - : La chaîne à rechercher. + +### Retour + +`true` si meule débute par `aiguille`. Autrement, `false`. + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-starts-with). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/string-length/index.md b/files/fr/web/xpath/functions/string-length/index.md index e09490e74d..52ca3d65b1 100644 --- a/files/fr/web/xpath/functions/string-length/index.md +++ b/files/fr/web/xpath/functions/string-length/index.md @@ -6,24 +6,27 @@ tags: translation_of: Web/XPath/Functions/string-length original_slug: Web/XPath/Fonctions/string-length --- -

{{ XsltRef() }} -


-La fonction string-length retourne le nombre de caractères dans une chaîne donnée. -

-

Syntaxe

-
string-length( [chaîne] )
-
-

Arguments

-
chaîne (optionnel) -
La chaîne à évaluer. S'il est omis, la chaîne utilisée sera le noeud de contexte converti en chaîne. -
-

Retour

-

Un entier égal au nombre de caractères dans la chaîne. -

-

Définition

-

XPath 1.0, section 4.2. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `string-length` retourne le nombre de caractères dans une chaîne donnée. + +### Syntaxe + + string-length( [chaîne] ) + +### Arguments + +- `chaîne` (optionnel) + - : La chaîne à évaluer. S'il est omis, la chaîne utilisée sera le noeud de contexte converti en chaîne. + +### Retour + +Un entier égal au nombre de caractères dans la chaîne. + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-string-length). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/string/index.md b/files/fr/web/xpath/functions/string/index.md index 1345b8ba5f..bf566b4a3c 100644 --- a/files/fr/web/xpath/functions/string/index.md +++ b/files/fr/web/xpath/functions/string/index.md @@ -6,35 +6,39 @@ tags: translation_of: Web/XPath/Functions/string original_slug: Web/XPath/Fonctions/string --- -

{{ XsltRef() }} -


-La fonction string convertit l'argument passé en une chaîne. -

-

Syntaxe

-
string( [objet] )
-
-

Arguments

-
objet (optionnel) -
L'objet à convertir en une chaîne. Si il est omis, le nœud du contexte est utilisé. -
-

Retour

-

Une chaîne. -

-

Notes

-
  • Si l'objet est un ensemble de nœuds, la valeur de la chaîne du premier nœud de l'ensemble est retournée. -
  • Un nombre est converti comme suit : -
    • NaN est converti en la chaîne NaN. -
    • Zéro positif est converti en 0. -
    • Zéro négatif est converti en 0. -
    • Infini positif est converti en la chaîne Infinity. -
    • Infini négatif est converti en la chaîne -Infinity. -
    • Les nombres décimaux entre -1 et 1 sont convertis en chaîne comportant un unique 0 avant le séparateur décimale. -
    -
-

Définition

-

XPath 1.0, section 4.2. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `string` convertit l'argument passé en une chaîne. + +### Syntaxe + + string( [objet] ) + +### Arguments + +- `objet` (optionnel) + - : L'objet à convertir en une chaîne. Si il est omis, le nœud du contexte est utilisé. + +### Retour + +Une chaîne. + +### Notes + +- Si l'objet est un ensemble de nœuds, la valeur de la chaîne du premier nœud de l'ensemble est retournée. +- Un nombre est converti comme suit : + + - NaN est converti en la chaîne `NaN`. + - Zéro positif est converti en `0`. + - Zéro négatif est converti en `0`. + - Infini positif est converti en la chaîne `Infinity`. + - Infini négatif est converti en la chaîne `-Infinity`. + - Les nombres décimaux entre -1 et 1 sont convertis en chaîne comportant un unique 0 avant le séparateur décimale. + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-string). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/substring-after/index.md b/files/fr/web/xpath/functions/substring-after/index.md index 8aa294389a..856eafbf5a 100644 --- a/files/fr/web/xpath/functions/substring-after/index.md +++ b/files/fr/web/xpath/functions/substring-after/index.md @@ -6,30 +6,42 @@ tags: translation_of: Web/XPath/Functions/substring-after original_slug: Web/XPath/Fonctions/substring-after --- -

{{ XsltRef() }} -


-La fonction substring-after() retourne la partie d'une chaîne donnée suivant une sous-chaîne donnée. -

-

Syntaxe

-
substring-after( bottedefoin , aiguille )
-
-

Arguments

-
bottedefoin -
La chaîne à évaluer. Un extrait de cette chaîne sera retourné. -
-
aiguille -
La sous-chaîne à rechercher. Tout le contenu se trouvant après la première occurrence de aiguille dans la chaîne bottedefoin sera retourné. -
-

Retour

-

Une chaîne. -

-

Exemples

- -
Exemple XPath Sortie
<xsl:value-of select="substring-after('1999/04/01','/')" /> 04/01
substring-after('aa-bb','-') bb
substring-after('aa-bb','a') a-bb
substring-after('aa-bb','b') b
substring-after('aa-bb','q') (empty string)
-

Définition

-

XPath 1.0, section 4.2. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `substring-after()` retourne la partie d'une chaîne donnée suivant une sous-chaîne donnée. + +### Syntaxe + + substring-after( bottedefoin , aiguille ) + +### Arguments + +- `bottedefoin` + - : La chaîne à évaluer. Un extrait de cette chaîne sera retourné. + + + +- `aiguille` + - : La sous-chaîne à rechercher. Tout le contenu se trouvant après la première occurrence de `aiguille` dans la chaîne `bottedefoin` sera retourné. + +### Retour + +Une chaîne. + +### Exemples + +| Exemple XPath | Sortie | +| ------------------------------------------------------------- | -------------- | +| `` | `04/01` | +| `substring-after('aa-bb','-')` | `bb` | +| `substring-after('aa-bb','a')` | `a-bb` | +| `substring-after('aa-bb','b')` | `b` | +| `substring-after('aa-bb','q')` | (empty string) | + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-substring-after). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/substring-before/index.md b/files/fr/web/xpath/functions/substring-before/index.md index f9ab5dcf01..0630ae0553 100644 --- a/files/fr/web/xpath/functions/substring-before/index.md +++ b/files/fr/web/xpath/functions/substring-before/index.md @@ -6,30 +6,42 @@ tags: translation_of: Web/XPath/Functions/substring-before original_slug: Web/XPath/Fonctions/substring-before --- -

{{ XsltRef() }} -


-La fonction substring-before() retourne retourne la partie d'une chaîne donnée précédant une sous-chaîne donnée. -

-

Syntaxe

-
substring-before( bottedefoin , aiguille )
-
-

Arguments

-
bottedefoin -
La chaîne à évaluer. Un extrait de cette chaîne sera retourné. -
-
aiguille -
La sous-chaîne à rechercher. Tout le contenu se trouvant avant la première occurrence de aiguille dans la chaîne bottedefoin sera retourné. -
-

Retour

-

Une chaîne. -

-

Exemples

- -
XPath Example Output
<xsl:value-of select="substring-before('1999/04/01','/')" /> 1999
substring-before('aa-bb','-') aa
substring-before('aa-bb','a') (empty string)
substring-before('aa-bb','b') aa-
substring-before('aa-bb','q') (empty string)
-

Définition

-

XPath 1.0, section 4.2. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `substring-before()` retourne retourne la partie d'une chaîne donnée précédant une sous-chaîne donnée. + +### Syntaxe + + substring-before( bottedefoin , aiguille ) + +### Arguments + +- `bottedefoin` + - : La chaîne à évaluer. Un extrait de cette chaîne sera retourné. + + + +- `aiguille` + - : La sous-chaîne à rechercher. Tout le contenu se trouvant avant la première occurrence de `aiguille` dans la chaîne `bottedefoin` sera retourné. + +### Retour + +Une chaîne. + +### Exemples + +| XPath Example | Output | +| -------------------------------------------------------------- | ---------------- | +| `` | `1999` | +| `substring-before('aa-bb','-')` | `aa` | +| `substring-before('aa-bb','a')` | `(empty string)` | +| `substring-before('aa-bb','b')` | `aa-` | +| `substring-before('aa-bb','q')` | (empty string) | + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-substring-before). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/substring/index.md b/files/fr/web/xpath/functions/substring/index.md index 29cb112c4e..c6b6a7929b 100644 --- a/files/fr/web/xpath/functions/substring/index.md +++ b/files/fr/web/xpath/functions/substring/index.md @@ -6,32 +6,41 @@ tags: translation_of: Web/XPath/Functions/substring original_slug: Web/XPath/Fonctions/substring --- -

{{ XsltRef() }} -


-La fonction substring retourne une partie d'une chaîne donnée. -

-

Syntaxe

-
substring( chaîne , début [, longueur] )
-
-

Arguments

-
chaîne
La chaîne à évaluer. -
-
début -
La position dans la chaîne où commence la sous-chaîne. -
-
longueur (optionnel) -
La longueur de la sous-chaîne à extraire. S'il est omis, la chaîne retournée contiendra tous les caractères depuis la position début jusqu'à la fin de la chaîne. -
-

Retour

-

Une chaîne. -

-

Notes

-

Comme pour les autres fonctions XPath, les positions ne sont pas comptées à partir de zéro. Le premier caractère de la chaîne est à la position 1. -

-

Définition

-

XPath 1.0, section 4.2. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `substring` retourne une partie d'une chaîne donnée. + +### Syntaxe + + substring( chaîne , début [, longueur] ) + +### Arguments + +- `chaîne` + - : La chaîne à évaluer. + + + +- `début` + - : La position dans la `chaîne` où commence la sous-chaîne. + + + +- `longueur` (optionnel) + - : La longueur de la sous-chaîne à extraire. S'il est omis, la chaîne retournée contiendra tous les caractères depuis la position `début` jusqu'à la fin de la `chaîne`. + +### Retour + +Une chaîne. + +### Notes + +Comme pour les autres fonctions XPath, les positions ne sont pas comptées à partir de zéro. Le premier caractère de la chaîne est à la position 1. + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-substring). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/sum/index.md b/files/fr/web/xpath/functions/sum/index.md index b5aa70ad1c..fee8e72724 100644 --- a/files/fr/web/xpath/functions/sum/index.md +++ b/files/fr/web/xpath/functions/sum/index.md @@ -6,27 +6,31 @@ tags: translation_of: Web/XPath/Functions/sum original_slug: Web/XPath/Fonctions/sum --- -

{{ XsltRef() }} -


-La fonction sum retourne un nombre qui est la somme des valeurs numériques de chaque nœud d'un ensemble de nœuds donné. -

-

Syntaxe

-
sum( ensemble-de-nœuds )
-
-

Arguments

-
ensemble-de-nœuds -
L'ensemble de nœuds à évaluer. Chaque nœud de l'ensemble est évalué comme s'il était passé à la fonction number(), et la somme des nombres résultants est retournée. -
-

Retour

-

Un nombre. -

-

Notes

-

(Aucune) -

-

Définition

-

XPath 1.0, section 4.3. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `sum` retourne un nombre qui est la somme des valeurs numériques de chaque nœud d'un ensemble de nœuds donné. + +### Syntaxe + + sum( ensemble-de-nœuds ) + +### Arguments + +- `ensemble-de-nœuds` + - : L'ensemble de nœuds à évaluer. Chaque nœud de l'ensemble est évalué comme s'il était passé à la fonction [`number()`](fr/XPath/Fonctions/number), et la somme des nombres résultants est retournée. + +### Retour + +Un nombre. + +### Notes + +_(Aucune)_ + +### Définition + +[XPath 1.0, section 4.3](http://www.w3.org/TR/xpath#function-sum). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/system-property/index.md b/files/fr/web/xpath/functions/system-property/index.md index 60c0333072..e36f17ddb8 100644 --- a/files/fr/web/xpath/functions/system-property/index.md +++ b/files/fr/web/xpath/functions/system-property/index.md @@ -6,29 +6,33 @@ tags: translation_of: Web/XPath/Functions/system-property original_slug: Web/XPath/Fonctions/system-property --- -

{{ XsltRef() }} -


-La fonction system-property() retourne un objet représentant la propriété système donnée. -

-

Syntaxe

-
system-property( nom )
-
-

Arguments

-
nom (optionnel) -
Le nom de la propriété système. L'argument s'évaluer en une chaîne qui est un QName. Le QName est développé en un nom à l'aide des déclarations d'espaces de nommage s'appliquant à l'expression. La fonction system-property() retourne un objet représentant la valeur de la propriété système identifiée par le nom. Si cette propriété système n'existe pas, une chaîne vide est retournée. -
-

Retour

-

Un objet représentant le propriété système donnée. -

-

Notes

-
  • xsl:version, un nombre correspondant à la version de XSLT implémentée par le processeur ; pour les processeurs XSLT implémentant la version de XSLT définit dans ce document, ce nombre est 1.0. -
  • xsl:vendor, une chaîne identifiant le vendeur du processeur XSLT. -
  • xsl:vendor-url, une chaîne contenant une URL qui identifie le vendeur du processeur XSLT ; généralement, il s'agit de l'adresse de la page Web du vendeur. -
-

Définition

-

XSLT 1.0, section 12.4. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `system-property()` retourne un objet représentant la propriété système donnée. + +### Syntaxe + + system-property( nom ) + +### Arguments + +- _`nom`_ (optionnel) + - : Le nom de la propriété système. L'argument s'évaluer en une chaîne qui est un QName. Le QName est développé en un nom à l'aide des déclarations d'espaces de nommage s'appliquant à l'expression. La fonction `system-property()` retourne un objet représentant la valeur de la propriété système identifiée par le nom. Si cette propriété système n'existe pas, une chaîne vide est retournée. + +### Retour + +Un objet représentant le propriété système donnée. + +### Notes + +- xsl:version, un nombre correspondant à la version de XSLT implémentée par le processeur ; pour les processeurs XSLT implémentant la version de XSLT définit dans ce document, ce nombre est 1.0. +- xsl:vendor, une chaîne identifiant le vendeur du processeur XSLT. +- xsl:vendor-url, une chaîne contenant une URL qui identifie le vendeur du processeur XSLT ; généralement, il s'agit de l'adresse de la page Web du vendeur. + +### Définition + +[XSLT 1.0, section 12.4](http://www.w3.org/TR/xslt#function-system-property). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/translate/index.md b/files/fr/web/xpath/functions/translate/index.md index 97c03d561f..bb3b23d739 100644 --- a/files/fr/web/xpath/functions/translate/index.md +++ b/files/fr/web/xpath/functions/translate/index.md @@ -6,50 +6,63 @@ tags: translation_of: Web/XPath/Functions/translate original_slug: Web/XPath/Fonctions/translate --- -

{{ XsltRef() }} -


-La fonction translate évalue une chaîne et un ensemble de caractères à traduire, et retourne la chaîne traduite. -

-

Syntaxe

-
translate( chaîne , abc , XYZ )
-
-

Arguments

-
chaîne -
La chaîne à évaluer. -
-
abc -
La chaîne de caractères à remplacer. -
-
XYZ
La chaîne de caractères utilisée pour le remplacement. Le premier caractère de XYZ remplacera chaque occurrence du premier caractère de abc qui apparaît dans chaîne. -
-

Retour

-

La chaîne traduite. -

-

Notes

-

XPath note que la fonction translate n'est pas une solution suffisante pour la conversion majuscule/minuscule dans tous les langages. Une future version de XPath pourrait fournir des fonctions supplémentaires pour la conversion.

Cependant, translate est à l'heure actuelle la fonction la plus proche d'une fonction pouvant convertir une chaîne en bas de casse ou haut de casse. -

-

Exemple

-
<xsl:value-of select="translate('Le rapide renard.', 'abcdefghijklmnopqrstuvwxyz', 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'") />
-
-

Sortie

-
LE RAPIDE RENARD.
-
-


-

-
  • Si abc est plus long que XYZ, alors chaque occurrence d'un caractère de abc qui n'a pas de correspondance dans XYZ sera supprimée. -
-

Exemple

-
<xsl:value-of select="translate('Le renard rapide.', 'renard', 'panda')" />
-
-

Sortie

-
La pandp pdpia.
-
-
  • Si XYZ contient plus de caractères que abc, les caractères supplémentaires sont ignorés. -
-

Définition

-

XPath 1.0, section 4.2. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `translate` évalue une chaîne et un ensemble de caractères à traduire, et retourne la chaîne traduite. + +### Syntaxe + + translate( chaîne , abc , XYZ ) + +### Arguments + +- `chaîne` + - : La chaîne à évaluer. + + + +- `abc` + - : La chaîne de caractères à remplacer. + + + +- `XYZ` + - : La chaîne de caractères utilisée pour le remplacement. Le premier caractère de `XYZ` remplacera chaque occurrence du premier caractère de `abc` qui apparaît dans `chaîne`. + +### Retour + +La chaîne traduite. + +### Notes + +XPath note que la fonction `translate` n'est pas une solution suffisante pour la conversion majuscule/minuscule dans tous les langages. Une future version de XPath pourrait fournir des fonctions supplémentaires pour la conversion. + +Cependant, `translate` est à l'heure actuelle la fonction la plus proche d'une fonction pouvant convertir une chaîne en bas de casse ou haut de casse. + +#### Exemple + + + +#### Sortie + + LE RAPIDE RENARD. + +- Si `abc` est plus long que `XYZ`, alors chaque occurrence d'un caractère de `abc` qui n'a pas de correspondance dans `XYZ` sera supprimée. + +#### Exemple + + + +#### Sortie + + La pandp pdpia. + +- Si `XYZ` contient plus de caractères que `abc`, les caractères supplémentaires sont ignorés. + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-translate). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/true/index.md b/files/fr/web/xpath/functions/true/index.md index 87e34d51c7..b6051e9ca5 100644 --- a/files/fr/web/xpath/functions/true/index.md +++ b/files/fr/web/xpath/functions/true/index.md @@ -6,20 +6,22 @@ tags: translation_of: Web/XPath/Functions/true original_slug: Web/XPath/Fonctions/true --- -

{{ XsltRef() }} -


-La fonction true retourne la valeur booléenne true. -

-

Syntaxe

-
true()
-
-

Retour

-

Le booléen true. -

-

Définition

-

XPath 1.0, section 4.3. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file + +La fonction `true` retourne la valeur booléenne `true`. + +### Syntaxe + + true() + +### Retour + +Le booléen `true`. + +### Définition + +[XPath 1.0, section 4.3](http://www.w3.org/TR/xpath#function-true). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/unparsed-entity-url/index.md b/files/fr/web/xpath/functions/unparsed-entity-url/index.md index a8669bd1d8..c98f6ced41 100644 --- a/files/fr/web/xpath/functions/unparsed-entity-url/index.md +++ b/files/fr/web/xpath/functions/unparsed-entity-url/index.md @@ -6,24 +6,27 @@ tags: translation_of: Web/XPath/Functions/unparsed-entity-url original_slug: Web/XPath/Fonctions/unparsed-entity-url --- -

{{ XsltRef() }} -


-La fonction unparsed-entity-url() retourne l'URI d'une entité non analysée avec le nom donné. C'est une donnée non-XML référencée dans le DTD du document source. -

-

Syntaxe

-
string unparsed-entity-url(chaîne)
-
-

Arguments

-
chaîne -
Le nom de l'entité non analysée. Si l'argument n'est pas une chaîne, il est converti suivant les règles de la fonction string(). Le nom doit être un nom XML. -
-

Retour

-

L'URI de l'entité non analysée récupérée dans la DTD, si elle existe. Autrement, une chaîne vide. -

-

Définition

-

XSLT 1.0, section 12.4.0 -

-

Support Gecko

-

Non supportée. -

\ No newline at end of file + +La fonction `unparsed-entity-url()` retourne l'URI d'une entité non analysée avec le nom donné. C'est une donnée non-XML référencée dans le DTD du document source. + +### Syntaxe + + string unparsed-entity-url(chaîne) + +### Arguments + +- `chaîne` + - : Le nom de l'entité non analysée. Si l'argument n'est pas une chaîne, il est converti suivant les règles de la fonction [`string()`](fr/XPath/Fonctions/string). Le nom doit être un nom XML. + +### Retour + +L'URI de l'entité non analysée récupérée dans la DTD, si elle existe. Autrement, une chaîne vide. + +### Définition + +[XSLT 1.0, section 12.4](http://www.w3.org/TR/xslt#function-unparsed-entity-uri).0 + +### Support Gecko + +Non supportée. diff --git a/files/fr/web/xpath/index.md b/files/fr/web/xpath/index.md index 903d5d3772..948a0993e5 100644 --- a/files/fr/web/xpath/index.md +++ b/files/fr/web/xpath/index.md @@ -12,64 +12,50 @@ tags: - XSLT translation_of: Web/XPath --- -
{{XSLTRef}}
+{{XSLTRef}} -

XPath est une abréviation pour XML Path Language (qu'on pourrait traduire en français par « langage de chemin XML »). Ce langage utilise une syntaxe non-XML pour cibler différentes parties d'un document XML. Il peut aussi être utilisé pour tester certains nœuds d'un document afin de déterminer s'ils suivent un motif particulier.

+XPath est une abréviation pour _XML Path Language_ (qu'on pourrait traduire en français par « langage de chemin XML »). Ce langage utilise une syntaxe non-XML pour cibler différentes parties d'un document [XML](/fr/docs/Web/XML/XML_introduction). Il peut aussi être utilisé pour tester certains nœuds d'un document afin de déterminer s'ils suivent un motif particulier. -

XPath est principalement utilisé avec XSLT, mais on peut tout aussi bien l'utiliser afin de naviguer dans le DOM de tout document structuré avec un langage semblable à XML (HTML ou SVG par exemple) grâce à l'interface XPathExpression. Cela permet d'éviter les méthodes Document.getElementById() ou ParentNode.querySelectorAll() ou encore les propriétés Node.childNodes.

+XPath est principalement utilisé avec [XSLT](/fr/docs/Web/XSLT), mais on peut tout aussi bien l'utiliser afin de naviguer dans le [DOM](/fr/docs/Web/API/Document_Object_Model) de tout document structuré avec un langage semblable à XML ([HTML](/fr/docs/Web/HTML) ou [SVG](/fr/docs/Web/SVG) par exemple) grâce à l'interface [`XPathExpression`](/fr/docs/Web/API/XPathExpression). Cela permet d'éviter les méthodes [`Document.getElementById()`](/fr/docs/Web/API/Document/getElementById) ou [`ParentNode.querySelectorAll()`](/fr/docs/Web/API/ParentNode/querySelectorAll) ou encore les propriétés [`Node.childNodes`](/fr/docs/Web/API/Node/childNodes). -

XPath utilise une notation en chemin (à l'instar des URL) pour naviguer dans la structure hiérarchique d'un document XML. Sa syntaxe est qualifiée de « non-XML » car un chemin XPath peut être utilisé au sein d'URI ou de valeurs d'attribut XML.

+XPath utilise une notation en chemin (à l'instar des URL) pour naviguer dans la structure hiérarchique d'un document XML. Sa syntaxe est qualifiée de « non-XML » car un chemin XPath peut être utilisé au sein d'URI ou de valeurs d'attribut XML. -
-

Note : La prise en charge de XPath est hétérogène. Si l'implémentation de Firefox est relativement correcte (malgré l'absence de volonté de l'améliorer encore), d'autres navigateurs implémentent une surface moindre de ces fonctionnalités (voire aucune). Si vous avez besoin d'une prothèse (polyfill), vous pouvez vous tourner vers js-xpath ou wicked-good-xpath.

-
+> **Note :** La prise en charge de XPath est hétérogène. Si l'implémentation de Firefox est relativement correcte (malgré l'absence de volonté de l'améliorer encore), d'autres navigateurs implémentent une surface moindre de ces fonctionnalités (voire aucune). Si vous avez besoin d'une prothèse (_polyfill_), vous pouvez vous tourner vers [js-xpath](http://nchc.dl.sourceforge.net/project/js-xpath/js-xpath/1.0.0/xpath.js) ou [wicked-good-xpath](https://github.com/google/wicked-good-xpath). -

Documentation

+## Documentation -
-
Introduction à l'utilisation de XPath avec JavaScript
-
Une utilisation de XPath qui n'est pas basée sur XSLT.
-
Axes XPath
-
La liste et la définition des axes sont définies dans la spécification XPath. Les axes sont utilisés afin de décrire les relations entre les nœuds.
-
Functions XPath
-
La liste et la description des fonctions principales de XPath et des additions propres à XSLT.
-
Transformer du XML avec XSLT
-
XSLT utilise XPath afin de cibler les segments d'un document XML pour ensuite les transformer.
-
Fragments de code XPath
-
Un ensemble d'exemples de code réutilisables en JavaScript qui utilisent les API DOM Level 3 XPath .
-
Qu'est-ce que XSLT ? (en anglais)
-
Une introduction à XSLT et XPath sans besoin de connaissances préalables. Le contexte, la structure, les concepts ainsi qu'une terminologie introductive sont fournis au lecteur.
-
+- [Introduction à l'utilisation de XPath avec JavaScript](/fr/docs/Web/XPath/Introduction_to_using_XPath_in_JavaScript) + - : Une utilisation de XPath qui n'est pas basée sur XSLT. +- [Axes XPath](/fr/docs/Web/XPath/Axes) + - : La liste et la définition des axes sont définies dans la spécification XPath. Les axes sont utilisés afin de décrire les relations entre les nœuds. +- [Functions XPath](/fr/docs/Web/XPath/Functions) + - : La liste et la description des fonctions principales de XPath et des additions propres à XSLT. +- [Transformer du XML avec XSLT](/fr/docs/Web/XSLT/Transforming_XML_with_XSLT) + - : XSLT utilise XPath afin de cibler les segments d'un document XML pour ensuite les transformer. +- [Fragments de code XPath](/fr/docs/Web/XPath/Snippets) + - : Un ensemble d'exemples de code réutilisables en JavaScript qui utilisent les API [DOM Level 3 XPath ](https://www.w3.org/TR/DOM-Level-3-XPath/). +- [Qu'est-ce que XSLT ? (en anglais)](https://www.xml.com/pub/a/2000/08/holman/) + - : Une introduction à XSLT et XPath sans besoin de connaissances préalables. Le contexte, la structure, les concepts ainsi qu'une terminologie introductive sont fournis au lecteur. -

Outils

+## Outils -
-
ChroPath
-
Un module complémentaire de Firefox qui ajoute un panneau dédié à XPath au sein des outils de développement.
-
XPath tester
-
Un outil en ligne pour tester des expressions XPath.
-
+- [ChroPath](https://addons.mozilla.org/fr/firefox/addon/chropath-for-firefox/) + - : Un module complémentaire de Firefox qui ajoute un panneau dédié à XPath au sein des outils de développement. +- [XPath tester](https://extendsclass.com/xpath-tester.html) + - : Un outil en ligne pour tester des expressions XPath. - +## Voir aussi -
    -
  • XSLT, XML, DOM
    • -
  • Comparaison entre XPath et les sélecteurs CSS
    • -
  • XSLT
    • -
  • EXSLT
    • -
  • XPath
    • -
  • - Guides -
      -
    1. Comparaison entre XPath et les sélecteurs CSS
      2. -
    2. Exemples de fragments XPath
      3. -
    -
    • -
  • - Axes XPath +- [XSLT](/fr/docs/Web/XSLT), [XML](/fr/docs/Web/XML), [DOM](/fr/docs/Web/API/Document_Object_Model) +- [Comparaison entre XPath et les sélecteurs CSS](/fr/docs/Web/XPath/Comparison_with_CSS_selectors) +- **[XSLT](/fr/docs/Web/XSLT)** +- **[EXSLT](/fr/docs/Web/EXSLT)** +- **[XPath](/fr/docs/Web/XPath)** +- Guides + + 1. [Comparaison entre XPath et les sélecteurs CSS](/fr/docs/Web/XPath/Comparison_with_CSS_selectors) + 2. [Exemples de fragments XPath](/fr/docs/Web/XPath/Snippets) + +- [Axes XPath](/fr/docs/Web/XPath/Axes) {{ListSubpagesForSidebar("/fr/docs/Web/XPath/Axes")}} -
    • -
  • - Fonctions XPath{{ListSubpagesForSidebar("/fr/docs/Web/XPath/Functions")}} -
    • -
+- [Fonctions XPath](/fr/docs/Web/XPath/Functions){{ListSubpagesForSidebar("/fr/docs/Web/XPath/Functions")}} diff --git a/files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.md b/files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.md index 571f41688c..c243759726 100644 --- a/files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.md +++ b/files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.md @@ -11,401 +11,407 @@ tags: translation_of: Web/XPath/Introduction_to_using_XPath_in_JavaScript original_slug: Web/JavaScript/Introduction_à_l_utilisation_de_XPath_avec_JavaScript --- -

Ce document décrit l'interface pour utiliser XPath dans JavaScript, que ce soit en interne, dans les extensions et depuis les sites Web. Mozilla implémente une partie importante de DOM 3 XPath (en). Cela signifie que les expressions XPath peuvent être utilisées sur des documents HTML et XML.

+Ce document décrit l'interface pour utiliser [XPath](/fr/docs/Web/XPath) dans JavaScript, que ce soit en interne, dans les extensions et depuis les sites Web. Mozilla implémente une partie importante de [DOM 3 XPath (en)](https://www.w3.org/TR/2004/NOTE-DOM-Level-3-XPath-20040226/). Cela signifie que les expressions XPath peuvent être utilisées sur des documents HTML et XML. -

La principale interface pour l'utilisation de XPath est la fonction evaluate() de l'objet document.

+La principale interface pour l'utilisation de XPath est la fonction [`evaluate()`](/fr/docs/Web/API/Document/evaluate) de l'objet [`document`](/fr/docs/Web/API/Document). -

document.evaluate()

+## document.evaluate() -

Cette méthode évalue les expressions XPath dans un document XML (y compris les documents HTML), et retourne un objet XPathResult, qui peut être un nœud unique ou un ensemble de nœuds. La documentation existante sur cette méthode se trouve à la page document.evaluate mais elle est plutôt succincte comparée à nos besoins actuels. Nous l'examinerons de façon plus complète dans la suite de ce document.

+Cette méthode évalue les expressions [XPath](/fr/docs/Web/XPath) dans un document [XML](/fr/docs/Web/XML) (y compris les documents HTML), et retourne un objet [`XPathResult`](/fr/docs/Web/XPath/XPathResult), qui peut être un nœud unique ou un ensemble de nœuds. La documentation existante sur cette méthode se trouve à la page [`document.evaluate`](/fr/docs/Web/API/Document/evaluate) mais elle est plutôt succincte comparée à nos besoins actuels. Nous l'examinerons de façon plus complète dans la suite de ce document. -
var xpathResult = document.evaluate( xpathExpression, contextNode, namespaceResolver, resultType, result );
-
+ var xpathResult = document.evaluate( xpathExpression, contextNode, namespaceResolver, resultType, result ); -

Paramètres

+### Paramètres -

La fonction evaluate prend cinq arguments au total :

+La fonction [evaluate](/fr/docs/Web/API/Document/evaluate) prend cinq arguments au total : -
-
xpathExpression
-
Une chaîne contenant l'expression XPath à évaluer.
-
contextNode
-
Un nœud du document pour lequel l'expression xpathExpression doit être évaluée, ainsi que l'ensemble de ses descendants. Le nœud document est le plus couramment utilisé.
-
namespaceResolver
-
Une fonction à laquelle sera passé tout préfixe d'espace de nommage contenu dans l'expression xpathExpression et qui renvoie une chaîne représentant l'URI de l'espace de nommage associé à ce préfixe. Cela permet la conversion entre le préfixe utilisé dans les expressions XPath et les différents préfixes éventuellement utilisés dans le document. Cette fonction peut être :
-
+- `xpathExpression` + - : Une chaîne contenant l'expression XPath à évaluer. +- `contextNode` + - : Un nœud du document pour lequel l'expression `xpathExpression` doit être évaluée, ainsi que l'ensemble de ses descendants. Le nœud [document](/fr/docs/Web/API/Document/) est le plus couramment utilisé. +- `namespaceResolver` + - : Une fonction à laquelle sera passé tout préfixe d'espace de nommage contenu dans l'expression `xpathExpression` et qui renvoie une chaîne représentant l'URI de l'espace de nommage associé à ce préfixe. Cela permet la conversion entre le préfixe utilisé dans les expressions XPath et les différents préfixes éventuellement utilisés dans le document. Cette fonction peut être : -
    -
  • Créée à l'aide de la méthode createNSResolver d'un objet XPathEvaluator. C'est la solution à utiliser à peu près tout le temps.
    • -
  • Une valeur null, qui peut être utilisé pour les documents HTML ou lorsqu'aucun préfixe n'est utilisé. Remarquez que si l'expression xpathExpression contient un préfixe d'espace de nommage cela déclenchera une exception DOMException portant le code NAMESPACE_ERR.
    • -
  • Une fonction personnalisée définie par l'utilisateur. Voir la section Implémentation d'un résolveur d'espace de nommage personnalisé dans l'annexe pour plus de détails.
    • -
+ -
-
resultType
-
Une constante qui définit le type de résultat à renvoyer comme résultat de l'évaluation. La constante la plus courante est XPathResult.ANY_TYPE qui renverra un résultat du type le plus naturel par rapport à l'expression XPath. Une section de l'annexe contient une liste complète des constantes disponibles. Elles sont expliquées dans la section #Définition du type de retour ci-dessous.
-
result
-
Soit un objet XPathResult existant qui sera réutilisé pour contenir les résultats, soit la valeur null qui peut être utilisée pour créer un nouvel objet XPathResult.
-
+- [Créée](#Impl.C3.A9mentation_d.27un_r.C3.A9solveur_d.27espaces_de_nommage_par_d.C3.A9faut) à l'aide de la méthode [`createNSResolver`](/fr/docs/Web/API/Document/createNSResolver) d'un objet [`XPathEvaluator`](http://www.xulplanet.com/references/objref/XPathEvaluator.html). C'est la solution à utiliser à peu près tout le temps. +- Une valeur `null`, qui peut être utilisé pour les documents HTML ou lorsqu'aucun préfixe n'est utilisé. Remarquez que si l'expression `xpathExpression` contient un préfixe d'espace de nommage cela déclenchera une exception `DOMException` portant le code `NAMESPACE_ERR`. +- Une fonction personnalisée définie par l'utilisateur. Voir la section [Implémentation d'un résolveur d'espace de nommage personnalisé](#Impl.C3.A9mentation_d.27un_r.C3.A9solveur_d.27espace_de_nommage_personnalis.C3.A9) dans l'annexe pour plus de détails. -

Valeur de retour

+ -

Renvoie xpathResult, qui est un objet XPathResult du type défini dans le paramètre resultType. L'interface XPathResult est définie dans ce document.

+- `resultType` + - : Une [constante](#Constantes_d.C3.A9finies_de_XPathResult) qui définit le type de résultat à renvoyer comme résultat de l'évaluation. La constante la plus courante est `XPathResult.ANY_TYPE` qui renverra un résultat du type le plus naturel par rapport à l'expression XPath. Une section de l'annexe contient une liste complète des [constantes disponibles](#Constantes_d.C3.A9finies_de_XPathResult). Elles sont expliquées dans la section [#Définition du type de retour](#D.C3.A9finition_du_type_de_retour) ci-dessous. +- `result` + - : Soit un objet `XPathResult` existant qui sera réutilisé pour contenir les résultats, soit la valeur `null` qui peut être utilisée pour créer un nouvel objet `XPathResult`. -

Implémentation d'un résolveur d'espaces de nommage par défaut

+### Valeur de retour -

On crée un résolveur d'espace de nommage à l'aide de la méthode createNSResolver de l'objet document.

+Renvoie `xpathResult`, qui est un objet `XPathResult` du type [défini](#D.C3.A9finition_du_type_de_retour) dans le paramètre `resultType`. L'interface `XPathResult` est définie dans ce [document](/fr/docs/Web/API/XPathResult). -
var nsResolver = document.createNSResolver( contextNode.ownerDocument == null ? contextNode.documentElement : contextNode.ownerDocument.documentElement );
-
+### Implémentation d'un résolveur d'espaces de nommage par défaut -

Ou alternativement en utilisant la méthode <code>createNSResolver</code> d'un objet <code>XPathEvaluator</code>. <pre> var xpEvaluator = new XPathEvaluator(); var nsResolver = xpEvaluator.createNSResolver( contextNode.ownerDocument == null ? contextNode.documentElement : contextNode.ownerDocument.documentElement ); </pre> On lui passe ensuite document.evaluate, la variable nsResolver comme paramètre namespaceResolver.

+On crée un résolveur d'espace de nommage à l'aide de la méthode `createNSResolver` de l'objet [document](/fr/docs/Web/API/Document/). -

véracité du paragraphe suivant à vérifier avec la doc du w3c Notez que XPath définit que les QNames sans préfixe correspondent uniquement aux éléments de l'espace de nommage null. Il n'existe aucun moyen dans XPath pour récupérer l'espace de nommage par défaut. Pour coupler des éléments ou des attributs dans un espace de nommage non nul, vous devrez détecter les noms préfixés, et créer un résolveur d'espace de nommage qui fera correspondre le préfixe avec l'espace de nommage. Vous en saurez plus sur la façon de créer un résolveur d'espace de nommage personnalisé ci-dessous.

+ var nsResolver = document.createNSResolver( contextNode.ownerDocument == null ? contextNode.documentElement : contextNode.ownerDocument.documentElement ); -

Définition du type de retour

+Ou alternativement en utilisant la méthode \createNSResolver\ d'un objet \XPathEvaluator\. \
 var xpEvaluator = new XPathEvaluator(); var nsResolver = xpEvaluator.createNSResolver( contextNode.ownerDocument == null ? contextNode.documentElement : contextNode.ownerDocument.documentElement ); \
On lui passe ensuite `document.evaluate`, la variable `nsResolver` comme paramètre `namespaceResolver`. -

La variable xpathResult renvoyée par document.evaluate peut être composée de nœuds individuels (types simples), ou un groupe de nœuds (types d'ensembles de nœuds).

+véracité du paragraphe suivant à vérifier avec la doc du w3c Notez que XPath définit que les `QNames` sans préfixe correspondent uniquement aux éléments de l'espace de nommage `null`. Il n'existe aucun moyen dans XPath pour récupérer l'espace de nommage par défaut. Pour coupler des éléments ou des attributs dans un espace de nommage non nul, vous devrez détecter les noms préfixés, et créer un résolveur d'espace de nommage qui fera correspondre le préfixe avec l'espace de nommage. Vous en saurez plus sur la façon de [créer un résolveur d'espace de nommage personnalisé](#Impl.C3.A9mentation_d.27un_r.C3.A9solveur_d.27espace_de_nommage_personnalis.C3.A9) ci-dessous. -

Types simples

+### Définition du type de retour -

Lorsque le type de résultat spécifié dans resultType est soit :

+La variable `xpathResult` renvoyée par `document.evaluate` peut être composée de nœuds individuels ([types simples](#Types_simples)), ou un groupe de nœuds ([types d'ensembles de nœuds](#Types_d.27ensembles_de_n.C5.93uds)). -
    -
  • NUMBER_TYPE — un nombre
    • -
  • STRING_TYPE — une chaîne
    • -
  • BOOLEAN_TYPE — une valeur booléenne
    • -
+#### Types simples -

On obtiendra la valeur de retour de l'expression en accédant respectivement aux propriétés suivantes de l'objet XPathResult :

+Lorsque le type de résultat spécifié dans `resultType` est soit : -
    -
  • numberValue
    • -
  • stringValue
    • -
  • booleanValue
    • -
+- `NUMBER_TYPE` — un nombre +- `STRING_TYPE` — une chaîne +- `BOOLEAN_TYPE` — une valeur booléenne -
Exemple
+On obtiendra la valeur de retour de l'expression en accédant respectivement aux propriétés suivantes de l'objet `XPathResult` : -

Cet exemple utilise l'expression XPath count(//p) pour obtenir le nombre d'éléments <p> présents dans le document HTML :

+- `numberValue` +- `stringValue` +- `booleanValue` -
var paragraphCount = document.evaluate( 'count(//p)', document, null, XPathResult.ANY_TYPE, null );
+##### Exemple
 
-console.log( 'Ce document contient ' + paragraphCount.numberValue + ' éléments de paragraphe' );
-
+Cet exemple utilise l'expression XPath [`count(//p)`](/fr/docs/Web/XPath/Fonctions/count) pour obtenir le nombre d'éléments `

` présents dans le document HTML : -

Même si JavaScript convertira un nombre en chaîne pour l'affichage, l'interface XPath ne fera pas automatiquement la conversion du résultat numérique si la propriété stringValue est demandée. Ainsi, le code suivant ne fonctionnera pas :

+ var paragraphCount = document.evaluate( 'count(//p)', document, null, XPathResult.ANY_TYPE, null ); -
var paragraphCount = document.evaluate('count(//p)', document, null, XPathResult.ANY_TYPE, null );
+    console.log( 'Ce document contient ' + paragraphCount.numberValue + ' éléments de paragraphe' );
 
-console.log( 'Ce document contient ' + paragraphCount.stringValue + ' éléments de paragraphe' );
-
+Même si JavaScript convertira un nombre en chaîne pour l'affichage, l'interface XPath ne fera pas automatiquement la conversion du résultat numérique si la propriété `stringValue` est demandée. Ainsi, le code suivant ne fonctionnera **pas** : -

Au lieu de cela, il déclenchera une exception portant le code NS_DOM_TYPE_ERROR.

+ var paragraphCount = document.evaluate('count(//p)', document, null, XPathResult.ANY_TYPE, null ); -

Types d'ensembles de nœuds

+ console.log( 'Ce document contient ' + paragraphCount.stringValue + ' éléments de paragraphe' ); -

L'objet XPathResult permet de renvoyer les ensembles de nœuds sous la forme de trois types principaux :

+Au lieu de cela, il déclenchera une exception portant le code `NS_DOM_TYPE_ERROR`. - +#### Types d'ensembles de nœuds -
Itérateurs
+L'objet `XPathResult` permet de renvoyer les ensembles de nœuds sous la forme de trois types principaux : -

Lorsque le type de résultat spécifié dans le paramètre resultType est soit :

+- [Itérateurs](#It.C3.A9rateurs) +- [Snapshots](#Snapshots) +- [Premiers nœuds](#Premiers_n.C5.93uds) -
    -
  • UNORDERED_NODE_ITERATOR_TYPE
    • -
  • ORDERED_NODE_ITERATOR_TYPE
    • -
+##### Itérateurs -

L'objet XPathResult renvoyé sera un ensemble de nœuds correspondant à l'expression se comportant comme un itérateur. On pourra accéder individuellement aux nœuds qu'il contient en utilisant la méthode iterateNext() de l'objet XPathResult.

+Lorsque le type de résultat spécifié dans le paramètre `resultType` est soit : -

Lorsque tous les nœuds ont été parcourus, iterateNext() renverra null.

+- `UNORDERED_NODE_ITERATOR_TYPE` +- `ORDERED_NODE_ITERATOR_TYPE` -

Notez cependant que si le document est modifié (l'arbre du document est modifié) entre les itérations, l'itérateur sera invalidé et la propriété invalidIteratorState de XPathResult deviendra true. Une exception NS_ERROR_DOM_INVALID_STATE_ERR sera également déclenchée.

+L'objet `XPathResult` renvoyé sera un ensemble de nœuds correspondant à l'expression se comportant comme un itérateur. On pourra accéder individuellement aux nœuds qu'il contient en utilisant la méthode [`iterateNext()`](/fr/docs/Web/XPathResult/IterateNext) de l'objet `XPathResult`. -
Exemple d'itérateur
+Lorsque tous les nœuds ont été parcourus, [`iterateNext()`](/fr/docs/Web/XPathResult/IterateNext) renverra `null`. -
var iterator = document.evaluate('//phoneNumber', documentNode, null, XPathResult.UNORDERED_NODE_ITERATOR_TYPE, null );
+Notez cependant que si le document est modifié (l'arbre du document est modifié) entre les itérations, l'itérateur sera invalidé et la propriété `invalidIteratorState` de `XPathResult` deviendra `true`. Une exception `NS_ERROR_DOM_INVALID_STATE_ERR` sera également déclenchée.
 
-try {
-  var thisNode = iterator.iterateNext();
+
Exemple d'itérateur

 
-  while (thisNode) {
-    console.log( thisNode.textContent );
-    thisNode = iterator.iterateNext();
-  }
-}
-catch (e) {
-  console.log( 'Erreur : L\'arbre du document a été modifié pendant l\'itération ' + e );
-}
-
+ var iterator = document.evaluate('//phoneNumber', documentNode, null, XPathResult.UNORDERED_NODE_ITERATOR_TYPE, null ); -
Snapshots
+ try { + var thisNode = iterator.iterateNext(); -

Lorsque le type de résultat spécifié dans le paramètre resultType est l'une des valeurs suivantes :

+ while (thisNode) { + console.log( thisNode.textContent ); + thisNode = iterator.iterateNext(); + } + } + catch (e) { + console.log( 'Erreur : L\'arbre du document a été modifié pendant l\'itération ' + e ); + } -
    -
  • UNORDERED_NODE_SNAPSHOT_TYPE
    • -
  • ORDERED_NODE_SNAPSHOT_TYPE
    • -
+##### Snapshots -

L'objet XPathResult renvoyé sera un ensemble statique de nœuds correspondant à l'expression. L'accès à chaque nœud se fera au travers de la méthode snapshotItem(itemNumber) de l'objet XPathResult, où itemNumber est l'indice du nœud à récupérer. On peut accéder au nombre total de nœuds contenus dans l'ensemble par la propriété snapshotLength.

+Lorsque le type de résultat spécifié dans le paramètre `resultType` est l'une des valeurs suivantes : -

Les snapshots ne changent pas avec les mutations du document. Aussi, contrairement aux itérateurs, le snapshot ne deviendra pas invalide mais peut ne plus correspondre au document actuel. Par exemple, des nœuds peuvent avoir été déplacés, il peut contenir des nœuds qui n'existent plus ou de nouveaux nœuds peuvent avoir été ajoutés.

+- `UNORDERED_NODE_SNAPSHOT_TYPE` +- `ORDERED_NODE_SNAPSHOT_TYPE` + +L'objet `XPathResult` renvoyé sera un ensemble statique de nœuds correspondant à l'expression. L'accès à chaque nœud se fera au travers de la méthode [`snapshotItem(itemNumber)`](/fr/docs/Web/XPathResult/SnapshotItem) de l'objet `XPathResult`, où `itemNumber` est l'indice du nœud à récupérer. On peut accéder au nombre total de nœuds contenus dans l'ensemble par la propriété `snapshotLength`. + +Les snapshots ne changent pas avec les mutations du document. Aussi, contrairement aux itérateurs, le snapshot ne deviendra pas invalide mais peut ne plus correspondre au document actuel. Par exemple, des nœuds peuvent avoir été déplacés, il peut contenir des nœuds qui n'existent plus ou de nouveaux nœuds peuvent avoir été ajoutés.
Exemple de snapshot
-
var nodesSnapshot = document.evaluate('//phoneNumber', documentNode, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null );
+    var nodesSnapshot = document.evaluate('//phoneNumber', documentNode, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null );
 
-for ( var i=0 ; i < nodesSnapshot.snapshotLength; i++ ){
-  console.log( nodesSnapshot.snapshotItem(i).textContent );
-}
-
+ for ( var i=0 ; i < nodesSnapshot.snapshotLength; i++ ){ + console.log( nodesSnapshot.snapshotItem(i).textContent ); + } -
Premier nœud
+##### Premier nœud -

Lorsque le type de résultat spécifié dans le paramètre resultType est l'une des valeurs suivantes :

+Lorsque le type de résultat spécifié dans le paramètre `resultType` est l'une des valeurs suivantes : -
    -
  • ANY_UNORDERED_NODE_TYPE
    • -
  • FIRST_ORDERED_NODE_TYPE
    • -
+- `ANY_UNORDERED_NODE_TYPE` +- `FIRST_ORDERED_NODE_TYPE` -

L'objet XPathResult renvoyé n'est que le premier nœud trouvé correspondant à l'expression XPath. On peut y accéder à l'aide de la propriété singleNodeValue de l'objet XPathResult. Celle-ci vaudra null si l'ensemble de nœuds est vide.

+L'objet `XPathResult` renvoyé n'est que le premier nœud trouvé correspondant à l'expression XPath. On peut y accéder à l'aide de la propriété `singleNodeValue` de l'objet `XPathResult`. Celle-ci vaudra `null` si l'ensemble de nœuds est vide. -

Notez que pour le sous-type non ordonné (le premier), le nœud unique renvoyé ne sera peut-être pas le premier nœud dans l'ordre du document. Dans le cas du sous-type ordonné (le second), vous pouvez être sûr d'obtenir le premier nœud correspondant dans l'ordre du document.

+Notez que pour le sous-type non ordonné (le premier), le nœud unique renvoyé ne sera peut-être pas le premier nœud dans l'ordre du document. Dans le cas du sous-type ordonné (le second), vous pouvez être sûr d'obtenir le premier nœud correspondant dans l'ordre du document.
Exemple de premier nœud
-
var firstPhoneNumber = document.evaluate('//phoneNumber', documentNode, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null );
+```js
+var firstPhoneNumber = document.evaluate('//phoneNumber', documentNode, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null );
 
 console.log( 'Le premier numéro de téléphone trouvé est ' + firstPhoneNumber.singleNodeValue.textContent );
-
+``` -

La constante ANY_TYPE

+#### La constante ANY_TYPE -

Lorsque le type de résultat spécifié dans le paramètre resultType est la valeur ANY_TYPE, l'objet XPathResult renvoyé pourra être de n'importe quel type, c'est-à-dire du type résultant le plus naturellement de l'évaluation de l'expression.

+Lorsque le type de résultat spécifié dans le paramètre `resultType` est la valeur `ANY_TYPE`, l'objet `XPathResult` renvoyé pourra être de n'importe quel type, c'est-à-dire du type résultant le plus naturellement de l'évaluation de l'expression. -

Il peut s'agir de n'importe lequel des types simples (NUMBER_TYPE, STRING_TYPE, BOOLEAN_TYPE), mais si le type du résultat retourné est un ensemble de nœuds alors il ne pourra être que du type UNORDERED_NODE_ITERATOR_TYPE.

+Il peut s'agir de n'importe lequel des types simples (`NUMBER_TYPE, STRING_TYPE, BOOLEAN_TYPE`), **mais** si le type du résultat retourné est un ensemble de nœuds alors il ne pourra être **que** du type `UNORDERED_NODE_ITERATOR_TYPE`. -

Pour déterminer le type utilisé après l'évaluation, on utilisera la propriété resultType de l'objet XPathResult. Les valeurs constantes de cette propriété sont définies dans l'annexe.

+Pour déterminer le type utilisé après l'évaluation, on utilisera la propriété `resultType` de l'objet `XPathResult`. Les valeurs [constantes](#Constantes_d.C3.A9finies_de_XPathResult) de cette propriété sont définies dans l'annexe. -

None Yet =====Exemple Any_Type===== <pre> </pre>

+None Yet =====Exemple Any_Type===== \
 \
-

Exemples

+## Exemples -

Dans un document HTML

+### Dans un document HTML -

Le code suivant est destiné à être inséré dans un fragment JavaScript intégré ou lié au document HTML qui devra être évalué par l'expression XPath.

+Le code suivant est destiné à être inséré dans un fragment JavaScript intégré ou lié au document HTML qui devra être évalué par l'expression XPath. -

Pour extraire tous les éléments d'en-tête <h2> d'un document HTML à l'aide de XPath, l'expression xpathExpression est simplement '//h2', où // est l'opérateur descendant récursif (ou RDO) qui correspond aux éléments dont la propriété nodeName est h2 n'importe où dans l'arbre du document. Le code complet pour cela est : link to introductory xpath doc

+Pour extraire tous les éléments d'en-tête `

` d'un document HTML à l'aide de XPath, l'expression `xpathExpression` est simplement '`//h2`', où `//` est l'opérateur descendant récursif (ou RDO) qui correspond aux éléments dont la propriété `nodeName` est `h2` n'importe où dans l'arbre du document. Le code complet pour cela est : link to introductory xpath doc -
var headings = document.evaluate('//h2', document, null, XPathResult.ANY_TYPE, null );
-
+```js +var headings = document.evaluate('//h2', document, null, XPathResult.ANY_TYPE, null ); +``` -

Notez que, comme HTML ne possède pas d'espace de nommage, null a été passé comme paramètre namespaceResolver.

+Notez que, comme HTML ne possède pas d'espace de nommage, `null` a été passé comme paramètre `namespaceResolver`. -

Comme le but est de chercher les en-têtes dans l'intégralité du document, on utilise l'objet document lui-même comme paramètre contextNode.

+Comme le but est de chercher les en-têtes dans l'intégralité du document, on utilise l'objet [document](/fr/docs/Web/API/Document/) lui-même comme paramètre `contextNode`. -

Le résultat de cette expression est un objet XPathResult. Pour connaître le type de résultat renvoyé, il convient d'évaluer la propriété resultType de l'objet renvoyé. Dans notre cas, il sera évalué à 4, c'est donc un UNORDERED_NODE_ITERATOR_TYPE. Il s'agit du type de retour par défaut lorsque le résultat de l'expression XPath est un ensemble de nœuds. Il permet d'accéder à un seul nœud à la fois et ne renvoie pas les nœuds dans un ordre particulier. Pour accéder à ceux-ci, on utilise la méthode iterateNext() de l'objet renvoyé :

+Le résultat de cette expression est un objet `XPathResult`. Pour connaître le type de résultat renvoyé, il convient d'évaluer la propriété `resultType` de l'objet renvoyé. Dans notre cas, il sera évalué à `4`, c'est donc un `UNORDERED_NODE_ITERATOR_TYPE`. Il s'agit du type de retour par défaut lorsque le résultat de l'expression XPath est un ensemble de nœuds. Il permet d'accéder à un seul nœud à la fois et ne renvoie pas les nœuds dans un ordre particulier. Pour accéder à ceux-ci, on utilise la méthode `iterateNext()` de l'objet renvoyé : -
var thisHeading = headings.iterateNext();
+    var thisHeading = headings.iterateNext();
 
-var alertText = 'Les en-têtes de niveau 2 présents dans ce document sont :\n'
+    var alertText = 'Les en-têtes de niveau 2 présents dans ce document sont :\n'
 
-while (thisHeading) {
-  alertText += thisHeading.textContent + '\n';
-  thisHeading = headings.iterateNext();
-}
-
+ while (thisHeading) { + alertText += thisHeading.textContent + '\n'; + thisHeading = headings.iterateNext(); + } -

Une fois l'itération effectuée sur un nœud, nous avons accès à toutes les Interfaces DOM standards de ce nœud. Après avoir parcouru tous les éléments h2 renvoyés à partir de notre expression, chaque nouvel appel à iterateNext() donnera null.

+Une fois l'itération effectuée sur un nœud, nous avons accès à toutes les [Interfaces DOM](/fr/docs/Web/API/Document_Object_Model#Interfaces_du_DOM) standards de ce nœud. Après avoir parcouru tous les éléments `h2` renvoyés à partir de notre expression, chaque nouvel appel à `iterateNext()` donnera `null`. -

Évaluation d'un document XML appartenant à une extension

+### Évaluation d'un document XML appartenant à une extension -

L'exemple suivant utilise un document XML situé à l'adresse chrome://yourextension/content/peopleDB.xml.

+L'exemple suivant utilise un document XML situé à l'adresse [`chrome://yourextension/content/peopleDB.xml`](). -
<?xml version="1.0"?>
-<people xmlns:xul = "http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul" >
-  <person>
-	<name first="george" last="bush" />
-	<address street="1600 pennsylvania avenue" city="washington" country="usa"/>
-	<phoneNumber>202-456-1111</phoneNumber>
-  </person>
-  <person>
-	<name first="tony" last="blair" />
-	<address street="10 downing street" city="london" country="uk"/>
-	<phoneNumber>020 7925 0918</phoneNumber>
-  </person>
-</people>
-
+ + + + +
+ 202-456-1111 + + + +
+ 020 7925 0918 + + -

Pour rendre les contenus du document XML accessibles depuis l'extension, on crée un objet XMLHttpRequest pour charger le document de façon synchrone. La variable xmlDoc contiendra le document comme un objet XMLDocument sur lequel on pourra utiliser la méthode evaluate.

+Pour rendre les contenus du document XML accessibles depuis l'extension, on crée un objet [`XMLHttpRequest`](/fr/docs/Web/API/XMLHttpRequest) pour charger le document de façon synchrone. La variable `xmlDoc` contiendra le document comme un objet [`XMLDocument`](/fr/docs/Web/API/XMLDocument) sur lequel on pourra utiliser la méthode `evaluate`. -

JavaScript utilisé dans les documents XUL/js des extensions.

+_JavaScript utilisé dans les documents XUL/js des extensions._ -
var req = new XMLHttpRequest();
+    var req = new XMLHttpRequest();
 
-req.open("GET", "chrome://yourextension/content/peopleDB.xml", false);
-req.send(null);
+    req.open("GET", "chrome://yourextension/content/peopleDB.xml", false);
+    req.send(null);
 
-var xmlDoc = req.responseXML;
+    var xmlDoc = req.responseXML;
 
-var nsResolver = xmlDoc.createNSResolver( xmlDoc.ownerDocument == null ? xmlDoc.documentElement : xmlDoc.ownerDocument.documentElement);
+    var nsResolver = xmlDoc.createNSResolver( xmlDoc.ownerDocument == null ? xmlDoc.documentElement : xmlDoc.ownerDocument.documentElement);
 
-var personIterator = xmlDoc.evaluate('//person', xmlDoc, nsResolver, XPathResult.ANY_TYPE, null );
-
+ var personIterator = xmlDoc.evaluate('//person', xmlDoc, nsResolver, XPathResult.ANY_TYPE, null ); -

Note

+#### Note -

Quant l'objet XPathResult n'est pas défini, les constantes peuvent être récupérées dans du code privilégié avec Components.inertfaces.nsIDOMXPathResult.ANY_TYPE(CI.nsIDOMXPathResult). De la même manière un objet XPathEvaluator peut être créé en utilisant :

+Quant l'objet XPathResult n'est pas défini, les constantes peuvent être récupérées dans du code privilégié avec `Components.inertfaces.nsIDOMXPathResult.ANY_TYPE(CI.nsIDOMXPathResult)`. De la même manière un objet XPathEvaluator peut être créé en utilisant : -
Components.classes["@mozille.org/dom/xpath-evaluator;1"].createInstance(Components.interfaces.nsIDOMXPathEvaluator)
+ Components.classes["@mozille.org/dom/xpath-evaluator;1"].createInstance(Components.interfaces.nsIDOMXPathEvaluator) -

Annexe

+## Annexe -

Implémentation d'un résolveur d'espace de nommage personnalisé

+#### Implémentation d'un résolveur d'espace de nommage personnalisé -

Cet exemple ne sert que d'illustration. Cette fonction nécessitera de prendre les préfixes d'espaces de nommage depuis la xpathExpression et retourne l'URI correspondante à ces préfixes. Par exemple, l'expression :

+Cet exemple ne sert que d'illustration. Cette fonction nécessitera de prendre les préfixes d'espaces de nommage depuis la `xpathExpression` et retourne l'URI correspondante à ces préfixes. Par exemple, l'expression : -
'//xhtml:td/mathml:math'
-
+ '//xhtml:td/mathml:math' -

sélectionnera toutes les expressions MathML qui sont les descendantes des éléments (X)HTML de cellules de tableau.

+sélectionnera toutes les expressions [MathML](/fr/MathML) qui sont les descendantes des éléments (X)HTML de cellules de tableau. -

Afin d'associer le préfixe mathml: avec l'URI d'espace de nommage 'http://www.w3.org/1998/Math/MathML' et xhtml: avec l'URI http://www.w3.org/1999/xhtml, nous fournissons une fonction :

+Afin d'associer le préfixe `mathml:` avec l'URI d'espace de nommage '[`http://www.w3.org/1998/Math/MathML`](http://www.w3.org/1998/Math/MathML)' et `xhtml:` avec l'URI [`http://www.w3.org/1999/xhtml`](http://www.w3.org/1999/xhtml), nous fournissons une fonction : -
function nsResolver(prefix) {
-  var ns = {
-    'xhtml' : 'http://www.w3.org/1999/xhtml',
-    'mathml': 'http://www.w3.org/1998/Math/MathML'
-  };
-  return ns[prefix] || null;
-}
-
+ function nsResolver(prefix) { + var ns = { + 'xhtml' : 'http://www.w3.org/1999/xhtml', + 'mathml': 'http://www.w3.org/1998/Math/MathML' + }; + return ns[prefix] || null; + } -

L'appel à document.evaluate ressemblera alors à :

+L'appel à `document.evaluate` ressemblera alors à : -
document.evaluate( '//xhtml:td/mathml:math', document, nsResolver, XPathResult.ANY_TYPE, null );
-
+ document.evaluate( '//xhtml:td/mathml:math', document, nsResolver, XPathResult.ANY_TYPE, null ); -

Implémentation d'un espace de nommage par défaut pour les documents XML

+#### Implémentation d'un espace de nommage par défaut pour les documents XML -

Comme nous l'avons vu précédemment dans la section #Implémentation d'un résolveur d'espaces de nommage par défaut, le résolveur par défaut ne gère pas l'espace de nommage par défaut pour les documents XML. Par exemple, avec ce document :

+Comme nous l'avons vu précédemment dans la section [#Implémentation d'un résolveur d'espaces de nommage par défaut](#Impl.C3.A9mentation_d.27un_r.C3.A9solveur_d.27espaces_de_nommage_par_d.C3.A9faut), le résolveur par défaut ne gère pas l'espace de nommage par défaut pour les documents XML. Par exemple, avec ce document : -
<?xml version="1.0" encoding="UTF-8"?>
-<feed xmlns="http://www.w3.org/2005/Atom">
-    <entry />
-    <entry />
-    <entry />
-</feed>
-
+ + + + + + -

doc.evaluate('//entry', doc, nsResolver, XPathResult.ANY_TYPE, null) retournera un ensemble vide, où nsResolver est le résolveur retourné par createNSResolver. Passé un résolveur null ne fonctionne pas mieux.

+`doc.evaluate('//entry', doc, nsResolver, XPathResult.ANY_TYPE, null)` retournera un ensemble vide, où `nsResolver` est le résolveur retourné par `createNSResolver`. Passé un résolveur `null` ne fonctionne pas mieux. -

Une alternative possible est de créer un résolveur personnalisé qui retournera le bon espace de nommage (l'espace de nommage Atom dans ce cas). Par exemple :

+Une alternative possible est de créer un résolveur personnalisé qui retournera le bon espace de nommage (l'espace de nommage _Atom_ dans ce cas). Par exemple : -
 function resolver() {
-     return 'http://www.w3.org/2005/Atom';
- }
- doc.evaluate('//entry', doc, resolver, XPathResult.ANY_TYPE, null)
-
+ function resolver() { + return 'http://www.w3.org/2005/Atom'; + } + doc.evaluate('//entry', doc, resolver, XPathResult.ANY_TYPE, null) -

Un résolveur plus complexe sera nécessaire si le document utilise de multiple espaces de nommage.

+Un résolveur plus complexe sera nécessaire si le document utilise de multiple espaces de nommage. -

Une approche qui peut potentiellement mieux fonctionner (et autoriser les espaces de nom à ne pas être connus au fil du temps) est décrite dans la section suivante.

+Une approche qui peut potentiellement mieux fonctionner (et autoriser les espaces de nom à ne pas être connus au fil du temps) est décrite dans la section suivante. -

Utiliser les fonctions XPath pour référencer les éléments avec un espace de nom par défaut

+#### Utiliser les fonctions XPath pour référencer les éléments avec un espace de nom par défaut -

Une autre approche pour identifier les éléments par défaut dans un espace de noms non-null (et qui fonctionne bien pour les expressions XPath dynamiques où les espaces de noms peuvent ne pas être connus) implique la référence à un élément particulier en utilisant un formulaire tel que [namespace-uri()='http://www.w3.org/1999/xhtml' and name()='p' and @id='_monid']. Cela évite les problèmes résultant en une requête XPath qui n'est pas capable de détecter l'espace de noms par défaut sur un élément labelisé correctement.

+Une autre approche pour identifier les éléments par défaut dans un espace de noms non-null (et qui fonctionne bien pour les expressions XPath dynamiques où les espaces de noms peuvent ne pas être connus) implique la référence à un élément particulier en utilisant un formulaire tel que `[namespace-uri()='http://www.w3.org/1999/xhtml' and name()='p' and @id='_monid']`. Cela évite les problèmes résultant en une requête XPath qui n'est pas capable de détecter l'espace de noms par défaut sur un élément labelisé correctement. -

Obtenir des éléments et des attributs d'un espace de noms spécifique en ignorant le préfixe

+#### Obtenir des éléments et des attributs d'un espace de noms spécifique en ignorant le préfixe -

Si l'on souhaite avoir une certaine flexibilité dans les espaces de noms en ne nécessitant pas d'utiliser un préfixe spécifique lorsque l'on veut trouver un élément ou un attribut appartenant à un espace de noms, on doit utiliser des techniques spéciales.

+Si l'on souhaite avoir une certaine flexibilité dans les espaces de noms en ne nécessitant pas d'utiliser un préfixe spécifique lorsque l'on veut trouver un élément ou un attribut appartenant à un espace de noms, on doit utiliser des techniques spéciales. -

Tandis que l'on peut adapter la technique dans la section supérieure pour tester les éléments appartenant à un espace de noms sans regarder le préfix choisi (en utilisant local-name() combiné avec namespace-uri() à la place de name()), un situation plus compliquée apparaît cependant, si l'on souhaite obtenir un élément avec un attribut appartenant à un espace de noms spécifique dans un prédicat (étant donnée l'absence des variables indépendantes de l'implémentation en XPath 1.0).

+Tandis que l'on peut adapter la technique dans la section supérieure pour tester les éléments appartenant à un espace de noms sans regarder le préfix choisi (en utilisant [local-name()](/XPath/Functions/local-name) combiné avec [namespace-uri()](/XPath/Functions/namespace-uri) à la place de [name()](/XPath/Functions/name)), un situation plus compliquée apparaît cependant, si l'on souhaite obtenir un élément avec un attribut appartenant à un espace de noms spécifique dans un prédicat (étant donnée l'absence des variables indépendantes de l'implémentation en XPath 1.0). -

Par exemple, on peut essayer (de manière incorrecte) d'obtenir un élément avec un attribut appartenant à un espace de noms de la manière suivante : var xpathlink = someElements[local-name(@*)="href" and namespace-uri(@*)='http://www.w3.org/1999/xlink'];

+Par exemple, on peut essayer (de manière incorrecte) d'obtenir un élément avec un attribut appartenant à un espace de noms de la manière suivante : `var xpathlink = someElements[local-name(@*)="href" and namespace-uri(@*)='http://www.w3.org/1999/xlink'];` -

Cela pourrait récupérer des éléments par inadvertance si un de ces attributs existaient avec un nom local "href", mais que c'était un autre attribut qui avait le nom d'espace ciblé (XLink, à la place de @href).

+Cela pourrait récupérer des éléments par inadvertance si un de ces attributs existaient avec un nom local "`href`", mais que c'était un autre attribut qui avait le nom d'espace ciblé (XLink, à la place de [@href](/XPath/Axes/attribute)). -

Afin d'obtenir des éléments avec l'attribut XLink @href de manière précise (sans par ailleurs être obligé de définir des préfixes dans un résolveur de nom d'espaces), on procéder comme suit :

+Afin d'obtenir des éléments avec l'attribut XLink `@href` de manière précise (sans par ailleurs être obligé de définir des préfixes dans un résolveur de nom d'espaces), on procéder comme suit : -
var xpathEls = 'someElements[@*[local-name() = "href" and manespace-uri() = "http://www.w3.org/1999/xlink"]]'; // Récupère les éléments avec un simple attribute qui a à la fois le nom local 'href' and l'espace de noms XLink
-var thislevel = xml.evaluate(xpathEls, xml, null, XPathResult.ANY_TYPE, null);
-var thisitemEl = thislevel.iterateNext();
-
+ var xpathEls = 'someElements[@*[local-name() = "href" and manespace-uri() = "http://www.w3.org/1999/xlink"]]'; // Récupère les éléments avec un simple attribute qui a à la fois le nom local 'href' and l'espace de noms XLink + var thislevel = xml.evaluate(xpathEls, xml, null, XPathResult.ANY_TYPE, null); + var thisitemEl = thislevel.iterateNext(); -

Constantes définies de XPathResult

+#### Constantes définies de XPathResult - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Constante du type de résultatValeurDescription
ANY_TYPE0Un ensemble contenant n'importe quel type qui résulte naturellement de l'évaluation de l'expression. Notez que si c'est un ensemble de noeuds qui doit être retourné, alors le type résultant sera toujours UNORDERED_NODE_ITERATOR_TYPE.
NUMBER_TYPE1Un résultat contenant un seul nombre. C'est utile, par exemple, dans une expression XPath utilisant la fonction count().
STRING_TYPE2Un résultat contenant une seule chaîne de caractère.
BOOLEAN_TYPE3Un résultat contenant une seule valeur booléenne. C'est utile, par exemple, dans une expression XPath utilisant la fonction not().
UNORDERED_NODE_ITERATOR_TYPE4Un ensemble de nœuds contenant tous les nœuds vérifiant l'expression. Les nœuds ne sont pas nécessairement dans le même ordre que celui dans lequel ils apparaissent dans le document.
ORDERED_NODE_ITERATOR_TYPE5Un ensemble de nœuds contenant tous les nœuds vérifiant l'expression. Les nœuds du résultat sont dans le même ordre que celui dans lequel ils apparaissent dans le document.
UNORDERED_NODE_SNAPSHOT_TYPE6Un ensemble de nœuds contenant les snapshots de tous les nœuds vérifiant l'expression. Les nœuds ne sont pas nécessairement dans le même ordre que celui dans lequel ils apparaissent dans le document.
ORDERED_NODE_SNAPSHOT_TYPE7Un ensemble de nœuds contenant les snapshots de tous les nœuds vérifiant l'expression. Les nœuds du résultat sont dans le même ordre que celui dans lequel ils apparaissent dans le document.
ANY_UNORDERED_NODE_TYPE8Un ensemble de nœuds contenant un seul nœud vérifiant l'expression. Le nœud n'est pas nécessairement le premier dans l'ordre du document qui correspond à l'expression.
FIRST_ORDERED_NODE_TYPE9Un ensemble de nœuds contenant le premier nœud du document vérifiant l'expression.
Constante du type de résultatValeurDescription
ANY_TYPE0 + Un ensemble contenant n'importe quel type qui résulte naturellement de + l'évaluation de l'expression. Notez que si c'est un ensemble de noeuds + qui doit être retourné, alors le type résultant sera toujours + UNORDERED_NODE_ITERATOR_TYPE. +
NUMBER_TYPE1 + Un résultat contenant un seul nombre. C'est utile, par exemple, dans une + expression XPath utilisant la fonction count(). +
STRING_TYPE2Un résultat contenant une seule chaîne de caractère.
BOOLEAN_TYPE3 + Un résultat contenant une seule valeur booléenne. C'est utile, par + exemple, dans une expression XPath utilisant la fonction + not(). +
UNORDERED_NODE_ITERATOR_TYPE4 + Un ensemble de nœuds contenant tous les nœuds vérifiant l'expression. + Les nœuds ne sont pas nécessairement dans le même ordre que celui dans + lequel ils apparaissent dans le document. +
ORDERED_NODE_ITERATOR_TYPE5 + Un ensemble de nœuds contenant tous les nœuds vérifiant l'expression. + Les nœuds du résultat sont dans le même ordre que celui dans lequel ils + apparaissent dans le document. +
UNORDERED_NODE_SNAPSHOT_TYPE6 + Un ensemble de nœuds contenant les snapshots de tous les nœuds vérifiant + l'expression. Les nœuds ne sont pas nécessairement dans le même ordre + que celui dans lequel ils apparaissent dans le document. +
ORDERED_NODE_SNAPSHOT_TYPE7 + Un ensemble de nœuds contenant les snapshots de tous les nœuds vérifiant + l'expression. Les nœuds du résultat sont dans le même ordre que celui + dans lequel ils apparaissent dans le document. +
ANY_UNORDERED_NODE_TYPE8 + Un ensemble de nœuds contenant un seul nœud vérifiant l'expression. Le + nœud n'est pas nécessairement le premier dans l'ordre du document qui + correspond à l'expression. +
FIRST_ORDERED_NODE_TYPE9 + Un ensemble de nœuds contenant le premier nœud du document vérifiant + l'expression. +
-

Voir aussi

+## Voir aussi - +- [XPath](/fr/docs/Web/XPath) +- [XML Path Language](http://www.xml.com/pub/a/2000/08/holman/index.html?page=2#xpath-info) de _[What is XSLT?](http://www.xml.com/pub/a/2000/08/holman/)_ par G. Ken Holman -- cgit v1.2.3-54-g00ecf