From 651ec72d5f391987b970601ab532a2d303b44916 Mon Sep 17 00:00:00 2001 From: julieng Date: Thu, 11 Nov 2021 09:00:03 +0100 Subject: move *.html to *.md --- .../fr/web/xpath/axes/ancestor-or-self/index.html | 8 - files/fr/web/xpath/axes/ancestor-or-self/index.md | 8 + files/fr/web/xpath/axes/ancestor/index.html | 8 - files/fr/web/xpath/axes/ancestor/index.md | 8 + files/fr/web/xpath/axes/attribute/index.html | 8 - files/fr/web/xpath/axes/attribute/index.md | 8 + files/fr/web/xpath/axes/child/index.html | 8 - files/fr/web/xpath/axes/child/index.md | 8 + .../web/xpath/axes/descendant-or-self/index.html | 8 - .../fr/web/xpath/axes/descendant-or-self/index.md | 8 + files/fr/web/xpath/axes/descendant/index.html | 8 - files/fr/web/xpath/axes/descendant/index.md | 8 + .../fr/web/xpath/axes/following-sibling/index.html | 8 - files/fr/web/xpath/axes/following-sibling/index.md | 8 + files/fr/web/xpath/axes/following/index.html | 8 - files/fr/web/xpath/axes/following/index.md | 8 + files/fr/web/xpath/axes/index.html | 96 ----- files/fr/web/xpath/axes/index.md | 96 +++++ files/fr/web/xpath/axes/namespace/index.html | 9 - files/fr/web/xpath/axes/namespace/index.md | 9 + files/fr/web/xpath/axes/parent/index.html | 8 - files/fr/web/xpath/axes/parent/index.md | 8 + .../fr/web/xpath/axes/preceding-sibling/index.html | 8 - files/fr/web/xpath/axes/preceding-sibling/index.md | 8 + files/fr/web/xpath/axes/preceding/index.html | 8 - files/fr/web/xpath/axes/preceding/index.md | 8 + files/fr/web/xpath/axes/self/index.html | 8 - files/fr/web/xpath/axes/self/index.md | 8 + .../xpath/comparison_with_css_selectors/index.html | 50 --- .../xpath/comparison_with_css_selectors/index.md | 50 +++ files/fr/web/xpath/functions/boolean/index.html | 35 -- files/fr/web/xpath/functions/boolean/index.md | 35 ++ files/fr/web/xpath/functions/ceiling/index.html | 33 -- files/fr/web/xpath/functions/ceiling/index.md | 33 ++ files/fr/web/xpath/functions/concat/index.html | 29 -- files/fr/web/xpath/functions/concat/index.md | 29 ++ files/fr/web/xpath/functions/contains/index.html | 39 -- files/fr/web/xpath/functions/contains/index.md | 39 ++ files/fr/web/xpath/functions/count/index.html | 29 -- files/fr/web/xpath/functions/count/index.md | 29 ++ files/fr/web/xpath/functions/current/index.html | 32 -- files/fr/web/xpath/functions/current/index.md | 32 ++ files/fr/web/xpath/functions/document/index.html | 43 --- files/fr/web/xpath/functions/document/index.md | 43 +++ .../xpath/functions/element-available/index.html | 29 -- .../web/xpath/functions/element-available/index.md | 29 ++ files/fr/web/xpath/functions/false/index.html | 32 -- files/fr/web/xpath/functions/false/index.md | 32 ++ files/fr/web/xpath/functions/floor/index.html | 37 -- files/fr/web/xpath/functions/floor/index.md | 37 ++ .../web/xpath/functions/format-number/index.html | 38 -- .../fr/web/xpath/functions/format-number/index.md | 38 ++ .../xpath/functions/function-available/index.html | 29 -- .../xpath/functions/function-available/index.md | 29 ++ .../fr/web/xpath/functions/generate-id/index.html | 36 -- files/fr/web/xpath/functions/generate-id/index.md | 36 ++ files/fr/web/xpath/functions/id/index.html | 35 -- files/fr/web/xpath/functions/id/index.md | 35 ++ files/fr/web/xpath/functions/index.html | 50 --- files/fr/web/xpath/functions/index.md | 50 +++ files/fr/web/xpath/functions/key/index.html | 37 -- files/fr/web/xpath/functions/key/index.md | 37 ++ files/fr/web/xpath/functions/lang/index.html | 53 --- files/fr/web/xpath/functions/lang/index.md | 53 +++ files/fr/web/xpath/functions/last/index.html | 28 -- files/fr/web/xpath/functions/last/index.md | 28 ++ files/fr/web/xpath/functions/local-name/index.html | 32 -- files/fr/web/xpath/functions/local-name/index.md | 32 ++ files/fr/web/xpath/functions/name/index.html | 32 -- files/fr/web/xpath/functions/name/index.md | 32 ++ .../web/xpath/functions/namespace-uri/index.html | 34 -- .../fr/web/xpath/functions/namespace-uri/index.md | 34 ++ .../web/xpath/functions/normalize-space/index.html | 36 -- .../web/xpath/functions/normalize-space/index.md | 36 ++ files/fr/web/xpath/functions/not/index.html | 32 -- files/fr/web/xpath/functions/not/index.md | 32 ++ files/fr/web/xpath/functions/number/index.html | 32 -- files/fr/web/xpath/functions/number/index.md | 32 ++ files/fr/web/xpath/functions/position/index.html | 52 --- files/fr/web/xpath/functions/position/index.md | 52 +++ files/fr/web/xpath/functions/round/index.html | 32 -- files/fr/web/xpath/functions/round/index.md | 32 ++ .../fr/web/xpath/functions/starts-with/index.html | 22 -- files/fr/web/xpath/functions/starts-with/index.md | 22 ++ .../web/xpath/functions/string-length/index.html | 29 -- .../fr/web/xpath/functions/string-length/index.md | 29 ++ files/fr/web/xpath/functions/string/index.html | 40 -- files/fr/web/xpath/functions/string/index.md | 40 ++ .../web/xpath/functions/substring-after/index.html | 35 -- .../web/xpath/functions/substring-after/index.md | 35 ++ .../xpath/functions/substring-before/index.html | 35 -- .../web/xpath/functions/substring-before/index.md | 35 ++ files/fr/web/xpath/functions/substring/index.html | 37 -- files/fr/web/xpath/functions/substring/index.md | 37 ++ files/fr/web/xpath/functions/sum/index.html | 32 -- files/fr/web/xpath/functions/sum/index.md | 32 ++ .../web/xpath/functions/system-property/index.html | 34 -- .../web/xpath/functions/system-property/index.md | 34 ++ files/fr/web/xpath/functions/translate/index.html | 55 --- files/fr/web/xpath/functions/translate/index.md | 55 +++ files/fr/web/xpath/functions/true/index.html | 25 -- files/fr/web/xpath/functions/true/index.md | 25 ++ .../xpath/functions/unparsed-entity-url/index.html | 29 -- .../xpath/functions/unparsed-entity-url/index.md | 29 ++ files/fr/web/xpath/index.html | 75 ---- files/fr/web/xpath/index.md | 75 ++++ .../index.html | 411 --------------------- .../index.md | 411 +++++++++++++++++++++ 108 files changed, 2036 insertions(+), 2036 deletions(-) delete mode 100644 files/fr/web/xpath/axes/ancestor-or-self/index.html create mode 100644 files/fr/web/xpath/axes/ancestor-or-self/index.md delete mode 100644 files/fr/web/xpath/axes/ancestor/index.html create mode 100644 files/fr/web/xpath/axes/ancestor/index.md delete mode 100644 files/fr/web/xpath/axes/attribute/index.html create mode 100644 files/fr/web/xpath/axes/attribute/index.md delete mode 100644 files/fr/web/xpath/axes/child/index.html create mode 100644 files/fr/web/xpath/axes/child/index.md delete mode 100644 files/fr/web/xpath/axes/descendant-or-self/index.html create mode 100644 files/fr/web/xpath/axes/descendant-or-self/index.md delete mode 100644 files/fr/web/xpath/axes/descendant/index.html create mode 100644 files/fr/web/xpath/axes/descendant/index.md delete mode 100644 files/fr/web/xpath/axes/following-sibling/index.html create mode 100644 files/fr/web/xpath/axes/following-sibling/index.md delete mode 100644 files/fr/web/xpath/axes/following/index.html create mode 100644 files/fr/web/xpath/axes/following/index.md delete mode 100644 files/fr/web/xpath/axes/index.html create mode 100644 files/fr/web/xpath/axes/index.md delete mode 100644 files/fr/web/xpath/axes/namespace/index.html create mode 100644 files/fr/web/xpath/axes/namespace/index.md delete mode 100644 files/fr/web/xpath/axes/parent/index.html create mode 100644 files/fr/web/xpath/axes/parent/index.md delete mode 100644 files/fr/web/xpath/axes/preceding-sibling/index.html create mode 100644 files/fr/web/xpath/axes/preceding-sibling/index.md delete mode 100644 files/fr/web/xpath/axes/preceding/index.html create mode 100644 files/fr/web/xpath/axes/preceding/index.md delete mode 100644 files/fr/web/xpath/axes/self/index.html create mode 100644 files/fr/web/xpath/axes/self/index.md delete mode 100644 files/fr/web/xpath/comparison_with_css_selectors/index.html create mode 100644 files/fr/web/xpath/comparison_with_css_selectors/index.md delete mode 100644 files/fr/web/xpath/functions/boolean/index.html create mode 100644 files/fr/web/xpath/functions/boolean/index.md delete mode 100644 files/fr/web/xpath/functions/ceiling/index.html create mode 100644 files/fr/web/xpath/functions/ceiling/index.md delete mode 100644 files/fr/web/xpath/functions/concat/index.html create mode 100644 files/fr/web/xpath/functions/concat/index.md delete mode 100644 files/fr/web/xpath/functions/contains/index.html create mode 100644 files/fr/web/xpath/functions/contains/index.md delete mode 100644 files/fr/web/xpath/functions/count/index.html create mode 100644 files/fr/web/xpath/functions/count/index.md delete mode 100644 files/fr/web/xpath/functions/current/index.html create mode 100644 files/fr/web/xpath/functions/current/index.md delete mode 100644 files/fr/web/xpath/functions/document/index.html create mode 100644 files/fr/web/xpath/functions/document/index.md delete mode 100644 files/fr/web/xpath/functions/element-available/index.html create mode 100644 files/fr/web/xpath/functions/element-available/index.md delete mode 100644 files/fr/web/xpath/functions/false/index.html create mode 100644 files/fr/web/xpath/functions/false/index.md delete mode 100644 files/fr/web/xpath/functions/floor/index.html create mode 100644 files/fr/web/xpath/functions/floor/index.md delete mode 100644 files/fr/web/xpath/functions/format-number/index.html create mode 100644 files/fr/web/xpath/functions/format-number/index.md delete mode 100644 files/fr/web/xpath/functions/function-available/index.html create mode 100644 files/fr/web/xpath/functions/function-available/index.md delete mode 100644 files/fr/web/xpath/functions/generate-id/index.html create mode 100644 files/fr/web/xpath/functions/generate-id/index.md delete mode 100644 files/fr/web/xpath/functions/id/index.html create mode 100644 files/fr/web/xpath/functions/id/index.md delete mode 100644 files/fr/web/xpath/functions/index.html create mode 100644 files/fr/web/xpath/functions/index.md delete mode 100644 files/fr/web/xpath/functions/key/index.html create mode 100644 files/fr/web/xpath/functions/key/index.md delete mode 100644 files/fr/web/xpath/functions/lang/index.html create mode 100644 files/fr/web/xpath/functions/lang/index.md delete mode 100644 files/fr/web/xpath/functions/last/index.html create mode 100644 files/fr/web/xpath/functions/last/index.md delete mode 100644 files/fr/web/xpath/functions/local-name/index.html create mode 100644 files/fr/web/xpath/functions/local-name/index.md delete mode 100644 files/fr/web/xpath/functions/name/index.html create mode 100644 files/fr/web/xpath/functions/name/index.md delete mode 100644 files/fr/web/xpath/functions/namespace-uri/index.html create mode 100644 files/fr/web/xpath/functions/namespace-uri/index.md delete mode 100644 files/fr/web/xpath/functions/normalize-space/index.html create mode 100644 files/fr/web/xpath/functions/normalize-space/index.md delete mode 100644 files/fr/web/xpath/functions/not/index.html create mode 100644 files/fr/web/xpath/functions/not/index.md delete mode 100644 files/fr/web/xpath/functions/number/index.html create mode 100644 files/fr/web/xpath/functions/number/index.md delete mode 100644 files/fr/web/xpath/functions/position/index.html create mode 100644 files/fr/web/xpath/functions/position/index.md delete mode 100644 files/fr/web/xpath/functions/round/index.html create mode 100644 files/fr/web/xpath/functions/round/index.md delete mode 100644 files/fr/web/xpath/functions/starts-with/index.html create mode 100644 files/fr/web/xpath/functions/starts-with/index.md delete mode 100644 files/fr/web/xpath/functions/string-length/index.html create mode 100644 files/fr/web/xpath/functions/string-length/index.md delete mode 100644 files/fr/web/xpath/functions/string/index.html create mode 100644 files/fr/web/xpath/functions/string/index.md delete mode 100644 files/fr/web/xpath/functions/substring-after/index.html create mode 100644 files/fr/web/xpath/functions/substring-after/index.md delete mode 100644 files/fr/web/xpath/functions/substring-before/index.html create mode 100644 files/fr/web/xpath/functions/substring-before/index.md delete mode 100644 files/fr/web/xpath/functions/substring/index.html create mode 100644 files/fr/web/xpath/functions/substring/index.md delete mode 100644 files/fr/web/xpath/functions/sum/index.html create mode 100644 files/fr/web/xpath/functions/sum/index.md delete mode 100644 files/fr/web/xpath/functions/system-property/index.html create mode 100644 files/fr/web/xpath/functions/system-property/index.md delete mode 100644 files/fr/web/xpath/functions/translate/index.html create mode 100644 files/fr/web/xpath/functions/translate/index.md delete mode 100644 files/fr/web/xpath/functions/true/index.html create mode 100644 files/fr/web/xpath/functions/true/index.md delete mode 100644 files/fr/web/xpath/functions/unparsed-entity-url/index.html create mode 100644 files/fr/web/xpath/functions/unparsed-entity-url/index.md delete mode 100644 files/fr/web/xpath/index.html create mode 100644 files/fr/web/xpath/index.md delete mode 100644 files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.html create mode 100644 files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.md diff --git a/files/fr/web/xpath/axes/ancestor-or-self/index.html b/files/fr/web/xpath/axes/ancestor-or-self/index.html deleted file mode 100644 index 5094b970ea..0000000000 --- a/files/fr/web/xpath/axes/ancestor-or-self/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/ancestor-or-self/index.md b/files/fr/web/xpath/axes/ancestor-or-self/index.md new file mode 100644 index 0000000000..5094b970ea --- /dev/null +++ b/files/fr/web/xpath/axes/ancestor-or-self/index.md @@ -0,0 +1,8 @@ +--- +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 diff --git a/files/fr/web/xpath/axes/ancestor/index.html b/files/fr/web/xpath/axes/ancestor/index.html deleted file mode 100644 index da3da048d6..0000000000 --- a/files/fr/web/xpath/axes/ancestor/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/ancestor/index.md b/files/fr/web/xpath/axes/ancestor/index.md new file mode 100644 index 0000000000..da3da048d6 --- /dev/null +++ b/files/fr/web/xpath/axes/ancestor/index.md @@ -0,0 +1,8 @@ +--- +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 diff --git a/files/fr/web/xpath/axes/attribute/index.html b/files/fr/web/xpath/axes/attribute/index.html deleted file mode 100644 index 2d23fbe176..0000000000 --- a/files/fr/web/xpath/axes/attribute/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/attribute/index.md b/files/fr/web/xpath/axes/attribute/index.md new file mode 100644 index 0000000000..2d23fbe176 --- /dev/null +++ b/files/fr/web/xpath/axes/attribute/index.md @@ -0,0 +1,8 @@ +--- +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 diff --git a/files/fr/web/xpath/axes/child/index.html b/files/fr/web/xpath/axes/child/index.html deleted file mode 100644 index 71b117b5a7..0000000000 --- a/files/fr/web/xpath/axes/child/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/child/index.md b/files/fr/web/xpath/axes/child/index.md new file mode 100644 index 0000000000..71b117b5a7 --- /dev/null +++ b/files/fr/web/xpath/axes/child/index.md @@ -0,0 +1,8 @@ +--- +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 diff --git a/files/fr/web/xpath/axes/descendant-or-self/index.html b/files/fr/web/xpath/axes/descendant-or-self/index.html deleted file mode 100644 index 465710191e..0000000000 --- a/files/fr/web/xpath/axes/descendant-or-self/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/descendant-or-self/index.md b/files/fr/web/xpath/axes/descendant-or-self/index.md new file mode 100644 index 0000000000..465710191e --- /dev/null +++ b/files/fr/web/xpath/axes/descendant-or-self/index.md @@ -0,0 +1,8 @@ +--- +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 diff --git a/files/fr/web/xpath/axes/descendant/index.html b/files/fr/web/xpath/axes/descendant/index.html deleted file mode 100644 index 3897ddbf8b..0000000000 --- a/files/fr/web/xpath/axes/descendant/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/descendant/index.md b/files/fr/web/xpath/axes/descendant/index.md new file mode 100644 index 0000000000..3897ddbf8b --- /dev/null +++ b/files/fr/web/xpath/axes/descendant/index.md @@ -0,0 +1,8 @@ +--- +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 diff --git a/files/fr/web/xpath/axes/following-sibling/index.html b/files/fr/web/xpath/axes/following-sibling/index.html deleted file mode 100644 index 9ed21b0c4b..0000000000 --- a/files/fr/web/xpath/axes/following-sibling/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/following-sibling/index.md b/files/fr/web/xpath/axes/following-sibling/index.md new file mode 100644 index 0000000000..9ed21b0c4b --- /dev/null +++ b/files/fr/web/xpath/axes/following-sibling/index.md @@ -0,0 +1,8 @@ +--- +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 diff --git a/files/fr/web/xpath/axes/following/index.html b/files/fr/web/xpath/axes/following/index.html deleted file mode 100644 index ccf5191169..0000000000 --- a/files/fr/web/xpath/axes/following/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/following/index.md b/files/fr/web/xpath/axes/following/index.md new file mode 100644 index 0000000000..ccf5191169 --- /dev/null +++ b/files/fr/web/xpath/axes/following/index.md @@ -0,0 +1,8 @@ +--- +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 diff --git a/files/fr/web/xpath/axes/index.html b/files/fr/web/xpath/axes/index.html deleted file mode 100644 index ec59c9432b..0000000000 --- a/files/fr/web/xpath/axes/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: Axes -slug: Web/XPath/Axes -tags: - - Référence_XPath - - Référence_XSLT - - Transformations_XML_avec_XSLT - - XPath - - 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 (.).
-
diff --git a/files/fr/web/xpath/axes/index.md b/files/fr/web/xpath/axes/index.md new file mode 100644 index 0000000000..ec59c9432b --- /dev/null +++ b/files/fr/web/xpath/axes/index.md @@ -0,0 +1,96 @@ +--- +title: Axes +slug: Web/XPath/Axes +tags: + - Référence_XPath + - Référence_XSLT + - Transformations_XML_avec_XSLT + - XPath + - 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 (.).
+
diff --git a/files/fr/web/xpath/axes/namespace/index.html b/files/fr/web/xpath/axes/namespace/index.html deleted file mode 100644 index b6db3a451e..0000000000 --- a/files/fr/web/xpath/axes/namespace/index.html +++ /dev/null @@ -1,9 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/namespace/index.md b/files/fr/web/xpath/axes/namespace/index.md new file mode 100644 index 0000000000..b6db3a451e --- /dev/null +++ b/files/fr/web/xpath/axes/namespace/index.md @@ -0,0 +1,9 @@ +--- +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 diff --git a/files/fr/web/xpath/axes/parent/index.html b/files/fr/web/xpath/axes/parent/index.html deleted file mode 100644 index a12905e03e..0000000000 --- a/files/fr/web/xpath/axes/parent/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/parent/index.md b/files/fr/web/xpath/axes/parent/index.md new file mode 100644 index 0000000000..a12905e03e --- /dev/null +++ b/files/fr/web/xpath/axes/parent/index.md @@ -0,0 +1,8 @@ +--- +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 diff --git a/files/fr/web/xpath/axes/preceding-sibling/index.html b/files/fr/web/xpath/axes/preceding-sibling/index.html deleted file mode 100644 index 598739c27a..0000000000 --- a/files/fr/web/xpath/axes/preceding-sibling/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/preceding-sibling/index.md b/files/fr/web/xpath/axes/preceding-sibling/index.md new file mode 100644 index 0000000000..598739c27a --- /dev/null +++ b/files/fr/web/xpath/axes/preceding-sibling/index.md @@ -0,0 +1,8 @@ +--- +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 diff --git a/files/fr/web/xpath/axes/preceding/index.html b/files/fr/web/xpath/axes/preceding/index.html deleted file mode 100644 index bb6d7c977e..0000000000 --- a/files/fr/web/xpath/axes/preceding/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/preceding/index.md b/files/fr/web/xpath/axes/preceding/index.md new file mode 100644 index 0000000000..bb6d7c977e --- /dev/null +++ b/files/fr/web/xpath/axes/preceding/index.md @@ -0,0 +1,8 @@ +--- +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 diff --git a/files/fr/web/xpath/axes/self/index.html b/files/fr/web/xpath/axes/self/index.html deleted file mode 100644 index 3e604022ff..0000000000 --- a/files/fr/web/xpath/axes/self/index.html +++ /dev/null @@ -1,8 +0,0 @@ ---- -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 diff --git a/files/fr/web/xpath/axes/self/index.md b/files/fr/web/xpath/axes/self/index.md new file mode 100644 index 0000000000..3e604022ff --- /dev/null +++ b/files/fr/web/xpath/axes/self/index.md @@ -0,0 +1,8 @@ +--- +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 diff --git a/files/fr/web/xpath/comparison_with_css_selectors/index.html b/files/fr/web/xpath/comparison_with_css_selectors/index.html deleted file mode 100644 index d410038073..0000000000 --- a/files/fr/web/xpath/comparison_with_css_selectors/index.html +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Comparison entre les sélecteurs CSS et XPath -slug: Web/XPath/Comparison_with_CSS_selectors -tags: - - CSS - - Draft - - NeedsContent - - Reference - - XPath -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}}
- -

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")}}
diff --git a/files/fr/web/xpath/comparison_with_css_selectors/index.md b/files/fr/web/xpath/comparison_with_css_selectors/index.md new file mode 100644 index 0000000000..d410038073 --- /dev/null +++ b/files/fr/web/xpath/comparison_with_css_selectors/index.md @@ -0,0 +1,50 @@ +--- +title: Comparison entre les sélecteurs CSS et XPath +slug: Web/XPath/Comparison_with_CSS_selectors +tags: + - CSS + - Draft + - NeedsContent + - Reference + - XPath +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}}
+ +

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")}}
diff --git a/files/fr/web/xpath/functions/boolean/index.html b/files/fr/web/xpath/functions/boolean/index.html deleted file mode 100644 index 92e3b60b73..0000000000 --- a/files/fr/web/xpath/functions/boolean/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: boolean -slug: Web/XPath/Functions/boolean -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/boolean/index.md b/files/fr/web/xpath/functions/boolean/index.md new file mode 100644 index 0000000000..92e3b60b73 --- /dev/null +++ b/files/fr/web/xpath/functions/boolean/index.md @@ -0,0 +1,35 @@ +--- +title: boolean +slug: Web/XPath/Functions/boolean +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/ceiling/index.html b/files/fr/web/xpath/functions/ceiling/index.html deleted file mode 100644 index d7bf6f388f..0000000000 --- a/files/fr/web/xpath/functions/ceiling/index.html +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: ceiling -slug: Web/XPath/Functions/ceiling -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/ceiling/index.md b/files/fr/web/xpath/functions/ceiling/index.md new file mode 100644 index 0000000000..d7bf6f388f --- /dev/null +++ b/files/fr/web/xpath/functions/ceiling/index.md @@ -0,0 +1,33 @@ +--- +title: ceiling +slug: Web/XPath/Functions/ceiling +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/concat/index.html b/files/fr/web/xpath/functions/concat/index.html deleted file mode 100644 index 7ee8eeae00..0000000000 --- a/files/fr/web/xpath/functions/concat/index.html +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: concat -slug: Web/XPath/Functions/concat -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/concat/index.md b/files/fr/web/xpath/functions/concat/index.md new file mode 100644 index 0000000000..7ee8eeae00 --- /dev/null +++ b/files/fr/web/xpath/functions/concat/index.md @@ -0,0 +1,29 @@ +--- +title: concat +slug: Web/XPath/Functions/concat +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/contains/index.html b/files/fr/web/xpath/functions/contains/index.html deleted file mode 100644 index 15eb0239d7..0000000000 --- a/files/fr/web/xpath/functions/contains/index.html +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: contains -slug: Web/XPath/Functions/contains -translation_of: Web/XPath/Functions/contains -original_slug: Web/XPath/Fonctions/contains ---- -

{{ 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.

- -

Syntaxe

- -
contains( meule , aiguille )
-
- -

Arguments

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

Retour

- -

true si meule contient aiguille. Autrement, false.

- -

Définition

- -

XPath 1.0, section 4.2.

- -

Support Gecko

- -

Supportée.

diff --git a/files/fr/web/xpath/functions/contains/index.md b/files/fr/web/xpath/functions/contains/index.md new file mode 100644 index 0000000000..15eb0239d7 --- /dev/null +++ b/files/fr/web/xpath/functions/contains/index.md @@ -0,0 +1,39 @@ +--- +title: contains +slug: Web/XPath/Functions/contains +translation_of: Web/XPath/Functions/contains +original_slug: Web/XPath/Fonctions/contains +--- +

{{ 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.

+ +

Syntaxe

+ +
contains( meule , aiguille )
+
+ +

Arguments

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

Retour

+ +

true si meule contient aiguille. Autrement, false.

+ +

Définition

+ +

XPath 1.0, section 4.2.

+ +

Support Gecko

+ +

Supportée.

diff --git a/files/fr/web/xpath/functions/count/index.html b/files/fr/web/xpath/functions/count/index.html deleted file mode 100644 index 3db718509a..0000000000 --- a/files/fr/web/xpath/functions/count/index.html +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: count -slug: Web/XPath/Functions/count -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/count/index.md b/files/fr/web/xpath/functions/count/index.md new file mode 100644 index 0000000000..3db718509a --- /dev/null +++ b/files/fr/web/xpath/functions/count/index.md @@ -0,0 +1,29 @@ +--- +title: count +slug: Web/XPath/Functions/count +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/current/index.html b/files/fr/web/xpath/functions/current/index.html deleted file mode 100644 index 14543f6d1f..0000000000 --- a/files/fr/web/xpath/functions/current/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: current -slug: Web/XPath/Functions/current -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/current/index.md b/files/fr/web/xpath/functions/current/index.md new file mode 100644 index 0000000000..14543f6d1f --- /dev/null +++ b/files/fr/web/xpath/functions/current/index.md @@ -0,0 +1,32 @@ +--- +title: current +slug: Web/XPath/Functions/current +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/document/index.html b/files/fr/web/xpath/functions/document/index.html deleted file mode 100644 index 3f1bb98b80..0000000000 --- a/files/fr/web/xpath/functions/document/index.html +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: document -slug: Web/XPath/Functions/document -tags: - - Référence_XSLT -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

- - - - -

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 diff --git a/files/fr/web/xpath/functions/document/index.md b/files/fr/web/xpath/functions/document/index.md new file mode 100644 index 0000000000..3f1bb98b80 --- /dev/null +++ b/files/fr/web/xpath/functions/document/index.md @@ -0,0 +1,43 @@ +--- +title: document +slug: Web/XPath/Functions/document +tags: + - Référence_XSLT +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

+ + + + +

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 diff --git a/files/fr/web/xpath/functions/element-available/index.html b/files/fr/web/xpath/functions/element-available/index.html deleted file mode 100644 index 1ce80f0088..0000000000 --- a/files/fr/web/xpath/functions/element-available/index.html +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: element-available -slug: Web/XPath/Functions/element-available -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/element-available/index.md b/files/fr/web/xpath/functions/element-available/index.md new file mode 100644 index 0000000000..1ce80f0088 --- /dev/null +++ b/files/fr/web/xpath/functions/element-available/index.md @@ -0,0 +1,29 @@ +--- +title: element-available +slug: Web/XPath/Functions/element-available +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/false/index.html b/files/fr/web/xpath/functions/false/index.html deleted file mode 100644 index 1914710d4a..0000000000 --- a/files/fr/web/xpath/functions/false/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: 'false' -slug: Web/XPath/Functions/false -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/false/index.md b/files/fr/web/xpath/functions/false/index.md new file mode 100644 index 0000000000..1914710d4a --- /dev/null +++ b/files/fr/web/xpath/functions/false/index.md @@ -0,0 +1,32 @@ +--- +title: 'false' +slug: Web/XPath/Functions/false +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/floor/index.html b/files/fr/web/xpath/functions/floor/index.html deleted file mode 100644 index 9e986d4ea5..0000000000 --- a/files/fr/web/xpath/functions/floor/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: floor -slug: Web/XPath/Functions/floor -tags: - - Fonction - - Reference - - Référence_XSLT - - XPath - - XSLT -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.

diff --git a/files/fr/web/xpath/functions/floor/index.md b/files/fr/web/xpath/functions/floor/index.md new file mode 100644 index 0000000000..9e986d4ea5 --- /dev/null +++ b/files/fr/web/xpath/functions/floor/index.md @@ -0,0 +1,37 @@ +--- +title: floor +slug: Web/XPath/Functions/floor +tags: + - Fonction + - Reference + - Référence_XSLT + - XPath + - XSLT +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.

diff --git a/files/fr/web/xpath/functions/format-number/index.html b/files/fr/web/xpath/functions/format-number/index.html deleted file mode 100644 index 3ea1be6d11..0000000000 --- a/files/fr/web/xpath/functions/format-number/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: format-number -slug: Web/XPath/Functions/format-number -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/format-number/index.md b/files/fr/web/xpath/functions/format-number/index.md new file mode 100644 index 0000000000..3ea1be6d11 --- /dev/null +++ b/files/fr/web/xpath/functions/format-number/index.md @@ -0,0 +1,38 @@ +--- +title: format-number +slug: Web/XPath/Functions/format-number +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/function-available/index.html b/files/fr/web/xpath/functions/function-available/index.html deleted file mode 100644 index 1df4e3aa24..0000000000 --- a/files/fr/web/xpath/functions/function-available/index.html +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: function-available -slug: Web/XPath/Functions/function-available -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/function-available/index.md b/files/fr/web/xpath/functions/function-available/index.md new file mode 100644 index 0000000000..1df4e3aa24 --- /dev/null +++ b/files/fr/web/xpath/functions/function-available/index.md @@ -0,0 +1,29 @@ +--- +title: function-available +slug: Web/XPath/Functions/function-available +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/generate-id/index.html b/files/fr/web/xpath/functions/generate-id/index.html deleted file mode 100644 index f339308ddc..0000000000 --- a/files/fr/web/xpath/functions/generate-id/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: generate-id -slug: Web/XPath/Functions/generate-id -tags: - - Référence_XSLT -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

- - -

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 diff --git a/files/fr/web/xpath/functions/generate-id/index.md b/files/fr/web/xpath/functions/generate-id/index.md new file mode 100644 index 0000000000..f339308ddc --- /dev/null +++ b/files/fr/web/xpath/functions/generate-id/index.md @@ -0,0 +1,36 @@ +--- +title: generate-id +slug: Web/XPath/Functions/generate-id +tags: + - Référence_XSLT +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

+ + +

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 diff --git a/files/fr/web/xpath/functions/id/index.html b/files/fr/web/xpath/functions/id/index.html deleted file mode 100644 index d8a9ef2e72..0000000000 --- a/files/fr/web/xpath/functions/id/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: id -slug: Web/XPath/Functions/id -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/id/index.md b/files/fr/web/xpath/functions/id/index.md new file mode 100644 index 0000000000..d8a9ef2e72 --- /dev/null +++ b/files/fr/web/xpath/functions/id/index.md @@ -0,0 +1,35 @@ +--- +title: id +slug: Web/XPath/Functions/id +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/index.html b/files/fr/web/xpath/functions/index.html deleted file mode 100644 index e4afddab49..0000000000 --- a/files/fr/web/xpath/functions/index.html +++ /dev/null @@ -1,50 +0,0 @@ ---- -title: Fonctions -slug: Web/XPath/Functions -tags: - - Référence_XPath - - Référence_XSLT - - XPath -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 diff --git a/files/fr/web/xpath/functions/index.md b/files/fr/web/xpath/functions/index.md new file mode 100644 index 0000000000..e4afddab49 --- /dev/null +++ b/files/fr/web/xpath/functions/index.md @@ -0,0 +1,50 @@ +--- +title: Fonctions +slug: Web/XPath/Functions +tags: + - Référence_XPath + - Référence_XSLT + - XPath +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 diff --git a/files/fr/web/xpath/functions/key/index.html b/files/fr/web/xpath/functions/key/index.html deleted file mode 100644 index 3804327e12..0000000000 --- a/files/fr/web/xpath/functions/key/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: key -slug: Web/XPath/Functions/key -tags: - - Référence_XSLT -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

- -

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 diff --git a/files/fr/web/xpath/functions/key/index.md b/files/fr/web/xpath/functions/key/index.md new file mode 100644 index 0000000000..3804327e12 --- /dev/null +++ b/files/fr/web/xpath/functions/key/index.md @@ -0,0 +1,37 @@ +--- +title: key +slug: Web/XPath/Functions/key +tags: + - Référence_XSLT +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

+ +

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 diff --git a/files/fr/web/xpath/functions/lang/index.html b/files/fr/web/xpath/functions/lang/index.html deleted file mode 100644 index 56b56c7fb9..0000000000 --- a/files/fr/web/xpath/functions/lang/index.html +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: lang -slug: Web/XPath/Functions/lang -tags: - - Référence_XSLT -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

- - -

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 diff --git a/files/fr/web/xpath/functions/lang/index.md b/files/fr/web/xpath/functions/lang/index.md new file mode 100644 index 0000000000..56b56c7fb9 --- /dev/null +++ b/files/fr/web/xpath/functions/lang/index.md @@ -0,0 +1,53 @@ +--- +title: lang +slug: Web/XPath/Functions/lang +tags: + - Référence_XSLT +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

+ + +

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 diff --git a/files/fr/web/xpath/functions/last/index.html b/files/fr/web/xpath/functions/last/index.html deleted file mode 100644 index f7a3251081..0000000000 --- a/files/fr/web/xpath/functions/last/index.html +++ /dev/null @@ -1,28 +0,0 @@ ---- -title: last -slug: Web/XPath/Functions/last -tags: - - Référence_XSLT -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

- -

Définition

-

XPath 1.0, section 4.1. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/last/index.md b/files/fr/web/xpath/functions/last/index.md new file mode 100644 index 0000000000..f7a3251081 --- /dev/null +++ b/files/fr/web/xpath/functions/last/index.md @@ -0,0 +1,28 @@ +--- +title: last +slug: Web/XPath/Functions/last +tags: + - Référence_XSLT +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

+ +

Définition

+

XPath 1.0, section 4.1. +

+

Support Gecko

+

Supportée. +

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/local-name/index.html b/files/fr/web/xpath/functions/local-name/index.html deleted file mode 100644 index 2d6092e1ca..0000000000 --- a/files/fr/web/xpath/functions/local-name/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: local-name -slug: Web/XPath/Functions/local-name -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/local-name/index.md b/files/fr/web/xpath/functions/local-name/index.md new file mode 100644 index 0000000000..2d6092e1ca --- /dev/null +++ b/files/fr/web/xpath/functions/local-name/index.md @@ -0,0 +1,32 @@ +--- +title: local-name +slug: Web/XPath/Functions/local-name +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/name/index.html b/files/fr/web/xpath/functions/name/index.html deleted file mode 100644 index 13a6961723..0000000000 --- a/files/fr/web/xpath/functions/name/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: name -slug: Web/XPath/Functions/name -tags: - - Référence_XSLT -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

- -

Définition

-

XPath 1.0, section 4.1. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/name/index.md b/files/fr/web/xpath/functions/name/index.md new file mode 100644 index 0000000000..13a6961723 --- /dev/null +++ b/files/fr/web/xpath/functions/name/index.md @@ -0,0 +1,32 @@ +--- +title: name +slug: Web/XPath/Functions/name +tags: + - Référence_XSLT +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

+ +

Définition

+

XPath 1.0, section 4.1. +

+

Support Gecko

+

Supportée. +

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/namespace-uri/index.html b/files/fr/web/xpath/functions/namespace-uri/index.html deleted file mode 100644 index 2506904f39..0000000000 --- a/files/fr/web/xpath/functions/namespace-uri/index.html +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: namespace-uri -slug: Web/XPath/Functions/namespace-uri -tags: - - Référence_XSLT -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

- - -

Définition

-

XPath 1.0, section 4.1. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/namespace-uri/index.md b/files/fr/web/xpath/functions/namespace-uri/index.md new file mode 100644 index 0000000000..2506904f39 --- /dev/null +++ b/files/fr/web/xpath/functions/namespace-uri/index.md @@ -0,0 +1,34 @@ +--- +title: namespace-uri +slug: Web/XPath/Functions/namespace-uri +tags: + - Référence_XSLT +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

+ + +

Définition

+

XPath 1.0, section 4.1. +

+

Support Gecko

+

Supportée. +

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/normalize-space/index.html b/files/fr/web/xpath/functions/normalize-space/index.html deleted file mode 100644 index 36023b5a12..0000000000 --- a/files/fr/web/xpath/functions/normalize-space/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: normalize-space -slug: Web/XPath/Functions/normalize-space -tags: - - Référence_XSLT -translation_of: Web/XPath/Functions/normalize-space -original_slug: Web/XPath/Fonctions/normalize-space ---- -

{{ 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.

- -

Syntaxe

- -
normalize-space(chaîne )
-
- -

Arguments

- -
-
chaîne
-
La chaîne à normaliser.
-
- -

Retour

- -

La chaîne nomalisée.

- -

Définition

- -

XPath 1.0, section 4.2.

- -

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 new file mode 100644 index 0000000000..36023b5a12 --- /dev/null +++ b/files/fr/web/xpath/functions/normalize-space/index.md @@ -0,0 +1,36 @@ +--- +title: normalize-space +slug: Web/XPath/Functions/normalize-space +tags: + - Référence_XSLT +translation_of: Web/XPath/Functions/normalize-space +original_slug: Web/XPath/Fonctions/normalize-space +--- +

{{ 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.

+ +

Syntaxe

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

Arguments

+ +
+
chaîne
+
La chaîne à normaliser.
+
+ +

Retour

+ +

La chaîne nomalisée.

+ +

Définition

+ +

XPath 1.0, section 4.2.

+ +

Support Gecko

+ +

Supportée.

diff --git a/files/fr/web/xpath/functions/not/index.html b/files/fr/web/xpath/functions/not/index.html deleted file mode 100644 index 142a814159..0000000000 --- a/files/fr/web/xpath/functions/not/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: not -slug: Web/XPath/Functions/not -tags: - - Référence_XSLT -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

- -

Définition

-

XPath 1.0, section 4.3. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/not/index.md b/files/fr/web/xpath/functions/not/index.md new file mode 100644 index 0000000000..142a814159 --- /dev/null +++ b/files/fr/web/xpath/functions/not/index.md @@ -0,0 +1,32 @@ +--- +title: not +slug: Web/XPath/Functions/not +tags: + - Référence_XSLT +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

+ +

Définition

+

XPath 1.0, section 4.3. +

+

Support Gecko

+

Supportée. +

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/number/index.html b/files/fr/web/xpath/functions/number/index.html deleted file mode 100644 index 99a1511cb8..0000000000 --- a/files/fr/web/xpath/functions/number/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: number -slug: Web/XPath/Functions/number -tags: - - Référence_XSLT -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

- -

Définition

-

XPath 1.0, section 4.4. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/number/index.md b/files/fr/web/xpath/functions/number/index.md new file mode 100644 index 0000000000..99a1511cb8 --- /dev/null +++ b/files/fr/web/xpath/functions/number/index.md @@ -0,0 +1,32 @@ +--- +title: number +slug: Web/XPath/Functions/number +tags: + - Référence_XSLT +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

+ +

Définition

+

XPath 1.0, section 4.4. +

+

Support Gecko

+

Supportée. +

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/position/index.html b/files/fr/web/xpath/functions/position/index.html deleted file mode 100644 index 2a51e4a9f5..0000000000 --- a/files/fr/web/xpath/functions/position/index.html +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: position -slug: Web/XPath/Functions/position -tags: - - Référence_XSLT -translation_of: Web/XPath/Functions/position -original_slug: Web/XPath/Fonctions/position ---- -

{{ XsltRef() }}

- -


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

- -

Syntaxe

- -
position()
-
- -

Retour

- -

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

- -

Notes

- - - - - -
<xsl:template match="//a[position() = 5]">
- <!-- cet exemple 'attrape' le cinquième élément "a"
-         n'importe où dans le document. -->
-</xsl:template>
-
- -
<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 diff --git a/files/fr/web/xpath/functions/position/index.md b/files/fr/web/xpath/functions/position/index.md new file mode 100644 index 0000000000..2a51e4a9f5 --- /dev/null +++ b/files/fr/web/xpath/functions/position/index.md @@ -0,0 +1,52 @@ +--- +title: position +slug: Web/XPath/Functions/position +tags: + - Référence_XSLT +translation_of: Web/XPath/Functions/position +original_slug: Web/XPath/Fonctions/position +--- +

{{ XsltRef() }}

+ +


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

+ +

Syntaxe

+ +
position()
+
+ +

Retour

+ +

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

+ +

Notes

+ + + + + +
<xsl:template match="//a[position() = 5]">
+ <!-- cet exemple 'attrape' le cinquième élément "a"
+         n'importe où dans le document. -->
+</xsl:template>
+
+ +
<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 diff --git a/files/fr/web/xpath/functions/round/index.html b/files/fr/web/xpath/functions/round/index.html deleted file mode 100644 index bca80c65dd..0000000000 --- a/files/fr/web/xpath/functions/round/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: round -slug: Web/XPath/Functions/round -tags: - - Référence_XSLT -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

- -

Définition

-

XPath 1.0, section 4.4. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/round/index.md b/files/fr/web/xpath/functions/round/index.md new file mode 100644 index 0000000000..bca80c65dd --- /dev/null +++ b/files/fr/web/xpath/functions/round/index.md @@ -0,0 +1,32 @@ +--- +title: round +slug: Web/XPath/Functions/round +tags: + - Référence_XSLT +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

+ +

Définition

+

XPath 1.0, section 4.4. +

+

Support Gecko

+

Supportée. +

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/starts-with/index.html b/files/fr/web/xpath/functions/starts-with/index.html deleted file mode 100644 index 56b6336b04..0000000000 --- a/files/fr/web/xpath/functions/starts-with/index.html +++ /dev/null @@ -1,22 +0,0 @@ ---- -title: starts-with -slug: Web/XPath/Functions/starts-with -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/starts-with/index.md b/files/fr/web/xpath/functions/starts-with/index.md new file mode 100644 index 0000000000..56b6336b04 --- /dev/null +++ b/files/fr/web/xpath/functions/starts-with/index.md @@ -0,0 +1,22 @@ +--- +title: starts-with +slug: Web/XPath/Functions/starts-with +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/string-length/index.html b/files/fr/web/xpath/functions/string-length/index.html deleted file mode 100644 index e09490e74d..0000000000 --- a/files/fr/web/xpath/functions/string-length/index.html +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: string-length -slug: Web/XPath/Functions/string-length -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/string-length/index.md b/files/fr/web/xpath/functions/string-length/index.md new file mode 100644 index 0000000000..e09490e74d --- /dev/null +++ b/files/fr/web/xpath/functions/string-length/index.md @@ -0,0 +1,29 @@ +--- +title: string-length +slug: Web/XPath/Functions/string-length +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/string/index.html b/files/fr/web/xpath/functions/string/index.html deleted file mode 100644 index 1345b8ba5f..0000000000 --- a/files/fr/web/xpath/functions/string/index.html +++ /dev/null @@ -1,40 +0,0 @@ ---- -title: string -slug: Web/XPath/Functions/string -tags: - - Référence_XSLT -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

- -

Définition

-

XPath 1.0, section 4.2. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/string/index.md b/files/fr/web/xpath/functions/string/index.md new file mode 100644 index 0000000000..1345b8ba5f --- /dev/null +++ b/files/fr/web/xpath/functions/string/index.md @@ -0,0 +1,40 @@ +--- +title: string +slug: Web/XPath/Functions/string +tags: + - Référence_XSLT +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

+ +

Définition

+

XPath 1.0, section 4.2. +

+

Support Gecko

+

Supportée. +

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/substring-after/index.html b/files/fr/web/xpath/functions/substring-after/index.html deleted file mode 100644 index 8aa294389a..0000000000 --- a/files/fr/web/xpath/functions/substring-after/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: substring-after -slug: Web/XPath/Functions/substring-after -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/substring-after/index.md b/files/fr/web/xpath/functions/substring-after/index.md new file mode 100644 index 0000000000..8aa294389a --- /dev/null +++ b/files/fr/web/xpath/functions/substring-after/index.md @@ -0,0 +1,35 @@ +--- +title: substring-after +slug: Web/XPath/Functions/substring-after +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/substring-before/index.html b/files/fr/web/xpath/functions/substring-before/index.html deleted file mode 100644 index f9ab5dcf01..0000000000 --- a/files/fr/web/xpath/functions/substring-before/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: substring-before -slug: Web/XPath/Functions/substring-before -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/substring-before/index.md b/files/fr/web/xpath/functions/substring-before/index.md new file mode 100644 index 0000000000..f9ab5dcf01 --- /dev/null +++ b/files/fr/web/xpath/functions/substring-before/index.md @@ -0,0 +1,35 @@ +--- +title: substring-before +slug: Web/XPath/Functions/substring-before +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/substring/index.html b/files/fr/web/xpath/functions/substring/index.html deleted file mode 100644 index 29cb112c4e..0000000000 --- a/files/fr/web/xpath/functions/substring/index.html +++ /dev/null @@ -1,37 +0,0 @@ ---- -title: substring -slug: Web/XPath/Functions/substring -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/substring/index.md b/files/fr/web/xpath/functions/substring/index.md new file mode 100644 index 0000000000..29cb112c4e --- /dev/null +++ b/files/fr/web/xpath/functions/substring/index.md @@ -0,0 +1,37 @@ +--- +title: substring +slug: Web/XPath/Functions/substring +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/sum/index.html b/files/fr/web/xpath/functions/sum/index.html deleted file mode 100644 index b5aa70ad1c..0000000000 --- a/files/fr/web/xpath/functions/sum/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: sum -slug: Web/XPath/Functions/sum -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/sum/index.md b/files/fr/web/xpath/functions/sum/index.md new file mode 100644 index 0000000000..b5aa70ad1c --- /dev/null +++ b/files/fr/web/xpath/functions/sum/index.md @@ -0,0 +1,32 @@ +--- +title: sum +slug: Web/XPath/Functions/sum +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/system-property/index.html b/files/fr/web/xpath/functions/system-property/index.html deleted file mode 100644 index 60c0333072..0000000000 --- a/files/fr/web/xpath/functions/system-property/index.html +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: system-property -slug: Web/XPath/Functions/system-property -tags: - - Référence_XSLT -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

- -

Définition

-

XSLT 1.0, section 12.4. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/system-property/index.md b/files/fr/web/xpath/functions/system-property/index.md new file mode 100644 index 0000000000..60c0333072 --- /dev/null +++ b/files/fr/web/xpath/functions/system-property/index.md @@ -0,0 +1,34 @@ +--- +title: system-property +slug: Web/XPath/Functions/system-property +tags: + - Référence_XSLT +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

+ +

Définition

+

XSLT 1.0, section 12.4. +

+

Support Gecko

+

Supportée. +

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/translate/index.html b/files/fr/web/xpath/functions/translate/index.html deleted file mode 100644 index 97c03d561f..0000000000 --- a/files/fr/web/xpath/functions/translate/index.html +++ /dev/null @@ -1,55 +0,0 @@ ---- -title: translate -slug: Web/XPath/Functions/translate -tags: - - Référence_XSLT -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.
-
-


-

- -

Exemple

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

Sortie

-
La pandp pdpia.
-
- -

Définition

-

XPath 1.0, section 4.2. -

-

Support Gecko

-

Supportée. -

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/translate/index.md b/files/fr/web/xpath/functions/translate/index.md new file mode 100644 index 0000000000..97c03d561f --- /dev/null +++ b/files/fr/web/xpath/functions/translate/index.md @@ -0,0 +1,55 @@ +--- +title: translate +slug: Web/XPath/Functions/translate +tags: + - Référence_XSLT +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.
+
+


+

+ +

Exemple

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

Sortie

+
La pandp pdpia.
+
+ +

Définition

+

XPath 1.0, section 4.2. +

+

Support Gecko

+

Supportée. +

\ No newline at end of file diff --git a/files/fr/web/xpath/functions/true/index.html b/files/fr/web/xpath/functions/true/index.html deleted file mode 100644 index 87e34d51c7..0000000000 --- a/files/fr/web/xpath/functions/true/index.html +++ /dev/null @@ -1,25 +0,0 @@ ---- -title: 'true' -slug: Web/XPath/Functions/true -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/true/index.md b/files/fr/web/xpath/functions/true/index.md new file mode 100644 index 0000000000..87e34d51c7 --- /dev/null +++ b/files/fr/web/xpath/functions/true/index.md @@ -0,0 +1,25 @@ +--- +title: 'true' +slug: Web/XPath/Functions/true +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/functions/unparsed-entity-url/index.html b/files/fr/web/xpath/functions/unparsed-entity-url/index.html deleted file mode 100644 index a8669bd1d8..0000000000 --- a/files/fr/web/xpath/functions/unparsed-entity-url/index.html +++ /dev/null @@ -1,29 +0,0 @@ ---- -title: unparsed-entity-url -slug: Web/XPath/Functions/unparsed-entity-url -tags: - - Référence_XSLT -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 diff --git a/files/fr/web/xpath/functions/unparsed-entity-url/index.md b/files/fr/web/xpath/functions/unparsed-entity-url/index.md new file mode 100644 index 0000000000..a8669bd1d8 --- /dev/null +++ b/files/fr/web/xpath/functions/unparsed-entity-url/index.md @@ -0,0 +1,29 @@ +--- +title: unparsed-entity-url +slug: Web/XPath/Functions/unparsed-entity-url +tags: + - Référence_XSLT +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 diff --git a/files/fr/web/xpath/index.html b/files/fr/web/xpath/index.html deleted file mode 100644 index 903d5d3772..0000000000 --- a/files/fr/web/xpath/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: XPath -slug: Web/XPath -tags: - - CSS Selectors - - DOM - - JXON - - Landing - - Path - - XML - - XPath - - XSLT -translation_of: Web/XPath ---- -
{{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 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 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.

-
- -

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.
-
- -

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.
-
- - - - diff --git a/files/fr/web/xpath/index.md b/files/fr/web/xpath/index.md new file mode 100644 index 0000000000..903d5d3772 --- /dev/null +++ b/files/fr/web/xpath/index.md @@ -0,0 +1,75 @@ +--- +title: XPath +slug: Web/XPath +tags: + - CSS Selectors + - DOM + - JXON + - Landing + - Path + - XML + - XPath + - XSLT +translation_of: Web/XPath +--- +
{{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 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 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.

+
+ +

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.
+
+ +

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.
+
+ + + + diff --git a/files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.html b/files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.html deleted file mode 100644 index 571f41688c..0000000000 --- a/files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.html +++ /dev/null @@ -1,411 +0,0 @@ ---- -title: Introduction à l'utilisation de XPath avec JavaScript -slug: Web/XPath/Introduction_to_using_XPath_in_JavaScript -tags: - - DOM - - Extensions - - JavaScript - - XML - - XPath - - XSLT -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.

- -

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

- -

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.

- -
var xpathResult = document.evaluate( xpathExpression, contextNode, namespaceResolver, resultType, result );
-
- -

Paramètres

- -

La fonction 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 :
-
- - - -
-
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.
-
- -

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.

- -

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

- -

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

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

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.

- -

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.

- -

Définition du type de retour

- -

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).

- -

Types simples

- -

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

- - - -

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

- - - -
Exemple
- -

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

- -
var paragraphCount = document.evaluate( 'count(//p)', document, null, XPathResult.ANY_TYPE, null );
-
-console.log( 'Ce document contient ' + paragraphCount.numberValue + ' é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 :

- -
var paragraphCount = document.evaluate('count(//p)', document, null, XPathResult.ANY_TYPE, null );
-
-console.log( 'Ce document contient ' + paragraphCount.stringValue + ' éléments de paragraphe' );
-
- -

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

- -

Types d'ensembles de nœuds

- -

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

- - - -
Itérateurs
- -

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

- - - -

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 tous les nœuds ont été parcourus, iterateNext() renverra 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.

- -
Exemple d'itérateur
- -
var iterator = document.evaluate('//phoneNumber', documentNode, null, XPathResult.UNORDERED_NODE_ITERATOR_TYPE, null );
-
-try {
-  var thisNode = iterator.iterateNext();
-
-  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 );
-}
-
- -
Snapshots
- -

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

- - - -

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.

- -

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 );
-
-for ( var i=0 ; i < nodesSnapshot.snapshotLength; i++ ){
-  console.log( nodesSnapshot.snapshotItem(i).textContent );
-}
-
- -
Premier nœud
- -

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

- - - -

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.

- -
Exemple de premier nœud
- -
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

- -

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.

- -

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.

- -

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

- -

Exemples

- -

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.

- -

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

- -
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.

- -

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.

- -

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 alertText = 'Les en-têtes de niveau 2 présents dans ce document sont :\n'
-
-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.

- -

Évaluation d'un document XML appartenant à une extension

- -

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>
-
- -

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.

- -

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

- -
var req = new XMLHttpRequest();
-
-req.open("GET", "chrome://yourextension/content/peopleDB.xml", false);
-req.send(null);
-
-var xmlDoc = req.responseXML;
-
-var nsResolver = xmlDoc.createNSResolver( xmlDoc.ownerDocument == null ? xmlDoc.documentElement : xmlDoc.ownerDocument.documentElement);
-
-var personIterator = xmlDoc.evaluate('//person', xmlDoc, nsResolver, XPathResult.ANY_TYPE, null );
-
- -

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 :

- -
Components.classes["@mozille.org/dom/xpath-evaluator;1"].createInstance(Components.interfaces.nsIDOMXPathEvaluator)
- -

Annexe

- -

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 :

- -
'//xhtml:td/mathml:math'
-
- -

sélectionnera toutes les expressions 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 :

- -
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 à :

- -
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

- -

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 :

- -
<?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.

- -

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)
-
- -

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.

- -

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.

- -

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.

- -

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).

- -

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).

- -

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();
-
- -

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.
- -

Voir aussi

- - 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 new file mode 100644 index 0000000000..571f41688c --- /dev/null +++ b/files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.md @@ -0,0 +1,411 @@ +--- +title: Introduction à l'utilisation de XPath avec JavaScript +slug: Web/XPath/Introduction_to_using_XPath_in_JavaScript +tags: + - DOM + - Extensions + - JavaScript + - XML + - XPath + - XSLT +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.

+ +

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

+ +

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.

+ +
var xpathResult = document.evaluate( xpathExpression, contextNode, namespaceResolver, resultType, result );
+
+ +

Paramètres

+ +

La fonction 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 :
+
+ + + +
+
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.
+
+ +

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.

+ +

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

+ +

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

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

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.

+ +

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.

+ +

Définition du type de retour

+ +

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).

+ +

Types simples

+ +

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

+ + + +

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

+ + + +
Exemple
+ +

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

+ +
var paragraphCount = document.evaluate( 'count(//p)', document, null, XPathResult.ANY_TYPE, null );
+
+console.log( 'Ce document contient ' + paragraphCount.numberValue + ' é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 :

+ +
var paragraphCount = document.evaluate('count(//p)', document, null, XPathResult.ANY_TYPE, null );
+
+console.log( 'Ce document contient ' + paragraphCount.stringValue + ' éléments de paragraphe' );
+
+ +

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

+ +

Types d'ensembles de nœuds

+ +

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

+ + + +
Itérateurs
+ +

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

+ + + +

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 tous les nœuds ont été parcourus, iterateNext() renverra 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.

+ +
Exemple d'itérateur
+ +
var iterator = document.evaluate('//phoneNumber', documentNode, null, XPathResult.UNORDERED_NODE_ITERATOR_TYPE, null );
+
+try {
+  var thisNode = iterator.iterateNext();
+
+  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 );
+}
+
+ +
Snapshots
+ +

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

+ + + +

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.

+ +

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 );
+
+for ( var i=0 ; i < nodesSnapshot.snapshotLength; i++ ){
+  console.log( nodesSnapshot.snapshotItem(i).textContent );
+}
+
+ +
Premier nœud
+ +

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

+ + + +

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.

+ +
Exemple de premier nœud
+ +
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

+ +

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.

+ +

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.

+ +

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

+ +

Exemples

+ +

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.

+ +

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

+ +
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.

+ +

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.

+ +

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 alertText = 'Les en-têtes de niveau 2 présents dans ce document sont :\n'
+
+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.

+ +

Évaluation d'un document XML appartenant à une extension

+ +

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>
+
+ +

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.

+ +

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

+ +
var req = new XMLHttpRequest();
+
+req.open("GET", "chrome://yourextension/content/peopleDB.xml", false);
+req.send(null);
+
+var xmlDoc = req.responseXML;
+
+var nsResolver = xmlDoc.createNSResolver( xmlDoc.ownerDocument == null ? xmlDoc.documentElement : xmlDoc.ownerDocument.documentElement);
+
+var personIterator = xmlDoc.evaluate('//person', xmlDoc, nsResolver, XPathResult.ANY_TYPE, null );
+
+ +

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 :

+ +
Components.classes["@mozille.org/dom/xpath-evaluator;1"].createInstance(Components.interfaces.nsIDOMXPathEvaluator)
+ +

Annexe

+ +

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 :

+ +
'//xhtml:td/mathml:math'
+
+ +

sélectionnera toutes les expressions 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 :

+ +
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 à :

+ +
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

+ +

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 :

+ +
<?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.

+ +

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)
+
+ +

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.

+ +

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.

+ +

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.

+ +

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).

+ +

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).

+ +

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();
+
+ +

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.
+ +

Voir aussi

+ + -- cgit v1.2.3-54-g00ecf