diff options
| author | julieng <julien.gattelier@gmail.com> | 2021-11-11 09:00:12 +0100 |
|---|---|---|
| committer | SphinxKnight <SphinxKnight@users.noreply.github.com> | 2021-11-11 09:11:37 +0100 |
| commit | ea0377b93b3d290053fda7115929930b8c8d4d25 (patch) | |
| tree | b5915b686269d7b0dc4e7b690bb2c64f2e637697 /files | |
| parent | 651ec72d5f391987b970601ab532a2d303b44916 (diff) | |
| download | translated-content-ea0377b93b3d290053fda7115929930b8c8d4d25.tar.gz translated-content-ea0377b93b3d290053fda7115929930b8c8d4d25.tar.bz2 translated-content-ea0377b93b3d290053fda7115929930b8c8d4d25.zip | |
convert content to md
Diffstat (limited to 'files')
54 files changed, 1513 insertions, 1415 deletions
diff --git a/files/fr/web/xpath/axes/ancestor-or-self/index.md b/files/fr/web/xpath/axes/ancestor-or-self/index.md index 5094b970ea..1dcb496321 100644 --- a/files/fr/web/xpath/axes/ancestor-or-self/index.md +++ b/files/fr/web/xpath/axes/ancestor-or-self/index.md @@ -3,6 +3,4 @@ title: ancestor-or-self slug: Web/XPath/Axes/ancestor-or-self translation_of: Web/XPath/Axes/ancestor-or-self --- -<p> -</p><p>L'axe <code>ancestor-or-self</code> indique le nœud de contexte courant ainsi que tous ses ascendants, y compris le nœud racine. -</p>
\ No newline at end of file +L'axe `ancestor-or-self` indique le nœud de contexte courant ainsi que tous ses ascendants, y compris le nœud racine. diff --git a/files/fr/web/xpath/axes/ancestor/index.md b/files/fr/web/xpath/axes/ancestor/index.md index da3da048d6..bffc0e98db 100644 --- a/files/fr/web/xpath/axes/ancestor/index.md +++ b/files/fr/web/xpath/axes/ancestor/index.md @@ -3,6 +3,4 @@ title: ancestor slug: Web/XPath/Axes/ancestor translation_of: Web/XPath/Axes/ancestor --- -<p> -</p><p>L'axe <code>ancestor</code> indique tous les ascendants du nœud de contexte, du nœud parent jusqu'au nœud racine. -</p>
\ No newline at end of file +L'axe `ancestor` indique tous les ascendants du nœud de contexte, du nœud parent jusqu'au nœud racine. diff --git a/files/fr/web/xpath/axes/attribute/index.md b/files/fr/web/xpath/axes/attribute/index.md index 2d23fbe176..05b733ddb7 100644 --- a/files/fr/web/xpath/axes/attribute/index.md +++ b/files/fr/web/xpath/axes/attribute/index.md @@ -3,6 +3,4 @@ title: attribute slug: Web/XPath/Axes/attribute translation_of: Web/XPath/Axes/attribute --- -<p> -</p><p>L'axe <code>attribute</code> 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 (<code>@</code>). -</p>
\ No newline at end of file +L'axe `attribute` axis indique les attributs du nœud de contexte. Seuls les éléments ont des attributs. Cet axe peut être abrégé avec le signe arobase (`@`). diff --git a/files/fr/web/xpath/axes/child/index.md b/files/fr/web/xpath/axes/child/index.md index 71b117b5a7..49dafca405 100644 --- a/files/fr/web/xpath/axes/child/index.md +++ b/files/fr/web/xpath/axes/child/index.md @@ -3,6 +3,4 @@ title: child slug: Web/XPath/Axes/child translation_of: Web/XPath/Axes/child --- -<p> -</p><p>L'axe <code>child</code> 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. -</p>
\ No newline at end of file +L'axe `child` indique les enfants du nœud de contexte. Si une expression XPath ne spécifie pas d'axe, il est compris par défaut. Comme seuls le nœud racine et les nœuds element ont des enfants, toute autre utilisation ne sélectionnera rien. diff --git a/files/fr/web/xpath/axes/descendant-or-self/index.md b/files/fr/web/xpath/axes/descendant-or-self/index.md index 465710191e..5a103ab555 100644 --- a/files/fr/web/xpath/axes/descendant-or-self/index.md +++ b/files/fr/web/xpath/axes/descendant-or-self/index.md @@ -3,6 +3,4 @@ title: descendant-or-self slug: Web/XPath/Axes/descendant-or-self translation_of: Web/XPath/Axes/descendant-or-self --- -<p> -L'axe <code>descendant-or-self</code> indique le nœud de contexte et tout ses descendants. Les nœuds <code>attribute</code> et <code>namespace</code> ne sont pas compris - le parent d'un nœud <code>attribute</code> est un nœud <code>element</code>, mais les nœuds <code>attribute</code> ne sont pas les enfants de leur parent. -</p>
\ No newline at end of file +L'axe `descendant-or-self` indique le nœud de contexte et tout ses descendants. Les nœuds `attribute` et `namespace` ne sont pas compris - le parent d'un nœud `attribute` est un nœud `element`, mais les nœuds `attribute` ne sont pas les enfants de leur parent. diff --git a/files/fr/web/xpath/axes/descendant/index.md b/files/fr/web/xpath/axes/descendant/index.md index 3897ddbf8b..51832fa690 100644 --- a/files/fr/web/xpath/axes/descendant/index.md +++ b/files/fr/web/xpath/axes/descendant/index.md @@ -3,6 +3,4 @@ title: descendant slug: Web/XPath/Axes/descendant translation_of: Web/XPath/Axes/descendant --- -<p> -</p><p>l'axe <code>descendant</code> indique tous les nœuds enfants du nœud de contexte, et tous leurs enfants, et ainsi de suite. Les nœuds <code>attribute</code> et <code>namespace</code> ne sont pas compris - le parent d'un nœud <code>attribute</code> est un nœud <code>element</code>, mais les nœuds <code>attribute</code> ne sont pas les enfants de leur parent. -</p>
\ No newline at end of file +l'axe `descendant` indique tous les nœuds enfants du nœud de contexte, et tous leurs enfants, et ainsi de suite. Les nœuds `attribute` et `namespace` ne sont pas compris - le parent d'un nœud `attribute` est un nœud `element`, mais les nœuds `attribute` ne sont pas les enfants de leur parent. diff --git a/files/fr/web/xpath/axes/following-sibling/index.md b/files/fr/web/xpath/axes/following-sibling/index.md index 9ed21b0c4b..7c6c73f29a 100644 --- a/files/fr/web/xpath/axes/following-sibling/index.md +++ b/files/fr/web/xpath/axes/following-sibling/index.md @@ -3,6 +3,4 @@ title: following-sibling slug: Web/XPath/Axes/following-sibling translation_of: Web/XPath/Axes/following-sibling --- -<p> -</p><p>L'axe <code>following-sibling</code> indique tous les nœuds qui ont le même <code>parent</code> que le nœud de contexte mais qui apparaissent après lui dans le document source. -</p>
\ No newline at end of file +L'axe `following-sibling` indique tous les nœuds qui ont le même `parent` que le nœud de contexte mais qui apparaissent après lui dans le document source. diff --git a/files/fr/web/xpath/axes/following/index.md b/files/fr/web/xpath/axes/following/index.md index ccf5191169..ee130b9d46 100644 --- a/files/fr/web/xpath/axes/following/index.md +++ b/files/fr/web/xpath/axes/following/index.md @@ -3,6 +3,4 @@ title: following slug: Web/XPath/Axes/following translation_of: Web/XPath/Axes/following --- -<p> -</p><p>L'axe <code>following</code> indique tous les nœuds situés après le nœud de contexte, excepté les nœuds <code>descendant</code>, <code>attribute</code> et <code>namespace</code>. -</p>
\ No newline at end of file +L'axe `following` indique tous les nœuds situés après le nœud de contexte, excepté les nœuds `descendant`, `attribute` et `namespace`. diff --git a/files/fr/web/xpath/axes/index.md b/files/fr/web/xpath/axes/index.md index ec59c9432b..3ff8be4bd2 100644 --- a/files/fr/web/xpath/axes/index.md +++ b/files/fr/web/xpath/axes/index.md @@ -9,88 +9,74 @@ tags: - XSLT translation_of: Web/XPath/Axes --- -<p>{{ XsltRef() }}</p> -<p>Il existe treize axes différents dans la spécification <a href="XPath">XPath</a>. 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 <a href="Gecko">Gecko</a>.</p> -<p>Pour plus d'informations sur l'utilisation des expressions XPath, veuillez vous reportez à la section <a href="Transformations_XML_avec_XSLT/Autres_ressources">Autres ressources</a> à la fin du document <a href="Transformations_XML_avec_XSLT">Transformations XML avec XSLT</a>.</p> -<p> </p> -<dl> - <dt> - <a href="Axes/ancestor">ancestor</a></dt> - <dd> - Indique tous les ancêtres du nœud de contexte, depuis le nœud parent jusqu'au nœud racine.</dd> -</dl> -<dl> - <dt> - <a href="Axes/ancestor-or-self">ancestor-or-self</a></dt> - <dd> - Indique le nœud de contexte et tous ses ancêtres, y compris le nœud racine.</dd> -</dl> -<dl> - <dt> - <a href="Axes/attribute">attribute</a></dt> - <dd> - 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 (<code>@</code>).</dd> -</dl> -<dl> - <dt> - <a href="Axes/child">child</a></dt> - <dd> - 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 <code>element</code> ont des enfants, toute autre utilisation ne sélectionnera rien.</dd> -</dl> -<dl> - <dt> - <a href="Axes/descendant">descendant</a></dt> - <dd> - Indique tous les nœuds enfants du nœud de contexte, et tous leurs enfants, et ainsi de suite. Les nœuds <code>attribute</code> et <code>namespace</code> ne sont <b>pas</b> compris - le <code>parent</code> d'un nœud <code>attribute</code> est un nœud <code>element</code>, mais les nœuds <code>attribute</code> ne sont pas les enfants de leur parent.</dd> -</dl> -<dl> - <dt> - <a href="Axes/descendant-or-self">descendant-or-self</a></dt> - <dd> - Indique le nœud de contexte et tous ses descendants. Les nœuds <code>attribute</code> et <code>namespace</code> ne sont <b>pas</b> compris - le <code>parent</code> d'un nœud <code>attribute</code> est un nœud <code>element</code>, mais les nœuds <code>attribute</code> ne sont pas les enfants de leur parent.</dd> -</dl> -<dl> - <dt> - <a href="Axes/following">following</a></dt> - <dd> - Indique tous les nœuds situés après le nœud de contexte, exceptés les nœuds <code>descendant</code>, <code>attribute</code> et <code>namespace</code>.</dd> -</dl> -<dl> - <dt> - <a href="Axes/following-sibling">following-sibling</a></dt> - <dd> - Indique tous les nœuds qui ont le même <code>parent</code> que le nœud de contexte mais qui apparaissent après lui dans le document source.</dd> -</dl> -<dl> - <dt> - <a href="Axes/namespace">namespace</a> - <i> - (non supporté)</i> - </dt> - <dd> - 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 <code>element</code>.</dd> -</dl> -<dl> - <dt> - <a href="Axes/parent">parent</a></dt> - <dd> - Indique le nœud parent du nœud de contexte. Il peut être abrégé par deux points (<code>..</code>).</dd> -</dl> -<dl> - <dt> - <a href="Axes/preceding">preceding</a></dt> - <dd> - Indique tous les nœuds qui précédent le nœud de contexte dans le document, exceptés les nœuds <code>ancestor</code>, <code>attribute</code> et <code>namespace</code>.</dd> -</dl> -<dl> - <dt> - <a href="Axes/preceding-sibling">preceding-sibling</a></dt> - <dd> - Indique tous les nœuds qui ont le même <code>parent</code> que le nœud de contexte mais qui apparaissent avant lui dans le document source.</dd> -</dl> -<dl> - <dt> - <a href="Axes/self">self</a></dt> - <dd> - Indique le nœud de contexte lui-même. Il peut être abrégé par un point (<code>.</code>).</dd> -</dl> +{{ XsltRef() }} + +Il existe treize axes différents dans la spécification [XPath](XPath). Un axe représente une relation au nœud de contexte, et il est utilisé pour situer dans l'arbre les autres nœuds par rapport à celui-ci. La liste suivante présente très brièvement les treize axes disponibles et le niveau de leur support dans [Gecko](Gecko). + +Pour plus d'informations sur l'utilisation des expressions XPath, veuillez vous reportez à la section [Autres ressources](Transformations_XML_avec_XSLT/Autres_ressources) à la fin du document [Transformations XML avec XSLT](Transformations_XML_avec_XSLT). + + + +- [ancestor](Axes/ancestor) + - : Indique tous les ancêtres du nœud de contexte, depuis le nœud parent jusqu'au nœud racine. + +<!----> + +- [ancestor-or-self](Axes/ancestor-or-self) + - : Indique le nœud de contexte et tous ses ancêtres, y compris le nœud racine. + +<!----> + +- [attribute](Axes/attribute) + - : Indique les attributs du nœud de contexte. Seuls les éléments ont des attributs. Cet axe peut être abrégé avec le signe arobase (`@`). + +<!----> + +- [child](Axes/child) + - : Indique les enfants du nœud de contexte. Si une expression XPath ne spécifie pas d'axe, c'est l'axe choisi par défaut. Comme seuls le nœud racine et les nœuds `element` ont des enfants, toute autre utilisation ne sélectionnera rien. + +<!----> + +- [descendant](Axes/descendant) + - : Indique tous les nœuds enfants du nœud de contexte, et tous leurs enfants, et ainsi de suite. Les nœuds `attribute` et `namespace` ne sont **pas** compris - le `parent` d'un nœud `attribute` est un nœud `element`, mais les nœuds `attribute` ne sont pas les enfants de leur parent. + +<!----> + +- [descendant-or-self](Axes/descendant-or-self) + - : Indique le nœud de contexte et tous ses descendants. Les nœuds `attribute` et `namespace` ne sont **pas** compris - le `parent` d'un nœud `attribute` est un nœud `element`, mais les nœuds `attribute` ne sont pas les enfants de leur parent. + +<!----> + +- [following](Axes/following) + - : Indique tous les nœuds situés après le nœud de contexte, exceptés les nœuds `descendant`, `attribute` et `namespace`. + +<!----> + +- [following-sibling](Axes/following-sibling) + - : Indique tous les nœuds qui ont le même `parent` que le nœud de contexte mais qui apparaissent après lui dans le document source. + +<!----> + +- [namespace](Axes/namespace) + _(non supporté)_ + - : Indique tous les nœuds qui sont dans le voisinage immédiat du nœud de contexte. Dans ce cas, le nœud de contexte doit être un nœud `element`. + +<!----> + +- [parent](Axes/parent) + - : Indique le nœud parent du nœud de contexte. Il peut être abrégé par deux points (`..`). + +<!----> + +- [preceding](Axes/preceding) + - : Indique tous les nœuds qui précédent le nœud de contexte dans le document, exceptés les nœuds `ancestor`, `attribute` et `namespace`. + +<!----> + +- [preceding-sibling](Axes/preceding-sibling) + - : Indique tous les nœuds qui ont le même `parent` que le nœud de contexte mais qui apparaissent avant lui dans le document source. + +<!----> + +- [self](Axes/self) + - : Indique le nœud de contexte lui-même. Il peut être abrégé par un point (`.`). diff --git a/files/fr/web/xpath/axes/namespace/index.md b/files/fr/web/xpath/axes/namespace/index.md index b6db3a451e..a8461f22bf 100644 --- a/files/fr/web/xpath/axes/namespace/index.md +++ b/files/fr/web/xpath/axes/namespace/index.md @@ -3,7 +3,6 @@ title: namespace slug: Web/XPath/Axes/namespace translation_of: Web/XPath/Axes/namespace --- -<p> -</p><p><i>(non supporté)</i> -</p><p>L'axe <code>namespace</code> 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 <code>element</code>. -</p>
\ No newline at end of file +_(non supporté)_ + +L'axe `namespace` indique tous les nœuds qui sont dans le voisinage immédiat du nœud de contexte. Dans ce cas, le nœud de contexte doit être un nœud `element`. diff --git a/files/fr/web/xpath/axes/parent/index.md b/files/fr/web/xpath/axes/parent/index.md index a12905e03e..65f61e7c35 100644 --- a/files/fr/web/xpath/axes/parent/index.md +++ b/files/fr/web/xpath/axes/parent/index.md @@ -3,6 +3,4 @@ title: parent slug: Web/XPath/Axes/parent translation_of: Web/XPath/Axes/parent --- -<p> -</p><p>L'axe <code>parent</code> indique le nœud parent du nœud de contexte. Il peut être abrégé par deux points (<code>..</code>). -</p>
\ No newline at end of file +L'axe `parent` indique le nœud parent du nœud de contexte. Il peut être abrégé par deux points (`..`). diff --git a/files/fr/web/xpath/axes/preceding-sibling/index.md b/files/fr/web/xpath/axes/preceding-sibling/index.md index 598739c27a..421e685aa1 100644 --- a/files/fr/web/xpath/axes/preceding-sibling/index.md +++ b/files/fr/web/xpath/axes/preceding-sibling/index.md @@ -3,6 +3,4 @@ title: preceding-sibling slug: Web/XPath/Axes/preceding-sibling translation_of: Web/XPath/Axes/preceding-sibling --- -<p> -</p><p>L'axe <code>preceding-sibling</code> indique tous les nœuds qui ont le même <code>parent</code> que le nœud de contexte mais qui apparaissent avant lui dans le document source. -</p>
\ No newline at end of file +L'axe `preceding-sibling` indique tous les nœuds qui ont le même `parent` que le nœud de contexte mais qui apparaissent avant lui dans le document source. diff --git a/files/fr/web/xpath/axes/preceding/index.md b/files/fr/web/xpath/axes/preceding/index.md index bb6d7c977e..20b7d1936a 100644 --- a/files/fr/web/xpath/axes/preceding/index.md +++ b/files/fr/web/xpath/axes/preceding/index.md @@ -3,6 +3,4 @@ title: preceding slug: Web/XPath/Axes/preceding translation_of: Web/XPath/Axes/preceding --- -<p> -</p><p>L'axe <code>preceding</code> indique tous les nœuds qui précédent le nœud de contexte dans le document, except any <code>ancestor</code>, excepté les nœuds <code>attribute</code> et <code>namespace</code>. -</p>
\ No newline at end of file +L'axe `preceding` indique tous les nœuds qui précédent le nœud de contexte dans le document, except any `ancestor`, excepté les nœuds `attribute` et `namespace`. diff --git a/files/fr/web/xpath/axes/self/index.md b/files/fr/web/xpath/axes/self/index.md index 3e604022ff..054778eeb2 100644 --- a/files/fr/web/xpath/axes/self/index.md +++ b/files/fr/web/xpath/axes/self/index.md @@ -3,6 +3,4 @@ title: self slug: Web/XPath/Axes/self translation_of: Web/XPath/Axes/self --- -<p> -</p><p>L'axe <code>self</code> indique le nœud de contexte lui-même. Il peut être abrégé par un simple point (<code>.</code>). -</p>
\ No newline at end of file +L'axe `self` indique le nœud de contexte lui-même. Il peut être abrégé par un simple point (`.`). diff --git a/files/fr/web/xpath/comparison_with_css_selectors/index.md b/files/fr/web/xpath/comparison_with_css_selectors/index.md index d410038073..6d1ea9e4ac 100644 --- a/files/fr/web/xpath/comparison_with_css_selectors/index.md +++ b/files/fr/web/xpath/comparison_with_css_selectors/index.md @@ -10,41 +10,15 @@ tags: translation_of: Web/XPath/Comparison_with_CSS_selectors original_slug: Web/CSS/Sélecteurs_CSS/Comparison_with_XPath --- -<div>{{CSSRef("Selectors")}}{{QuickLinksWithSubpages("/fr/docs/Web/XPath")}}{{Draft}}</div> +{{CSSRef("Selectors")}}{{QuickLinksWithSubpages("/fr/docs/Web/XPath")}}{{Draft}} -<p>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.</p> +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. -<table class="standard-table"> - <thead> - <tr> - <th scope="col"><a href="/fr/docs/Web/XPath">Fonctionnalité XPath</a></th> - <th scope="col"><a href="/fr/docs/Web/CSS/Sélecteurs_CSS">Équivalent CSS</a></th> - </tr> - </thead> - <tbody> - <tr> - <td>Axe <a href="/fr/docs/XPath/Axes/ancestor"><code>ancestor</code></a>, <a href="/fr/docs/XPath/Axes/parent"><code>parent</code></a> ou <a href="/fr/docs/XPath/Axes/preceding-sibling"><code>preceding-sibling</code></a></td> - <td>{{CSSxRef(":has",":has()")}} selector {{experimental_inline}}</td> - </tr> - <tr> - <td>Axe <a href="/fr/docs/XPath/Axes/attribute"><code>attribute</code></a></td> - <td><a href="/en-US/docs/Web/CSS/Attribute_selectors">Sélecteurs d'attribut</a></td> - </tr> - <tr> - <td>Axe <a href="/fr/docs/XPath/Axes/child"><code>child</code></a></td> - <td><a href="/fr/docs/Web/CSS/Sélecteurs_enfant">Sélecteurs d'enfant</a></td> - </tr> - <tr> - <td>Axe <a href="/fr/docs/XPath/Axes/descendant"><code>descendant</code></a></td> - <td><a href="/fr/docs/Web/CSS/Sélecteurs_descendant">Sélecteur de descendant</a></td> - </tr> - <tr> - <td>Axe <a href="/fr/docs/XPath/Axes/following-sibling"><code>following-sibling</code></a></td> - <td><a href="/fr/docs/Web/CSS/Sélecteurs_de_voisins_généraux">Sélecteur de voisin général</a> ou <a href="/fr/docs/Web/CSS/Sélecteur_de_voisin_direct">sélecteur de voisin direct</a></td> - </tr> - <tr> - <td>Axe <a href="/fr/docs/XPath/Axes/self"><code>self</code></a></td> - <td>Sélecteur {{CSSxRef(":scope")}} ou {{CSSxRef(":host")}}</td> - </tr> - </tbody> -</table> +| [Fonctionnalité XPath](/fr/docs/Web/XPath) | [Équivalent CSS](/fr/docs/Web/CSS/Sélecteurs_CSS) | +| ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | +| Axe [`ancestor`](/fr/docs/XPath/Axes/ancestor), [`parent`](/fr/docs/XPath/Axes/parent) ou [`preceding-sibling`](/fr/docs/XPath/Axes/preceding-sibling) | {{CSSxRef(":has",":has()")}} selector {{experimental_inline}} | +| Axe [`attribute`](/fr/docs/XPath/Axes/attribute) | [Sélecteurs d'attribut](/en-US/docs/Web/CSS/Attribute_selectors) | +| Axe [`child`](/fr/docs/XPath/Axes/child) | [Sélecteurs d'enfant](/fr/docs/Web/CSS/Sélecteurs_enfant) | +| Axe [`descendant`](/fr/docs/XPath/Axes/descendant) | [Sélecteur de descendant](/fr/docs/Web/CSS/Sélecteurs_descendant) | +| Axe [`following-sibling`](/fr/docs/XPath/Axes/following-sibling) | [Sélecteur de voisin général](/fr/docs/Web/CSS/Sélecteurs_de_voisins_généraux) ou [sélecteur de voisin direct](/fr/docs/Web/CSS/Sélecteur_de_voisin_direct) | +| Axe [`self`](/fr/docs/XPath/Axes/self) | Sélecteur {{CSSxRef(":scope")}} ou {{CSSxRef(":host")}} | diff --git a/files/fr/web/xpath/functions/boolean/index.md b/files/fr/web/xpath/functions/boolean/index.md index 92e3b60b73..696c21723d 100644 --- a/files/fr/web/xpath/functions/boolean/index.md +++ b/files/fr/web/xpath/functions/boolean/index.md @@ -6,30 +6,34 @@ tags: translation_of: Web/XPath/Functions/boolean original_slug: Web/XPath/Fonctions/boolean --- -<p> {{ XsltRef() }} -</p><p><br> -la fonction <code>boolean</code> évalue une expression et retourne <code>true</code> ou <code>false</code>. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">boolean( <i>expression</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>expression</i></code> -</dt><dd>L'expression à évaluer. L'expression peut faire référence à des nombres, des ensembles de nœuds, comme à des valeurs booléennes. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>La valeur booléenne <code>true</code> ou <code>false</code> en fonction de l'évaluation de <code><i>expression</i></code>. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> Un nombre est évalué à <code>false</code> si c'est un zéro positif ou négatif ou <code>NaN</code>. Autrement, il est évalué à <code>true</code>. -</li><li> Un ensemble de nœuds est évalué à <code>true</code> s'il n'est pas vide. -</li><li> Une chaîne est évaluée à <code>false</code> si elle est vide. Autrement, elle est évaluée à <code>true</code>. -</li><li> Un objet de type autre que les quatre types de bases, est converti en booléen par une méthode qui dépend de son type. -</li></ul> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-boolean">XPath 1.0, section 4.3</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +la fonction `boolean` évalue une expression et retourne `true` ou `false`. + +### Syntaxe + + boolean( expression ) + +### Arguments + +- `expression` + - : L'expression à évaluer. L'expression peut faire référence à des nombres, des ensembles de nœuds, comme à des valeurs booléennes. + +### Retour + +La valeur booléenne `true` ou `false` en fonction de l'évaluation de `expression`. + +### Notes + +- Un nombre est évalué à `false` si c'est un zéro positif ou négatif ou `NaN`. Autrement, il est évalué à `true`. +- Un ensemble de nœuds est évalué à `true` s'il n'est pas vide. +- Une chaîne est évaluée à `false` si elle est vide. Autrement, elle est évaluée à `true`. +- Un objet de type autre que les quatre types de bases, est converti en booléen par une méthode qui dépend de son type. + +### Définition + +[XPath 1.0, section 4.3](http://www.w3.org/TR/xpath#function-boolean). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/ceiling/index.md b/files/fr/web/xpath/functions/ceiling/index.md index d7bf6f388f..5810c1b60d 100644 --- a/files/fr/web/xpath/functions/ceiling/index.md +++ b/files/fr/web/xpath/functions/ceiling/index.md @@ -6,28 +6,33 @@ tags: translation_of: Web/XPath/Functions/ceiling original_slug: Web/XPath/Fonctions/ceiling --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>ceiling</code> évalue un nombre décimal et retourne le plus petit nombre entier supérieur ou égal au nombre évalué. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">ceiling( <i>nombre</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>nombre</i></code> -</dt><dd>Le nombre décimal à évaluer. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Le plus petit entier supérieur ou égal à <code><i>nombre</i></code>. -</p><p>Par exemple : -</p> -<pre class="eval"><code>ceiling (<i>5.2</i>)</code> = <var>6</var><br> -<code>ceiling (<i>-5.2</i>)</code> = <var>-5</var> -</pre> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-ceiling">XPath 1.0, section 4.4</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `ceiling` évalue un nombre décimal et retourne le plus petit nombre entier supérieur ou égal au nombre évalué. + +### Syntaxe + + ceiling( nombre ) + +### Arguments + +- `nombre` + - : Le nombre décimal à évaluer. + +### Retour + +Le plus petit entier supérieur ou égal à `nombre`. + +Par exemple : + + ceiling (5.2) = 6 + + ceiling (-5.2) = -5 + +### Définition + +[XPath 1.0, section 4.4](http://www.w3.org/TR/xpath#function-ceiling). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/concat/index.md b/files/fr/web/xpath/functions/concat/index.md index 7ee8eeae00..9ec5e9f246 100644 --- a/files/fr/web/xpath/functions/concat/index.md +++ b/files/fr/web/xpath/functions/concat/index.md @@ -6,24 +6,27 @@ tags: translation_of: Web/XPath/Functions/concat original_slug: Web/XPath/Fonctions/concat --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>concat</code> concatène deux ou plusieurs chaînes et retourne la chaîne résultante. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">concat( <i>chaîne<sub>1</sub></i> , <i>chaîne<sub>2</sub></i> [, <i>chaîne<sub>n</sub></i>]* ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>chaîne<sub>n</sub></i></code> -</dt><dd>Cette fonction accepte deux arguments ou plus. Chacun est une chaîne. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Une chaîne unique, résultat de la concaténation des chaînes passées en arguments à la fonction. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-concat">XPath 1.0, section 4.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `concat` concatène deux ou plusieurs chaînes et retourne la chaîne résultante. + +### Syntaxe + + concat( chaîne1 , chaîne2 [, chaînen]* ) + +### Arguments + +- `chaînen` + - : Cette fonction accepte deux arguments ou plus. Chacun est une chaîne. + +### Retour + +Une chaîne unique, résultat de la concaténation des chaînes passées en arguments à la fonction. + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-concat). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/contains/index.md b/files/fr/web/xpath/functions/contains/index.md index 15eb0239d7..130783d43d 100644 --- a/files/fr/web/xpath/functions/contains/index.md +++ b/files/fr/web/xpath/functions/contains/index.md @@ -4,36 +4,32 @@ slug: Web/XPath/Functions/contains translation_of: Web/XPath/Functions/contains original_slug: Web/XPath/Fonctions/contains --- -<p>{{ XsltRef() }}</p> +{{ XsltRef() }} -<p><br> - La fonction <code>contains</code> 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 <code>true</code> ou <code>false</code>.</p> +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`. -<h3 id="Syntaxe">Syntaxe</h3> +### Syntaxe -<pre class="eval">contains( <em>meule</em> , <em>aiguille</em> ) -</pre> + contains( meule , aiguille ) -<h3 id="Arguments">Arguments</h3> +### Arguments -<dl> - <dt><code><em>meule</em></code></dt> - <dd>La chaîne dans laquelle chercher.</dd> -</dl> +- `meule` + - : La chaîne dans laquelle chercher. -<dl> - <dt><code><em>aiguille</em></code></dt> - <dd>La chaîne à rechercher dans <code><em>meule</em></code></dd> -</dl> +<!----> -<h3 id="Retour">Retour</h3> +- `aiguille` + - : La chaîne à rechercher dans `meule` -<p><code>true</code> si <code><em>meule</em></code> contient <code><em>aiguille</em></code>. Autrement, <code>false</code>.</p> +### Retour -<h3 id="D.C3.A9finition">Définition</h3> +`true` si `meule` contient `aiguille`. Autrement, `false`. -<p><a href="http://www.w3.org/TR/xpath#function-contains">XPath 1.0, section 4.2</a>.</p> +### Définition -<h3 id="Support_Gecko">Support Gecko</h3> +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-contains). -<p>Supportée.</p> +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/count/index.md b/files/fr/web/xpath/functions/count/index.md index 3db718509a..85c635e83c 100644 --- a/files/fr/web/xpath/functions/count/index.md +++ b/files/fr/web/xpath/functions/count/index.md @@ -6,24 +6,27 @@ tags: translation_of: Web/XPath/Functions/count original_slug: Web/XPath/Fonctions/count --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>count</code> compte le nombre de nœuds dans un ensemble de nœuds et retourne un entier. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">count( <i>ensemble-de-nœuds</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>ensemble-de-nœuds</i></code> -</dt><dd>L'ensemble de nœuds à compter. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Un entier représentant le nombre de nœuds contenus dans l'ensemble. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-count">1.0, section 4.1</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `count` compte le nombre de nœuds dans un ensemble de nœuds et retourne un entier. + +### Syntaxe + + count( ensemble-de-nœuds ) + +### Arguments + +- `ensemble-de-nœuds` + - : L'ensemble de nœuds à compter. + +### Retour + +Un entier représentant le nombre de nœuds contenus dans l'ensemble. + +### Définition + +[1.0, section 4.1](http://www.w3.org/TR/xpath#function-count). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/current/index.md b/files/fr/web/xpath/functions/current/index.md index 14543f6d1f..c90cae5ffb 100644 --- a/files/fr/web/xpath/functions/current/index.md +++ b/files/fr/web/xpath/functions/current/index.md @@ -6,27 +6,34 @@ tags: translation_of: Web/XPath/Functions/current original_slug: Web/XPath/Fonctions/current --- -<p> {{ XsltRef() }} -</p><p>La fonction <code>current</code> peut être utilisée pour obtenir le nœud courant dans une instruction XSLT. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">current() -</pre> -<h3 id="Retour"> Retour </h3> -<p>Un ensemble de nœuds contenant uniquement le nœud courant. -</p> -<h3 id="Notes"> Notes </h3> -<p>Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath core. -</p><p>Le nœud courant est toujours identique au nœud de contexte. Les deux exemples suivants sont sémantiquement équivalents : -</p> -<pre class="eval"><xsl:value-of select="current()"/> -</pre> -<pre class="eval"><xsl:value-of select="."/> -</pre> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#function-current">XSLT 1.0, section 12.4</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `current` peut être utilisée pour obtenir le nœud courant dans une instruction XSLT. + +### Syntaxe + + current() + +### Retour + +Un ensemble de nœuds contenant uniquement le nœud courant. + +### Notes + +Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath core. + +Le nœud courant est toujours identique au nœud de contexte. Les deux exemples suivants sont sémantiquement équivalents : + + <xsl:value-of select="current()"/> + +<!----> + + <xsl:value-of select="."/> + +### Définition + +[XSLT 1.0, section 12.4](http://www.w3.org/TR/xslt#function-current). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/document/index.md b/files/fr/web/xpath/functions/document/index.md index 3f1bb98b80..66fd45dc68 100644 --- a/files/fr/web/xpath/functions/document/index.md +++ b/files/fr/web/xpath/functions/document/index.md @@ -6,38 +6,50 @@ tags: translation_of: Web/XPath/Functions/document original_slug: Web/XPath/Fonctions/document --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>document</code> recherche un ensemble de nœuds dans un ou des documents externes et retourne l'ensemble de nœuds résultant. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">document( <i>URI</i> [, <i>ensemble-de-nœuds</i>] ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>URI</i></code> -</dt><dd>URI absolue ou relative du document à récupérer. L'URI peut également contenir un identifiant de fragment. -</dd></dl> -<dl><dt><code><i>ensemble-de-nœuds</i></code> (optionnel) -</dt><dd>Une expression pointant vers un ensemble de nœuds du document externe, qui doit être retourné. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Un ensemble de nœuds. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> Si l'URI contient un identifiant de fragment et que celui-ci peut être repérer dans le document externe, alors ce fragment sera traité comme la racine pour rechercher l'expression de l'argument <code><i>ensemble-de-nœuds</i></code>. Si l'argument <code><i>ensemble-de-nœuds</i></code> est omis, le fragment entier sera retourné. -</li></ul> -<ul><li> Si l'argument <code><i>URI</i></code> est un ensemble de nœuds et que le second argument est présent, chaque nœud de l'ensemble de nœuds sera évalué comme une URI séparée, et l'ensemble de nœuds retourné sera le même que si la fonction <code>document</code> avait été appelée plusieurs fois, et que les résultats avait été concaténés dans un unique ensemble de nœuds. -</li></ul> -<ul><li> D'autres situations particulières existent avec des comportements bien définis. Pour plus d'informations, consultez la <a href="http://www.w3.org/TR/xslt">documentation XSLT 1.0</a>. -</li></ul> -<ul><li> Puisque l'URI est relative au document XSL, <code>document("")</code> retournera le nœud racine du document courant. -</li></ul> -<p>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. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#function-document">XSLT 1.0, section 12.1</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `document` recherche un ensemble de nœuds dans un ou des documents externes et retourne l'ensemble de nœuds résultant. + +### Syntaxe + + document( URI [, ensemble-de-nœuds] ) + +### Arguments + +- `URI` + - : URI absolue ou relative du document à récupérer. L'URI peut également contenir un identifiant de fragment. + +<!----> + +- `ensemble-de-nœuds` (optionnel) + - : Une expression pointant vers un ensemble de nœuds du document externe, qui doit être retourné. + +### Retour + +Un ensemble de nœuds. + +### Notes + +- Si l'URI contient un identifiant de fragment et que celui-ci peut être repérer dans le document externe, alors ce fragment sera traité comme la racine pour rechercher l'expression de l'argument `ensemble-de-nœuds`. Si l'argument `ensemble-de-nœuds` est omis, le fragment entier sera retourné. + +<!----> + +- Si l'argument `URI` est un ensemble de nœuds et que le second argument est présent, chaque nœud de l'ensemble de nœuds sera évalué comme une URI séparée, et l'ensemble de nœuds retourné sera le même que si la fonction `document` avait été appelée plusieurs fois, et que les résultats avait été concaténés dans un unique ensemble de nœuds. + +<!----> + +- D'autres situations particulières existent avec des comportements bien définis. Pour plus d'informations, consultez la [documentation XSLT 1.0](http://www.w3.org/TR/xslt). + +<!----> + +- Puisque l'URI est relative au document XSL, `document("")` retournera le nœud racine du document courant. + +Cette fonction est un ajout à XPath qui est spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions de XPath core. + +### Définition + +[XSLT 1.0, section 12.1](http://www.w3.org/TR/xslt#function-document). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/element-available/index.md b/files/fr/web/xpath/functions/element-available/index.md index 1ce80f0088..4a2100c494 100644 --- a/files/fr/web/xpath/functions/element-available/index.md +++ b/files/fr/web/xpath/functions/element-available/index.md @@ -6,24 +6,27 @@ tags: translation_of: Web/XPath/Functions/element-available original_slug: Web/XPath/Fonctions/element-available --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>element-available</code> détermine si un élément est disponible et retourne la valeur booléenne <code>true</code> ou <code>false</code>. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">element-available( <i>QName</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>QName</i></code> -</dt><dd>Doit s'évaluer en un QName valide. Le QName est développé en <i>nom étendu</i> à 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. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Retourne <code>true</code> 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 <code>element-available</code> retournera <code>false</code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#function-element-available">XSLT 1.0, section 15</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `element-available` détermine si un élément est disponible et retourne la valeur booléenne `true` ou `false`. + +### Syntaxe + + element-available( QName ) + +### Arguments + +- `QName` + - : Doit s'évaluer en un QName valide. Le QName est développé en _nom étendu_ à l'aide des déclarations d'espaces de nommage s'appliquant à l'expression. Le nom étendu est constitué d'une partie locale, une chaîne, et d'une URI d'espace de nommage. + +### Retour + +Retourne `true` si et seulement si le nom étendu est un nom d'instruction. Si le nom étendu a une URI d'espace de nommage égale à l'URI de l'espace de nommage XSLT, alors il se rapporte à un élément défini par XSLT. Autrement, il se rapporte à un élément d'extension. Si le nom étendu a une URI d'espace de nommage null, la fonction `element-available` retournera `false`. + +### Définition + +[XSLT 1.0, section 15](http://www.w3.org/TR/xslt#function-element-available). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/false/index.md b/files/fr/web/xpath/functions/false/index.md index 1914710d4a..79e162444f 100644 --- a/files/fr/web/xpath/functions/false/index.md +++ b/files/fr/web/xpath/functions/false/index.md @@ -6,27 +6,30 @@ tags: translation_of: Web/XPath/Functions/false original_slug: Web/XPath/Fonctions/false --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>false</code> retourne le booléen <code>false</code>. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">false() -</pre> -<h3 id="Retour"> Retour </h3> -<p>Booléen <code>false</code>. -</p> -<h3 id="Notes"> Notes </h3> -<p>Cette fonction est utile dans les comparaisons : -</p> -<pre class="eval"><xsl:if test="boolean((1 > 2) = false())"> - L'expression évaluée comme fausse -</xsl:if> -</pre> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-false">XPath 1.0, section 4.3</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `false` retourne le booléen `false`. + +### Syntaxe + + false() + +### Retour + +Booléen `false`. + +### Notes + +Cette fonction est utile dans les comparaisons : + + <xsl:if test="boolean((1 > 2) = false())"> + L'expression évaluée comme fausse + </xsl:if> + +### Définition + +[XPath 1.0, section 4.3](http://www.w3.org/TR/xpath#function-false). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/floor/index.md b/files/fr/web/xpath/functions/floor/index.md index 9e986d4ea5..672327f67d 100644 --- a/files/fr/web/xpath/functions/floor/index.md +++ b/files/fr/web/xpath/functions/floor/index.md @@ -10,28 +10,27 @@ tags: translation_of: Web/XPath/Functions/floor original_slug: Web/XPath/Fonctions/floor --- -<p>{{ XsltRef() }}</p> -<p><br> - La fonction <code>floor</code> évalue un nombre décimal et retourne le plus grand nombre entier inférieur ou égal au nombre évalué.</p> -<h3 id="Syntaxe">Syntaxe</h3> -<pre class="eval">floor(<i>nombre</i> ) -</pre> -<h3 id="Arguments">Arguments</h3> -<dl> - <dt> - <code> - <i> - nombre</i> - </code></dt> - <dd> - Le nombre décimal à évaluer.</dd> -</dl> -<h3 id="Retour">Retour</h3> -<p>Le plus grand nombre entier inférieur ou égal à <code> - <i> - nombre</i> - </code>.</p> -<h3 id="D.C3.A9finition">Définition</h3> -<p><a href="http://www.w3.org/TR/xpath#function-floor">XPath 1.0, section 4.4</a>.</p> -<h3 id="Support_Gecko">Support Gecko</h3> -<p>Supportée.</p> +{{ XsltRef() }} + +La fonction `floor` évalue un nombre décimal et retourne le plus grand nombre entier inférieur ou égal au nombre évalué. + +### Syntaxe + + floor(nombre ) + +### Arguments + +- `nombre` + - : Le nombre décimal à évaluer. + +### Retour + +Le plus grand nombre entier inférieur ou égal à `nombre`. + +### Définition + +[XPath 1.0, section 4.4](http://www.w3.org/TR/xpath#function-floor). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/format-number/index.md b/files/fr/web/xpath/functions/format-number/index.md index 3ea1be6d11..d1b8301ab3 100644 --- a/files/fr/web/xpath/functions/format-number/index.md +++ b/files/fr/web/xpath/functions/format-number/index.md @@ -6,33 +6,41 @@ tags: translation_of: Web/XPath/Functions/format-number original_slug: Web/XPath/Fonctions/format-number --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>format-number</code> évalue un nombre et retourne une chaîne représentant le nombre dans un format donné. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">format-number( <i>nombre</i> , <i>motif</i> [, <i>format-décimal</i>] ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>nombre</i></code> -</dt><dd>Le nombre à formater. -</dd></dl> -<dl><dt><code><i>motif</i></code> -</dt><dd>Une chaîne au format de la classe <a href="http://java.sun.com/products/jdk/1.1/docs/api/java.text.DecimalFormat.html">Decimal Format (en)</a> du JDK 1.1. La notice du JDK 1.1 n'est plus disponible. Vous trouverez ici la notice pour le JSE 6: <a href="http://java.sun.com/javase/6/docs/api/java/text/DecimalFormat.html">Decimal Format (en)</a> -</dd></dl> -<dl><dt><code><i>format-décimal</i></code> (optionnel) -</dt><dd>Le nom d'un élément <code><a href="fr/XSLT/decimal-format"> xsl:decimal-format</a></code> qui définit le format de nombre à utiliser. Si il est omis, le format décimal par défaut est utilisé. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Une chaîne représentant le nombre dans le nouveau format. -</p> -<h3 id="Notes"> Notes </h3> -<p>Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath principale. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#function-format-number">XSLT 1.0, section 12.3</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `format-number` évalue un nombre et retourne une chaîne représentant le nombre dans un format donné. + +### Syntaxe + + format-number( nombre , motif [, format-décimal] ) + +### Arguments + +- `nombre` + - : Le nombre à formater. + +<!----> + +- `motif` + - : Une chaîne au format de la classe [Decimal Format (en)](http://java.sun.com/products/jdk/1.1/docs/api/java.text.DecimalFormat.html) du JDK 1.1. La notice du JDK 1.1 n'est plus disponible. Vous trouverez ici la notice pour le JSE 6: [Decimal Format (en)](http://java.sun.com/javase/6/docs/api/java/text/DecimalFormat.html) + +<!----> + +- `format-décimal` (optionnel) + - : Le nom d'un élément [`xsl:decimal-format`](fr/XSLT/decimal-format) qui définit le format de nombre à utiliser. Si il est omis, le format décimal par défaut est utilisé. + +### Retour + +Une chaîne représentant le nombre dans le nouveau format. + +### Notes + +Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath principale. + +### Définition + +[XSLT 1.0, section 12.3](http://www.w3.org/TR/xslt#function-format-number). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/function-available/index.md b/files/fr/web/xpath/functions/function-available/index.md index 1df4e3aa24..a0b0fe9da6 100644 --- a/files/fr/web/xpath/functions/function-available/index.md +++ b/files/fr/web/xpath/functions/function-available/index.md @@ -6,24 +6,27 @@ tags: translation_of: Web/XPath/Functions/function-available original_slug: Web/XPath/Fonctions/function-available --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>function-available</code> détermine si une fonction donnée est disponible et retourne le booléen <code>true</code> ou <code>false</code>. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">function-available( <i>nom</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>nom</i></code> -</dt><dd>Le nom de la fonction à tester. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>La valeur booléenne <code>true</code> ou <code>false</code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#function-function-available">XPath 1.0, section 15</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `function-available` détermine si une fonction donnée est disponible et retourne le booléen `true` ou `false`. + +### Syntaxe + + function-available( nom ) + +### Arguments + +- `nom` + - : Le nom de la fonction à tester. + +### Retour + +La valeur booléenne `true` ou `false`. + +### Définition + +[XPath 1.0, section 15](http://www.w3.org/TR/xslt#function-function-available). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/generate-id/index.md b/files/fr/web/xpath/functions/generate-id/index.md index f339308ddc..e57e416554 100644 --- a/files/fr/web/xpath/functions/generate-id/index.md +++ b/files/fr/web/xpath/functions/generate-id/index.md @@ -6,31 +6,37 @@ tags: translation_of: Web/XPath/Functions/generate-id original_slug: Web/XPath/Fonctions/generate-id --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>generate-id</code> génère un identifiant <code>id</code> unique pour le premier nœud d'un ensemble de nœuds donné et retourne une chaîne contenant cet <code>id</code>. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">generate-id( [<i>ensemble-de-nœuds</i>] ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>ensemble-de-nœuds</i></code> (optionnel) -</dt><dd>Un <code>id</code> 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é. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Une chaîne contenant l'<code>id</code> généré. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> Le même <code>id</code> doit être généré à chaque fois pour le même nœud dans le document courant pour la transformation courante. -</li></ul> -<ul><li> L'<code>id</code> généré peut ne pas être le même pour les transformations subséquentes. -</li></ul> -<p>Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath principale. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#function-generate-id">XSLT 1.0, section 12.4</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `generate-id` génère un identifiant `id` unique pour le premier nœud d'un ensemble de nœuds donné et retourne une chaîne contenant cet `id`. + +### Syntaxe + + generate-id( [ensemble-de-nœuds] ) + +### Arguments + +- `ensemble-de-nœuds` (optionnel) + - : Un `id` sera généré pour le premier nœud de cet ensemble de nœuds. S'il est omis, le nœud de contexte courant sera utilisé. + +### Retour + +Une chaîne contenant l'`id` généré. + +### Notes + +- Le même `id` doit être généré à chaque fois pour le même nœud dans le document courant pour la transformation courante. + +<!----> + +- L'`id` généré peut ne pas être le même pour les transformations subséquentes. + +Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath principale. + +### Définition + +[XSLT 1.0, section 12.4](http://www.w3.org/TR/xslt#function-generate-id). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/id/index.md b/files/fr/web/xpath/functions/id/index.md index d8a9ef2e72..0aca569fff 100644 --- a/files/fr/web/xpath/functions/id/index.md +++ b/files/fr/web/xpath/functions/id/index.md @@ -6,30 +6,31 @@ tags: translation_of: Web/XPath/Functions/id original_slug: Web/XPath/Fonctions/id --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>id</code> recherche les nœuds correspondant aux identifiants <code>id</code> donnés et retourne un ensemble de nœuds contenant les nœuds identifiés. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">id( <i>expression</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> - -<dl> - <dt><code><i>expression</i></code></dt> - <dd>Si <code><i>expression</i></code> 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 <code>id</code>. Si <code><i>expression</i></code> est une chaîne, ou n'importe quoi d'autre qu'un ensemble de nœuds, alors <code><i>expression</i></code> est traitée comme une liste d'identifiants <code>id</code> séparés par des espaces L'ensemble de nœuds retourné comprend les nœuds corespondant à ces identifiants <code>id</code>.</dd> -</dl> - -<h3 id="Retour"> Retour </h3> -<p>Un ensemble de nœuds contenant les nœuds identifiés par les <code>id</code> donnés. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> La DTD du document XML détermine quel attribut est un <code>id</code>. Voir <a href="http://www.w3.org/TR/xpath#unique-id">XPath 1.0, section 5.2.1</a>. -</li></ul> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-id">XPath 1.0, section 4.1</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Partiellement supportée. -</p>
\ No newline at end of file + +La fonction `id` recherche les nœuds correspondant aux identifiants `id` donnés et retourne un ensemble de nœuds contenant les nœuds identifiés. + +### Syntaxe + + id( expression ) + +### Arguments + +- `expression` + - : Si `expression` est un ensemble de nœuds, alors la valeur de la chaîne de chacun des nœuds de l'ensemble est traitée individuellement. Les nœuds retournés sont ceux corespondant à ces identifiants `id`. Si `expression` est une chaîne, ou n'importe quoi d'autre qu'un ensemble de nœuds, alors `expression` est traitée comme une liste d'identifiants `id` séparés par des espaces L'ensemble de nœuds retourné comprend les nœuds corespondant à ces identifiants `id`. + +### Retour + +Un ensemble de nœuds contenant les nœuds identifiés par les `id` donnés. + +### Notes + +- La DTD du document XML détermine quel attribut est un `id`. Voir [XPath 1.0, section 5.2.1](http://www.w3.org/TR/xpath#unique-id). + +### Définition + +[XPath 1.0, section 4.1](http://www.w3.org/TR/xpath#function-id). + +### Support Gecko + +Partiellement supportée. diff --git a/files/fr/web/xpath/functions/index.md b/files/fr/web/xpath/functions/index.md index e4afddab49..f985a5bb4f 100644 --- a/files/fr/web/xpath/functions/index.md +++ b/files/fr/web/xpath/functions/index.md @@ -8,43 +8,41 @@ tags: translation_of: Web/XPath/Functions original_slug: Web/XPath/Fonctions --- -<p> </p> -<p>{{ XsltRef() }} La liste ci-dessous regroupe les principales fonctions de <a href="XPath">XPath</a> et les ajouts à XPath qui sont spécifiques à <a href="/XSLT">XSLT</a>. 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 <a href="/Gecko">Gecko</a>. Pour plus d'informations sur l'utilisation des fonctions XPath/XSLT, reportez-vous à la page <a href="/Transformations_XML_avec_XSLT/Autres_ressources">Autres ressources</a>.</p> -<ul> - <li><a href="Fonctions/boolean">boolean()</a></li> - <li><a href="Fonctions/ceiling">ceiling()</a></li> - <li><a href="Fonctions/concat">concat()</a></li> - <li><a href="Fonctions/contains">contains()</a></li> - <li><a href="Fonctions/count">count()</a></li> - <li><a href="Fonctions/current">current()</a> <i>Spécifique à XSLT</i></li> - <li><a href="Fonctions/document">document()</a> <i>Spécifique à XSLT</i></li> - <li><a href="Fonctions/element-available">element-available()</a></li> - <li><a href="Fonctions/false">false()</a></li> - <li><a href="Fonctions/floor">floor()</a></li> - <li><a href="Fonctions/format-number">format-number()</a> <i>Spécifique à XSLT</i></li> - <li><a href="Fonctions/function-available">function-available()</a></li> - <li><a href="Fonctions/generate-id">generate-id()</a> <i>Spécifique à XSLT</i></li> - <li><a href="Fonctions/id">id()</a> <i>(partiellement supporté)</i></li> - <li><a href="Fonctions/key">key()</a> <i>Spécifique à XSLT</i></li> - <li><a href="Fonctions/lang">lang()</a></li> - <li><a href="Fonctions/last">last()</a></li> - <li><a href="Fonctions/local-name">local-name()</a></li> - <li><a href="Fonctions/name">name()</a></li> - <li><a href="Fonctions/namespace-uri">namespace-uri()</a></li> - <li><a href="Fonctions/normalize-space">normalize-space()</a></li> - <li><a href="Fonctions/not">not()</a></li> - <li><a href="Fonctions/number">number()</a></li> - <li><a href="Fonctions/position">position()</a></li> - <li><a href="Fonctions/round">round()</a></li> - <li><a href="Fonctions/starts-with">starts-with()</a></li> - <li><a href="Fonctions/string">string()</a></li> - <li><a href="Fonctions/string-length">string-length()</a></li> - <li><a href="Fonctions/substring">substring()</a></li> - <li><a href="Fonctions/substring-after">substring-after()</a></li> - <li><a href="Fonctions/substring-before">substring-before()</a></li> - <li><a href="Fonctions/sum">sum()</a></li> - <li><a href="Fonctions/system-property">system-property()</a> <i>Spécifique à XSLT</i></li> - <li><a href="Fonctions/translate">translate()</a></li> - <li><a href="Fonctions/true">true()</a></li> - <li><a href="Fonctions/unparsed-entity-url">unparsed-entity-url()</a> <i>Spécifique à XSLT</i> <i>(non supporté)</i></li> -</ul>
\ No newline at end of file +{{ XsltRef() }} La liste ci-dessous regroupe les principales fonctions de [XPath](XPath) et les ajouts à XPath qui sont spécifiques à [XSLT](/XSLT). Chaque lien fournit pour la fonction correspondante description, syntaxe, liste d'arguments, types de résultats, description originelle dans les recommandations du W3C, et niveau de support actuel dans [Gecko](/Gecko). Pour plus d'informations sur l'utilisation des fonctions XPath/XSLT, reportez-vous à la page [Autres ressources](/Transformations_XML_avec_XSLT/Autres_ressources). + +- [boolean()](Fonctions/boolean) +- [ceiling()](Fonctions/ceiling) +- [concat()](Fonctions/concat) +- [contains()](Fonctions/contains) +- [count()](Fonctions/count) +- [current()](Fonctions/current) _Spécifique à XSLT_ +- [document()](Fonctions/document) _Spécifique à XSLT_ +- [element-available()](Fonctions/element-available) +- [false()](Fonctions/false) +- [floor()](Fonctions/floor) +- [format-number()](Fonctions/format-number) _Spécifique à XSLT_ +- [function-available()](Fonctions/function-available) +- [generate-id()](Fonctions/generate-id) _Spécifique à XSLT_ +- [id()](Fonctions/id) _(partiellement supporté)_ +- [key()](Fonctions/key) _Spécifique à XSLT_ +- [lang()](Fonctions/lang) +- [last()](Fonctions/last) +- [local-name()](Fonctions/local-name) +- [name()](Fonctions/name) +- [namespace-uri()](Fonctions/namespace-uri) +- [normalize-space()](Fonctions/normalize-space) +- [not()](Fonctions/not) +- [number()](Fonctions/number) +- [position()](Fonctions/position) +- [round()](Fonctions/round) +- [starts-with()](Fonctions/starts-with) +- [string()](Fonctions/string) +- [string-length()](Fonctions/string-length) +- [substring()](Fonctions/substring) +- [substring-after()](Fonctions/substring-after) +- [substring-before()](Fonctions/substring-before) +- [sum()](Fonctions/sum) +- [system-property()](Fonctions/system-property) _Spécifique à XSLT_ +- [translate()](Fonctions/translate) +- [true()](Fonctions/true) +- [unparsed-entity-url()](Fonctions/unparsed-entity-url) _Spécifique à XSLT_ _(non supporté)_ diff --git a/files/fr/web/xpath/functions/key/index.md b/files/fr/web/xpath/functions/key/index.md index 3804327e12..d68fb9a0ad 100644 --- a/files/fr/web/xpath/functions/key/index.md +++ b/files/fr/web/xpath/functions/key/index.md @@ -6,32 +6,38 @@ tags: translation_of: Web/XPath/Functions/key original_slug: Web/XPath/Fonctions/key --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>key</code> retourne un ensemble de nœuds ayant la valeur donnée pour la clef donnée. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">key( <i>nom-de-clef</i> , <i>valeur</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>nom-de-clef</i></code> -</dt><dd>Une chaîne contenant le nom de l'élément <code><a href="fr/XSLT/key"> xsl:key</a></code> à utiliser. -</dd></dl> -<dl><dt><code><i>valeur</i></code> -</dt><dd>L'ensemble de nœuds retourné contiendra chaque nœud qui possède cette valeur pour la clef donnée. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Un ensemble de nœuds. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> L'élément <code><a href="fr/XSLT/key"> xsl:key</a></code> définit quel attribut de quels éléments donnés sera utilisé pour la comparaison. -</li></ul> -<p>Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath principale. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#function-key">XSLT 1.0, section 12.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `key` retourne un ensemble de nœuds ayant la valeur donnée pour la clef donnée. + +### Syntaxe + + key( nom-de-clef , valeur ) + +### Arguments + +- `nom-de-clef` + - : Une chaîne contenant le nom de l'élément [`xsl:key`](fr/XSLT/key) à utiliser. + +<!----> + +- `valeur` + - : L'ensemble de nœuds retourné contiendra chaque nœud qui possède cette valeur pour la clef donnée. + +### Retour + +Un ensemble de nœuds. + +### Notes + +- L'élément [`xsl:key`](fr/XSLT/key) définit quel attribut de quels éléments donnés sera utilisé pour la comparaison. + +Cette fonction est un ajout à XPath spécifique à XSLT. Elle ne fait pas partie de la bibliothèque de fonctions XPath principale. + +### Définition + +[XSLT 1.0, section 12.2](http://www.w3.org/TR/xslt#function-key). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/lang/index.md b/files/fr/web/xpath/functions/lang/index.md index 56b56c7fb9..30ac163d87 100644 --- a/files/fr/web/xpath/functions/lang/index.md +++ b/files/fr/web/xpath/functions/lang/index.md @@ -6,48 +6,55 @@ tags: translation_of: Web/XPath/Functions/lang original_slug: Web/XPath/Fonctions/lang --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>lang</code> détermine si le nœud de contexte correspond à la langue indiquée et retourne le booléen <code>true</code> ou <code>false</code>. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">lang( <i>chaîne</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>chaîne</i></code> -</dt><dd>Le code de langue ou de localisation (langue et pays) à vérifier. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p><code>true</code> si le noeud de contexte est dans la langue donnée, <code>false</code> autrement. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> La langue d'un nœud est déterminée par son attribut <code>xml:lang</code>. Si le nœud courant ne possède pas cet attribut, alors la valeur de l'attribut <code>xml:lang</code> du plus proche ancêtre le possédant déterminera la langue du nœud courant. Si la langue ne peut être déterminée (aucun ancêtre avec un attribut <code>xml:lang</code>), cette fonction retourne le booléen <code>false</code>. -</li></ul> -<ul><li> Si la <code><i>chaîne</i></code> donnée ne spécifie pas de code de pays, cette fonction sélectionnera les nœuds dans la langue spécifiée, suivie éventuellement de n'importe quel code de pays. La réciproque n'est pas vraie. -</li></ul> -<p>Regardons le code XML suivant : -</p> -<pre><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></pre> -<p>et ce modèle XSL : -</p> -<pre class="eval"><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')])" /> -</pre> -<p>La sortie sera : -</p> -<pre class="eval">3 -1 -1 -0 -</pre> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-lang">XPath 1.0, section 4.3</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +La fonction `lang` détermine si le nœud de contexte correspond à la langue indiquée et retourne le booléen `true` ou `false`. + +### Syntaxe + + lang( chaîne ) + +### Arguments + +- `chaîne` + - : Le code de langue ou de localisation (langue et pays) à vérifier. + +### Retour + +`true` si le noeud de contexte est dans la langue donnée, `false` autrement. + +### Notes + +- La langue d'un nœud est déterminée par son attribut `xml:lang`. Si le nœud courant ne possède pas cet attribut, alors la valeur de l'attribut `xml:lang` du plus proche ancêtre le possédant déterminera la langue du nœud courant. Si la langue ne peut être déterminée (aucun ancêtre avec un attribut `xml:lang`), cette fonction retourne le booléen `false`. + +<!----> + +- Si la `chaîne` donnée ne spécifie pas de code de pays, cette fonction sélectionnera les nœuds dans la langue spécifiée, suivie éventuellement de n'importe quel code de pays. La réciproque n'est pas vraie. + +Regardons le code XML suivant : + + <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](http://www.w3.org/TR/xpath#function-lang). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xpath/functions/last/index.md b/files/fr/web/xpath/functions/last/index.md index f7a3251081..fc282aa526 100644 --- a/files/fr/web/xpath/functions/last/index.md +++ b/files/fr/web/xpath/functions/last/index.md @@ -6,23 +6,26 @@ tags: translation_of: Web/XPath/Functions/last original_slug: Web/XPath/Fonctions/last --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>last</code> retourne un nombre égal à la taille du contexte dans le contexte d'évaluation d'expression. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">last() -</pre> -<h3 id="Retour"> Retour </h3> -<p>Un entier égal à la taille du contexte dans le contexte d'évaluation d'expression. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> Cette fonction est souvent utilisée avec la fonction <a href="fr/XPath/Fonctions/position">position()</a> pour déterminer si un nœud particulier est le dernier d'un ensemble de nœud. -</li></ul> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-last">XPath 1.0, section 4.1</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `last` retourne un nombre égal à la taille du contexte dans le contexte d'évaluation d'expression. + +### Syntaxe + + last() + +### Retour + +Un entier égal à la taille du contexte dans le contexte d'évaluation d'expression. + +### Notes + +- Cette fonction est souvent utilisée avec la fonction [position()](fr/XPath/Fonctions/position) pour déterminer si un nœud particulier est le dernier d'un ensemble de nœud. + +### Définition + +[XPath 1.0, section 4.1](http://www.w3.org/TR/xpath#function-last). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/local-name/index.md b/files/fr/web/xpath/functions/local-name/index.md index 2d6092e1ca..41dccc07d7 100644 --- a/files/fr/web/xpath/functions/local-name/index.md +++ b/files/fr/web/xpath/functions/local-name/index.md @@ -6,27 +6,31 @@ tags: translation_of: Web/XPath/Functions/local-name original_slug: Web/XPath/Fonctions/local-name --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>local-name</code> retourne une chaîne représentant le nom local du premier nœud d'un ensemble de nœuds donné. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">local-name( [<i>ensemble-de-nœuds</i>] ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>ensemble-de-nœuds</i></code> (optionnel) -</dt><dd>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é. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Une chaîne. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> Le nom local est la partie locale d'un <a href="http://www.w3.org/TR/xpath#dt-expanded-name">nom étendu</a>. -</li></ul> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-local-name">XPath 1.0, section 4.1</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `local-name` retourne une chaîne représentant le nom local du premier nœud d'un ensemble de nœuds donné. + +### Syntaxe + + local-name( [ensemble-de-nœuds] ) + +### Arguments + +- `ensemble-de-nœuds` (optionnel) + - : Le nom local du premier nœud de cet ensemble de nœuds sera retourné. Si cet argument est omis, le nœud de contexte courant sera utilisé. + +### Retour + +Une chaîne. + +### Notes + +- Le nom local est la partie locale d'un [nom étendu](http://www.w3.org/TR/xpath#dt-expanded-name). + +### Définition + +[XPath 1.0, section 4.1](http://www.w3.org/TR/xpath#function-local-name). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/name/index.md b/files/fr/web/xpath/functions/name/index.md index 13a6961723..e6e5b05e3b 100644 --- a/files/fr/web/xpath/functions/name/index.md +++ b/files/fr/web/xpath/functions/name/index.md @@ -6,27 +6,31 @@ tags: translation_of: Web/XPath/Functions/name original_slug: Web/XPath/Fonctions/name --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>name</code> retourne une chaîne représentant le QName du premier nœud d'un ensemble de nœuds donné. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">name( [<i>ensemble-de-nœuds</i>] ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>ensemble-de-nœuds</i></code> (optionnel) -</dt><dd>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é. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Une chaîne représentant le QName d'un nœud. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> Le <a href="http://www.w3.org/TR/REC-xml-names/#NT-QName">QName</a> est le <i>nom qualifié</i> du nœud, incluant le préfixe de son espace de nommage et son nom local. -</li></ul> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-local-name">XPath 1.0, section 4.1</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `name` retourne une chaîne représentant le QName du premier nœud d'un ensemble de nœuds donné. + +### Syntaxe + + name( [ensemble-de-nœuds] ) + +### Arguments + +- `ensemble-de-nœuds` (optionnel) + - : Le QName du premier nœud de cet ensemble de nœuds sera retourné. Si cet argument est omis, le nœud de contexte courant sera utilisé. + +### Retour + +Une chaîne représentant le QName d'un nœud. + +### Notes + +- Le [QName](http://www.w3.org/TR/REC-xml-names/#NT-QName) est le _nom qualifié_ du nœud, incluant le préfixe de son espace de nommage et son nom local. + +### Définition + +[XPath 1.0, section 4.1](http://www.w3.org/TR/xpath#function-local-name). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/namespace-uri/index.md b/files/fr/web/xpath/functions/namespace-uri/index.md index 2506904f39..fc7e203e24 100644 --- a/files/fr/web/xpath/functions/namespace-uri/index.md +++ b/files/fr/web/xpath/functions/namespace-uri/index.md @@ -6,29 +6,35 @@ tags: translation_of: Web/XPath/Functions/namespace-uri original_slug: Web/XPath/Fonctions/namespace-uri --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>namespace-uri</code> retourne une chaîne représentant l'URI de l'espace de nommage du premier nœud d'un ensemble de nœuds donné. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">namespace-uri( [<i>ensemble-de-nœuds</i>] ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>ensemble-de-nœuds</i></code> (optionnel) -</dt><dd>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é. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Une chaîne représentant l'URI de l'espace de nommage dans lequel se trouve le nœud donné. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> S'il n'y a pas d'espace de nommage spécifié pour le noeud donné, la chaîne retournée sera une chaîne vide. -</li></ul> -<ul><li> Pour les nœuds autres que les nœuds <code>element</code> et <code>attribute</code>, la chaîne retournée sera toujours une chaîne vide. -</li></ul> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-local-name">XPath 1.0, section 4.1</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `namespace-uri` retourne une chaîne représentant l'URI de l'espace de nommage du premier nœud d'un ensemble de nœuds donné. + +### Syntaxe + + namespace-uri( [ensemble-de-nœuds] ) + +### Arguments + +- `ensemble-de-nœuds` (optionnel) + - : L'URI de l'espace de nommage du premier nœud de cet ensemble de nœuds sera retournée. Si cet argument est omis, le nœud de contexte courant sera utilisé. + +### Retour + +Une chaîne représentant l'URI de l'espace de nommage dans lequel se trouve le nœud donné. + +### Notes + +- S'il n'y a pas d'espace de nommage spécifié pour le noeud donné, la chaîne retournée sera une chaîne vide. + +<!----> + +- Pour les nœuds autres que les nœuds `element` et `attribute`, la chaîne retournée sera toujours une chaîne vide. + +### Définition + +[XPath 1.0, section 4.1](http://www.w3.org/TR/xpath#function-local-name). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/normalize-space/index.md b/files/fr/web/xpath/functions/normalize-space/index.md index 36023b5a12..90ce9154c5 100644 --- a/files/fr/web/xpath/functions/normalize-space/index.md +++ b/files/fr/web/xpath/functions/normalize-space/index.md @@ -6,31 +6,27 @@ tags: translation_of: Web/XPath/Functions/normalize-space original_slug: Web/XPath/Fonctions/normalize-space --- -<p>{{ XsltRef() }}</p> +{{ XsltRef() }} -<p><br> - La fonction <code>normalize-space</code> 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.</p> +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. -<h3 id="Syntaxe">Syntaxe</h3> +### Syntaxe -<pre class="eval notranslate">normalize-space(<em>chaîne</em> ) -</pre> + normalize-space(chaîne ) -<h3 id="Arguments">Arguments</h3> +### Arguments -<dl> - <dt><code><em>chaîne</em></code></dt> - <dd>La chaîne à normaliser.</dd> -</dl> +- `chaîne` + - : La chaîne à normaliser. -<h3 id="Retour">Retour</h3> +### Retour -<p>La chaîne nomalisée.</p> +La chaîne nomalisée. -<h3 id="D.C3.A9finition">Définition</h3> +### Définition -<p><a href="http://www.w3.org/TR/xpath#function-normalize-space">XPath 1.0, section 4.2</a>.</p> +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-normalize-space). -<h3 id="Support_Gecko">Support Gecko</h3> +### Support Gecko -<p>Supportée.</p> +Supportée. diff --git a/files/fr/web/xpath/functions/not/index.md b/files/fr/web/xpath/functions/not/index.md index 142a814159..9caf626f21 100644 --- a/files/fr/web/xpath/functions/not/index.md +++ b/files/fr/web/xpath/functions/not/index.md @@ -6,27 +6,31 @@ tags: translation_of: Web/XPath/Functions/not original_slug: Web/XPath/Fonctions/not --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>not</code> évalue une expression booléenne et retourne la valeur opposée. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">not( <i>expression</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>expression</i></code> (optionnel) -</dt><dd>L'expression est évaluée exactement comme si elle était passée en tant qu'argument à la fonction <a href="fr/XPath/Fonctions/boolean"> boolean()</a>. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p><code>True</code> pour une expression évaluée à <code>false</code> ; <code>false</code> pour une expression évaluée à <code>true</code>. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> Cette fonction devrait se comporter de façon identique à la fonction <a href="fr/XPath/Fonctions/boolean"> boolean()</a>, excepté qu'elle retourne la valeur opposée. -</li></ul> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-not">XPath 1.0, section 4.3</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `not` évalue une expression booléenne et retourne la valeur opposée. + +### Syntaxe + + not( expression ) + +### Arguments + +- `expression` (optionnel) + - : L'expression est évaluée exactement comme si elle était passée en tant qu'argument à la fonction [boolean()](fr/XPath/Fonctions/boolean). + +### Retour + +`True` pour une expression évaluée à `false` ; `false` pour une expression évaluée à `true`. + +### Notes + +- Cette fonction devrait se comporter de façon identique à la fonction [boolean()](fr/XPath/Fonctions/boolean), excepté qu'elle retourne la valeur opposée. + +### Définition + +[XPath 1.0, section 4.3](http://www.w3.org/TR/xpath#function-not). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/number/index.md b/files/fr/web/xpath/functions/number/index.md index 99a1511cb8..bef612a5cc 100644 --- a/files/fr/web/xpath/functions/number/index.md +++ b/files/fr/web/xpath/functions/number/index.md @@ -6,27 +6,34 @@ tags: translation_of: Web/XPath/Functions/number original_slug: Web/XPath/Fonctions/number --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>number</code> convertit un objet en un nombre et retourne ce nombre. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">number( [<i>objet</i>] ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><i><code>objet</code></i> (optionnel) -</dt><dd>L'objet à convertir en nombre. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Le nombre résultant après conversion de l'objet. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> Les chaînes sont converties en nombre en enlevant les espaces précédant le nombre dans la chaîne et en ignorant tout ce qui suit le nombre. Si la chaîne ne correspond pas à ce motif, alors elle est convertie en <code>NaN</code> </li><li> Le booléen <code>true</code> est converti en 1. <code>False</code> est converti en 0. </li><li> Un ensemble de nœuds est d'abord converti en chaîne comme lors d'un appel à la fonction <a href="fr/XPath/Fonctions/string">string()</a> puis il est traité de la même façon qu'une chaîne. -</li><li> Un objet qui n'est pas d'un des quatre types de base est converti en nombre avec une méthode qui dépend de son type. </li></ul> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-number">XPath 1.0, section 4.4</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `number` convertit un objet en un nombre et retourne ce nombre. + +### Syntaxe + + number( [objet] ) + +### Arguments + +- _`objet`_ (optionnel) + - : L'objet à convertir en nombre. + +### Retour + +Le nombre résultant après conversion de l'objet. + +### Notes + +- Les chaînes sont converties en nombre en enlevant les espaces précédant le nombre dans la chaîne et en ignorant tout ce qui suit le nombre. Si la chaîne ne correspond pas à ce motif, alors elle est convertie en `NaN` +- Le booléen `true` est converti en 1. `False` est converti en 0. +- Un ensemble de nœuds est d'abord converti en chaîne comme lors d'un appel à la fonction [string()](fr/XPath/Fonctions/string) puis il est traité de la même façon qu'une chaîne. +- Un objet qui n'est pas d'un des quatre types de base est converti en nombre avec une méthode qui dépend de son type. + +### Définition + +[XPath 1.0, section 4.4](http://www.w3.org/TR/xpath#function-number). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/position/index.md b/files/fr/web/xpath/functions/position/index.md index 2a51e4a9f5..6576ca4ae8 100644 --- a/files/fr/web/xpath/functions/position/index.md +++ b/files/fr/web/xpath/functions/position/index.md @@ -6,47 +6,45 @@ tags: translation_of: Web/XPath/Functions/position original_slug: Web/XPath/Fonctions/position --- -<p>{{ XsltRef() }}</p> +{{ XsltRef() }} -<p><br> - La fonction <code>position</code> retourne un nombre égal à la position du contexte dans le contexte d'évaluation d'expression.</p> +La fonction `position` retourne un nombre égal à la position du contexte dans le contexte d'évaluation d'expression. -<h3 id="Syntaxe">Syntaxe</h3> +### Syntaxe -<pre class="eval">position() -</pre> + position() -<h3 id="Retour">Retour</h3> +### Retour -<p>Un nombre entier égal à la position du contenu dans le contexte d'évaluation d'expression.</p> +Un nombre entier égal à la position du contenu dans le contexte d'évaluation d'expression. -<h3 id="Notes">Notes</h3> +### Notes -<ul> - <li>Notez que la numérotation de la position d'un n&oelig:ud dans un contexte commence à 1. Le premier nœud a donc la position 1.</li> -</ul> +- Notez que la numérotation de la position d'un n\&oelig:ud dans un contexte commence à 1. Le premier nœud a donc la position 1. -<ul> - <li>Le contexte est déterminé par le reste du chemin :</li> -</ul> +<!----> -<pre class="eval"><xsl:template match="//a[position() = 5]"> - <!-- cet exemple 'attrape' le cinquième élément "a" - n'importe où dans le document. --> -</xsl:template> -</pre> +- Le contexte est déterminé par le reste du chemin : -<pre class="eval"><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> -</pre> +<!----> -<h3 id="D.C3.A9finition">Définition</h3> + <xsl:template match="//a[position() = 5]"> + <!-- cet exemple 'attrape' le cinquième élément "a" + n'importe où dans le document. --> + </xsl:template> -<p><a href="http://www.w3.org/TR/xpath#function-position">XPath 1.0, section 4.1</a>.</p> +<!----> -<h3 id="Support_Gecko">Support Gecko</h3> + <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> -<p>Supportée.</p>
\ No newline at end of file +### Définition + +[XPath 1.0, section 4.1](http://www.w3.org/TR/xpath#function-position). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/round/index.md b/files/fr/web/xpath/functions/round/index.md index bca80c65dd..d711589de7 100644 --- a/files/fr/web/xpath/functions/round/index.md +++ b/files/fr/web/xpath/functions/round/index.md @@ -6,27 +6,31 @@ tags: translation_of: Web/XPath/Functions/round original_slug: Web/XPath/Fonctions/round --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>round</code> retourne le nombre entier le plus proche d'un nombre donné. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">round( <i>décimal</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>décimal</i></code> -</dt><dd>Le nombre décimal à arrondir. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Le plus proche nombre entier, qu'il soit plus grand, plus petit ou égal à <code><i>decimal</i></code>. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> -0.5 est arrondi à zéro négatif. 0.4 est arrondi à zéro positif. -</li></ul> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-round">XPath 1.0, section 4.4</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `round` retourne le nombre entier le plus proche d'un nombre donné. + +### Syntaxe + + round( décimal ) + +### Arguments + +- `décimal` + - : Le nombre décimal à arrondir. + +### Retour + +Le plus proche nombre entier, qu'il soit plus grand, plus petit ou égal à `decimal`. + +### Notes + +- \-0.5 est arrondi à zéro négatif. 0.4 est arrondi à zéro positif. + +### Définition + +[XPath 1.0, section 4.4](http://www.w3.org/TR/xpath#function-round). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/starts-with/index.md b/files/fr/web/xpath/functions/starts-with/index.md index 56b6336b04..ecd2e42fa5 100644 --- a/files/fr/web/xpath/functions/starts-with/index.md +++ b/files/fr/web/xpath/functions/starts-with/index.md @@ -6,17 +6,32 @@ tags: translation_of: Web/XPath/Functions/starts-with original_slug: Web/XPath/Fonctions/starts-with --- -<p>{{ XsltRef() }}</p> -<p><br> -La fonction <code>starts-with</code> vérifie si la première chaîne débute par la seconde, et retourne <code>true</code> ou <code>false</code>.</p> -<h3 id="Syntaxe">Syntaxe</h3> -<pre class="eval">starts-with( <em>meule</em> , <em>aiguille</em>) -</pre> -<h3 id="Arguments">Arguments</h3> -<dl><dt><code><em>meule</em></code> </dt><dd>La chaîne dans laquelle chercher. </dd></dl> <dl><dt><code><em>aiguille</em></code> </dt><dd>La chaîne à rechercher. </dd></dl> -<h3 id="Retour">Retour</h3> -<p><code>true</code> si meule débute par <code><em>aiguille</em></code>. Autrement, <code>false</code>.</p> -<h3 id="D.C3.A9finition">Définition</h3> -<p><a href="http://www.w3.org/TR/xpath#function-starts-with">XPath 1.0, section 4.2</a>.</p> -<h3 id="Support_Gecko">Support Gecko</h3> -<p>Supportée.</p>
\ No newline at end of file +{{ XsltRef() }} + +La fonction `starts-with` vérifie si la première chaîne débute par la seconde, et retourne `true` ou `false`. + +### Syntaxe + + starts-with( meule , aiguille) + +### Arguments + +- `meule` + - : La chaîne dans laquelle chercher. + +<!----> + +- `aiguille` + - : La chaîne à rechercher. + +### Retour + +`true` si meule débute par `aiguille`. Autrement, `false`. + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-starts-with). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/string-length/index.md b/files/fr/web/xpath/functions/string-length/index.md index e09490e74d..52ca3d65b1 100644 --- a/files/fr/web/xpath/functions/string-length/index.md +++ b/files/fr/web/xpath/functions/string-length/index.md @@ -6,24 +6,27 @@ tags: translation_of: Web/XPath/Functions/string-length original_slug: Web/XPath/Fonctions/string-length --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>string-length</code> retourne le nombre de caractères dans une chaîne donnée. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">string-length( [<i>chaîne</i>] ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>chaîne</i></code> (optionnel) -</dt><dd>La chaîne à évaluer. S'il est omis, la chaîne utilisée sera le noeud de contexte converti en chaîne. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Un entier égal au nombre de caractères dans la chaîne. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-string-length">XPath 1.0, section 4.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `string-length` retourne le nombre de caractères dans une chaîne donnée. + +### Syntaxe + + string-length( [chaîne] ) + +### Arguments + +- `chaîne` (optionnel) + - : La chaîne à évaluer. S'il est omis, la chaîne utilisée sera le noeud de contexte converti en chaîne. + +### Retour + +Un entier égal au nombre de caractères dans la chaîne. + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-string-length). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/string/index.md b/files/fr/web/xpath/functions/string/index.md index 1345b8ba5f..bf566b4a3c 100644 --- a/files/fr/web/xpath/functions/string/index.md +++ b/files/fr/web/xpath/functions/string/index.md @@ -6,35 +6,39 @@ tags: translation_of: Web/XPath/Functions/string original_slug: Web/XPath/Fonctions/string --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>string</code> convertit l'argument passé en une chaîne. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">string( [<i>objet</i>] ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>objet</i></code> (optionnel) -</dt><dd>L'objet à convertir en une chaîne. Si il est omis, le nœud du contexte est utilisé. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Une chaîne. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> Si l'objet est un ensemble de nœuds, la valeur de la chaîne du premier nœud de l'ensemble est retournée. -</li><li> Un nombre est converti comme suit : -<ul><li> NaN est converti en la chaîne <code>NaN</code>. -</li><li> Zéro positif est converti en <code>0</code>. -</li><li> Zéro négatif est converti en <code>0</code>. -</li><li> Infini positif est converti en la chaîne <code>Infinity</code>. -</li><li> Infini négatif est converti en la chaîne <code>-Infinity</code>. -</li><li> Les nombres décimaux entre -1 et 1 sont convertis en chaîne comportant un unique 0 avant le séparateur décimale. -</li></ul> -</li></ul> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-string">XPath 1.0, section 4.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `string` convertit l'argument passé en une chaîne. + +### Syntaxe + + string( [objet] ) + +### Arguments + +- `objet` (optionnel) + - : L'objet à convertir en une chaîne. Si il est omis, le nœud du contexte est utilisé. + +### Retour + +Une chaîne. + +### Notes + +- Si l'objet est un ensemble de nœuds, la valeur de la chaîne du premier nœud de l'ensemble est retournée. +- Un nombre est converti comme suit : + + - NaN est converti en la chaîne `NaN`. + - Zéro positif est converti en `0`. + - Zéro négatif est converti en `0`. + - Infini positif est converti en la chaîne `Infinity`. + - Infini négatif est converti en la chaîne `-Infinity`. + - Les nombres décimaux entre -1 et 1 sont convertis en chaîne comportant un unique 0 avant le séparateur décimale. + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-string). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/substring-after/index.md b/files/fr/web/xpath/functions/substring-after/index.md index 8aa294389a..856eafbf5a 100644 --- a/files/fr/web/xpath/functions/substring-after/index.md +++ b/files/fr/web/xpath/functions/substring-after/index.md @@ -6,30 +6,42 @@ tags: translation_of: Web/XPath/Functions/substring-after original_slug: Web/XPath/Fonctions/substring-after --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>substring-after()</code> retourne la partie d'une chaîne donnée suivant une sous-chaîne donnée. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">substring-after( <i>bottedefoin</i> , <i>aiguille</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>bottedefoin</i></code> -</dt><dd>La chaîne à évaluer. Un extrait de cette chaîne sera retourné. -</dd></dl> -<dl><dt><code><i>aiguille</i></code> -</dt><dd>La sous-chaîne à rechercher. Tout le contenu se trouvant après la première occurrence de <code><i>aiguille</i></code> dans la chaîne <code><i>bottedefoin</i></code> sera retourné. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Une chaîne. -</p> -<h3 id="Exemples"> Exemples </h3> -<table class="standard-table"> <tbody><tr> <th>Exemple XPath</th> <th>Sortie</th> </tr> <tr> <td><code><xsl:value-of select="substring-after('1999/04/01','/')" /></code></td> <td><code>04/01</code></td> </tr> <tr> <td><code>substring-after('aa-bb','-')</code></td> <td><code>bb</code></td> </tr> <tr> <td><code>substring-after('aa-bb','a')</code></td> <td><code>a-bb</code></td> </tr> <tr> <td><code>substring-after('aa-bb','b')</code></td> <td><code>b</code></td> </tr> <tr> <td><code>substring-after('aa-bb','q')</code></td> <td>(empty string)</td> </tr> -</tbody></table> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-substring-after">XPath 1.0, section 4.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `substring-after()` retourne la partie d'une chaîne donnée suivant une sous-chaîne donnée. + +### Syntaxe + + substring-after( bottedefoin , aiguille ) + +### Arguments + +- `bottedefoin` + - : La chaîne à évaluer. Un extrait de cette chaîne sera retourné. + +<!----> + +- `aiguille` + - : La sous-chaîne à rechercher. Tout le contenu se trouvant après la première occurrence de `aiguille` dans la chaîne `bottedefoin` sera retourné. + +### Retour + +Une chaîne. + +### Exemples + +| Exemple XPath | Sortie | +| ------------------------------------------------------------- | -------------- | +| `<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](http://www.w3.org/TR/xpath#function-substring-after). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/substring-before/index.md b/files/fr/web/xpath/functions/substring-before/index.md index f9ab5dcf01..0630ae0553 100644 --- a/files/fr/web/xpath/functions/substring-before/index.md +++ b/files/fr/web/xpath/functions/substring-before/index.md @@ -6,30 +6,42 @@ tags: translation_of: Web/XPath/Functions/substring-before original_slug: Web/XPath/Fonctions/substring-before --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>substring-before()</code> retourne retourne la partie d'une chaîne donnée précédant une sous-chaîne donnée. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">substring-before( <i>bottedefoin</i> , <i>aiguille</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>bottedefoin</i></code> -</dt><dd>La chaîne à évaluer. Un extrait de cette chaîne sera retourné. -</dd></dl> -<dl><dt><code><i>aiguille</i></code> -</dt><dd>La sous-chaîne à rechercher. Tout le contenu se trouvant avant la première occurrence de <code><i>aiguille</i></code> dans la chaîne <code><i>bottedefoin</i></code> sera retourné. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Une chaîne. -</p> -<h3 id="Exemples"> Exemples </h3> -<table class="standard-table"> <tbody><tr> <th>XPath Example</th> <th>Output</th> </tr> <tr> <td><code><xsl:value-of select="substring-before('1999/04/01','/')" /></code></td> <td><code>1999</code></td> </tr> <tr> <td><code>substring-before('aa-bb','-')</code></td> <td><code>aa</code></td> </tr> <tr> <td><code>substring-before('aa-bb','a')</code></td> <td><code>(empty string)</code></td> </tr> <tr> <td><code>substring-before('aa-bb','b')</code></td> <td><code>aa-</code></td> </tr> <tr> <td><code>substring-before('aa-bb','q')</code></td> <td>(empty string)</td> </tr> -</tbody></table> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-substring-before">XPath 1.0, section 4.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `substring-before()` retourne retourne la partie d'une chaîne donnée précédant une sous-chaîne donnée. + +### Syntaxe + + substring-before( bottedefoin , aiguille ) + +### Arguments + +- `bottedefoin` + - : La chaîne à évaluer. Un extrait de cette chaîne sera retourné. + +<!----> + +- `aiguille` + - : La sous-chaîne à rechercher. Tout le contenu se trouvant avant la première occurrence de `aiguille` dans la chaîne `bottedefoin` sera retourné. + +### Retour + +Une chaîne. + +### Exemples + +| XPath Example | Output | +| -------------------------------------------------------------- | ---------------- | +| `<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](http://www.w3.org/TR/xpath#function-substring-before). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/substring/index.md b/files/fr/web/xpath/functions/substring/index.md index 29cb112c4e..c6b6a7929b 100644 --- a/files/fr/web/xpath/functions/substring/index.md +++ b/files/fr/web/xpath/functions/substring/index.md @@ -6,32 +6,41 @@ tags: translation_of: Web/XPath/Functions/substring original_slug: Web/XPath/Fonctions/substring --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>substring</code> retourne une partie d'une chaîne donnée. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">substring( <i>chaîne</i> , <i>début</i> [, <i>longueur</i>] ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>chaîne</i></code> </dt><dd>La chaîne à évaluer. -</dd></dl> -<dl><dt><code><i>début</i></code> -</dt><dd>La position dans la <code><i>chaîne</i></code> où commence la sous-chaîne. -</dd></dl> -<dl><dt><code><i>longueur</i></code> (optionnel) -</dt><dd>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 <code><i>début</i></code> jusqu'à la fin de la <code><i>chaîne</i></code>. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Une chaîne. -</p> -<h3 id="Notes"> Notes </h3> -<p>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. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-substring">XPath 1.0, section 4.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `substring` retourne une partie d'une chaîne donnée. + +### Syntaxe + + substring( chaîne , début [, longueur] ) + +### Arguments + +- `chaîne` + - : La chaîne à évaluer. + +<!----> + +- `début` + - : La position dans la `chaîne` où commence la sous-chaîne. + +<!----> + +- `longueur` (optionnel) + - : La longueur de la sous-chaîne à extraire. S'il est omis, la chaîne retournée contiendra tous les caractères depuis la position `début` jusqu'à la fin de la `chaîne`. + +### Retour + +Une chaîne. + +### Notes + +Comme pour les autres fonctions XPath, les positions ne sont pas comptées à partir de zéro. Le premier caractère de la chaîne est à la position 1. + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-substring). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/sum/index.md b/files/fr/web/xpath/functions/sum/index.md index b5aa70ad1c..fee8e72724 100644 --- a/files/fr/web/xpath/functions/sum/index.md +++ b/files/fr/web/xpath/functions/sum/index.md @@ -6,27 +6,31 @@ tags: translation_of: Web/XPath/Functions/sum original_slug: Web/XPath/Fonctions/sum --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>sum</code> retourne un nombre qui est la somme des valeurs numériques de chaque nœud d'un ensemble de nœuds donné. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">sum( <i>ensemble-de-nœuds</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>ensemble-de-nœuds</i></code> -</dt><dd>L'ensemble de nœuds à évaluer. Chaque nœud de l'ensemble est évalué comme s'il était passé à la fonction <a href="fr/XPath/Fonctions/number"><code>number()</code></a>, et la somme des nombres résultants est retournée. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Un nombre. -</p> -<h3 id="Notes"> Notes </h3> -<p><i>(Aucune)</i> -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-sum">XPath 1.0, section 4.3</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `sum` retourne un nombre qui est la somme des valeurs numériques de chaque nœud d'un ensemble de nœuds donné. + +### Syntaxe + + sum( ensemble-de-nœuds ) + +### Arguments + +- `ensemble-de-nœuds` + - : L'ensemble de nœuds à évaluer. Chaque nœud de l'ensemble est évalué comme s'il était passé à la fonction [`number()`](fr/XPath/Fonctions/number), et la somme des nombres résultants est retournée. + +### Retour + +Un nombre. + +### Notes + +_(Aucune)_ + +### Définition + +[XPath 1.0, section 4.3](http://www.w3.org/TR/xpath#function-sum). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/system-property/index.md b/files/fr/web/xpath/functions/system-property/index.md index 60c0333072..e36f17ddb8 100644 --- a/files/fr/web/xpath/functions/system-property/index.md +++ b/files/fr/web/xpath/functions/system-property/index.md @@ -6,29 +6,33 @@ tags: translation_of: Web/XPath/Functions/system-property original_slug: Web/XPath/Fonctions/system-property --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>system-property()</code> retourne un objet représentant la propriété système donnée. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">system-property( <i>nom</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><i><code>nom</code></i> (optionnel) -</dt><dd>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 <code>system-property()</code> 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. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>Un objet représentant le propriété système donnée. -</p> -<h3 id="Notes"> Notes </h3> -<ul><li> xsl:version, un nombre correspondant à la version de XSLT implémentée par le processeur ; pour les processeurs XSLT implémentant la version de XSLT définit dans ce document, ce nombre est 1.0. -</li><li> xsl:vendor, une chaîne identifiant le vendeur du processeur XSLT. -</li><li> xsl:vendor-url, une chaîne contenant une URL qui identifie le vendeur du processeur XSLT ; généralement, il s'agit de l'adresse de la page Web du vendeur. -</li></ul> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#function-system-property">XSLT 1.0, section 12.4</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `system-property()` retourne un objet représentant la propriété système donnée. + +### Syntaxe + + system-property( nom ) + +### Arguments + +- _`nom`_ (optionnel) + - : Le nom de la propriété système. L'argument s'évaluer en une chaîne qui est un QName. Le QName est développé en un nom à l'aide des déclarations d'espaces de nommage s'appliquant à l'expression. La fonction `system-property()` retourne un objet représentant la valeur de la propriété système identifiée par le nom. Si cette propriété système n'existe pas, une chaîne vide est retournée. + +### Retour + +Un objet représentant le propriété système donnée. + +### Notes + +- xsl:version, un nombre correspondant à la version de XSLT implémentée par le processeur ; pour les processeurs XSLT implémentant la version de XSLT définit dans ce document, ce nombre est 1.0. +- xsl:vendor, une chaîne identifiant le vendeur du processeur XSLT. +- xsl:vendor-url, une chaîne contenant une URL qui identifie le vendeur du processeur XSLT ; généralement, il s'agit de l'adresse de la page Web du vendeur. + +### Définition + +[XSLT 1.0, section 12.4](http://www.w3.org/TR/xslt#function-system-property). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/translate/index.md b/files/fr/web/xpath/functions/translate/index.md index 97c03d561f..bb3b23d739 100644 --- a/files/fr/web/xpath/functions/translate/index.md +++ b/files/fr/web/xpath/functions/translate/index.md @@ -6,50 +6,63 @@ tags: translation_of: Web/XPath/Functions/translate original_slug: Web/XPath/Fonctions/translate --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>translate</code> évalue une chaîne et un ensemble de caractères à traduire, et retourne la chaîne traduite. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">translate( <i>chaîne</i> , <i>abc</i> , <i>XYZ</i> ) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>chaîne</i></code> -</dt><dd>La chaîne à évaluer. -</dd></dl> -<dl><dt><code><i>abc</i></code> -</dt><dd>La chaîne de caractères à remplacer. -</dd></dl> -<dl><dt><code><i>XYZ</i></code> </dt><dd>La chaîne de caractères utilisée pour le remplacement. Le premier caractère de <code><i>XYZ</i></code> remplacera chaque occurrence du premier caractère de <code><i>abc</i></code> qui apparaît dans <code><i>chaîne</i></code>. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>La chaîne traduite. -</p> -<h3 id="Notes"> Notes </h3> -<p>XPath note que la fonction <code>translate</code> 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. </p><p>Cependant, <code>translate</code> 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. -</p> -<h4 id="Exemple"> Exemple </h4> -<pre class="eval"><xsl:value-of select="translate('Le rapide renard.', 'abcdefghijklmnopqrstuvwxyz', 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'") /> -</pre> -<h4 id="Sortie"> Sortie </h4> -<pre class="eval">LE RAPIDE RENARD. -</pre> -<p><br> -</p> -<ul><li> Si <code><i>abc</i></code> est plus long que <code><i>XYZ</i></code>, alors chaque occurrence d'un caractère de <code><i>abc</i></code> qui n'a pas de correspondance dans <code><i>XYZ</i></code> sera supprimée. -</li></ul> -<h4 id="Exemple_2"> Exemple </h4> -<pre class="eval"><xsl:value-of select="translate('Le renard rapide.', 'renard', 'panda')" /> -</pre> -<h4 id="Sortie_2"> Sortie </h4> -<pre class="eval">La pandp pdpia. -</pre> -<ul><li> Si <code><i>XYZ</i></code> contient plus de caractères que <code><i>abc</i></code>, les caractères supplémentaires sont ignorés. -</li></ul> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-translate">XPath 1.0, section 4.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `translate` évalue une chaîne et un ensemble de caractères à traduire, et retourne la chaîne traduite. + +### Syntaxe + + translate( chaîne , abc , XYZ ) + +### Arguments + +- `chaîne` + - : La chaîne à évaluer. + +<!----> + +- `abc` + - : La chaîne de caractères à remplacer. + +<!----> + +- `XYZ` + - : La chaîne de caractères utilisée pour le remplacement. Le premier caractère de `XYZ` remplacera chaque occurrence du premier caractère de `abc` qui apparaît dans `chaîne`. + +### Retour + +La chaîne traduite. + +### Notes + +XPath note que la fonction `translate` n'est pas une solution suffisante pour la conversion majuscule/minuscule dans tous les langages. Une future version de XPath pourrait fournir des fonctions supplémentaires pour la conversion. + +Cependant, `translate` est à l'heure actuelle la fonction la plus proche d'une fonction pouvant convertir une chaîne en bas de casse ou haut de casse. + +#### Exemple + + <xsl:value-of select="translate('Le rapide renard.', 'abcdefghijklmnopqrstuvwxyz', 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'") /> + +#### Sortie + + LE RAPIDE RENARD. + +- Si `abc` est plus long que `XYZ`, alors chaque occurrence d'un caractère de `abc` qui n'a pas de correspondance dans `XYZ` sera supprimée. + +#### Exemple + + <xsl:value-of select="translate('Le renard rapide.', 'renard', 'panda')" /> + +#### Sortie + + La pandp pdpia. + +- Si `XYZ` contient plus de caractères que `abc`, les caractères supplémentaires sont ignorés. + +### Définition + +[XPath 1.0, section 4.2](http://www.w3.org/TR/xpath#function-translate). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/true/index.md b/files/fr/web/xpath/functions/true/index.md index 87e34d51c7..b6051e9ca5 100644 --- a/files/fr/web/xpath/functions/true/index.md +++ b/files/fr/web/xpath/functions/true/index.md @@ -6,20 +6,22 @@ tags: translation_of: Web/XPath/Functions/true original_slug: Web/XPath/Fonctions/true --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>true</code> retourne la valeur booléenne <code>true</code>. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">true() -</pre> -<h3 id="Retour"> Retour </h3> -<p>Le booléen <code>true</code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xpath#function-true">XPath 1.0, section 4.3</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +La fonction `true` retourne la valeur booléenne `true`. + +### Syntaxe + + true() + +### Retour + +Le booléen `true`. + +### Définition + +[XPath 1.0, section 4.3](http://www.w3.org/TR/xpath#function-true). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xpath/functions/unparsed-entity-url/index.md b/files/fr/web/xpath/functions/unparsed-entity-url/index.md index a8669bd1d8..c98f6ced41 100644 --- a/files/fr/web/xpath/functions/unparsed-entity-url/index.md +++ b/files/fr/web/xpath/functions/unparsed-entity-url/index.md @@ -6,24 +6,27 @@ tags: translation_of: Web/XPath/Functions/unparsed-entity-url original_slug: Web/XPath/Fonctions/unparsed-entity-url --- -<p> {{ XsltRef() }} -</p><p><br> -La fonction <code>unparsed-entity-url()</code> 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. -</p> -<h3 id="Syntaxe">Syntaxe </h3> -<pre class="eval">string unparsed-entity-url(<i>chaîne</i>) -</pre> -<h3 id="Arguments"> Arguments </h3> -<dl><dt><code><i>chaîne</i></code> -</dt><dd>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 <a href="fr/XPath/Fonctions/string"><code>string()</code></a>. Le nom doit être un nom XML. -</dd></dl> -<h3 id="Retour"> Retour </h3> -<p>L'URI de l'entité non analysée récupérée dans la DTD, si elle existe. Autrement, une chaîne vide. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#function-unparsed-entity-uri">XSLT 1.0, section 12.4</a>.0 -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Non supportée. -</p>
\ No newline at end of file + +La fonction `unparsed-entity-url()` retourne l'URI d'une entité non analysée avec le nom donné. C'est une donnée non-XML référencée dans le DTD du document source. + +### Syntaxe + + string unparsed-entity-url(chaîne) + +### Arguments + +- `chaîne` + - : Le nom de l'entité non analysée. Si l'argument n'est pas une chaîne, il est converti suivant les règles de la fonction [`string()`](fr/XPath/Fonctions/string). Le nom doit être un nom XML. + +### Retour + +L'URI de l'entité non analysée récupérée dans la DTD, si elle existe. Autrement, une chaîne vide. + +### Définition + +[XSLT 1.0, section 12.4](http://www.w3.org/TR/xslt#function-unparsed-entity-uri).0 + +### Support Gecko + +Non supportée. diff --git a/files/fr/web/xpath/index.md b/files/fr/web/xpath/index.md index 903d5d3772..948a0993e5 100644 --- a/files/fr/web/xpath/index.md +++ b/files/fr/web/xpath/index.md @@ -12,64 +12,50 @@ tags: - XSLT translation_of: Web/XPath --- -<div>{{XSLTRef}}</div> +{{XSLTRef}} -<p>XPath est une abréviation pour <i>XML Path Language</i> (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 <a href="/fr/docs/Web/XML/XML_introduction">XML</a>. Il peut aussi être utilisé pour tester certains nœuds d'un document afin de déterminer s'ils suivent un motif particulier.</p> +XPath est une abréviation pour _XML Path Language_ (qu'on pourrait traduire en français par « langage de chemin XML »). Ce langage utilise une syntaxe non-XML pour cibler différentes parties d'un document [XML](/fr/docs/Web/XML/XML_introduction). Il peut aussi être utilisé pour tester certains nœuds d'un document afin de déterminer s'ils suivent un motif particulier. -<p>XPath est principalement utilisé avec <a href="/fr/docs/Web/XSLT">XSLT</a>, mais on peut tout aussi bien l'utiliser afin de naviguer dans le <a href="/fr/docs/Web/API/Document_Object_Model">DOM</a> de tout document structuré avec un langage semblable à XML (<a href="/fr/docs/Web/HTML">HTML</a> ou <a href="/fr/docs/Web/SVG">SVG</a> par exemple) grâce à l'interface <a href="/fr/docs/Web/API/XPathExpression"><code>XPathExpression</code></a>. Cela permet d'éviter les méthodes <a href="/fr/docs/Web/API/Document/getElementById"><code>Document.getElementById()</code></a> ou <a href="/fr/docs/Web/API/ParentNode/querySelectorAll"><code>ParentNode.querySelectorAll()</code></a> ou encore les propriétés <a href="/fr/docs/Web/API/Node/childNodes"><code>Node.childNodes</code></a>.</p> +XPath est principalement utilisé avec [XSLT](/fr/docs/Web/XSLT), mais on peut tout aussi bien l'utiliser afin de naviguer dans le [DOM](/fr/docs/Web/API/Document_Object_Model) de tout document structuré avec un langage semblable à XML ([HTML](/fr/docs/Web/HTML) ou [SVG](/fr/docs/Web/SVG) par exemple) grâce à l'interface [`XPathExpression`](/fr/docs/Web/API/XPathExpression). Cela permet d'éviter les méthodes [`Document.getElementById()`](/fr/docs/Web/API/Document/getElementById) ou [`ParentNode.querySelectorAll()`](/fr/docs/Web/API/ParentNode/querySelectorAll) ou encore les propriétés [`Node.childNodes`](/fr/docs/Web/API/Node/childNodes). -<p>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.</p> +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. -<div class="note"> - <p><strong>Note :</strong> 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 (<i>polyfill</i>), vous pouvez vous tourner vers <a href="http://nchc.dl.sourceforge.net/project/js-xpath/js-xpath/1.0.0/xpath.js">js-xpath</a> ou <a href="https://github.com/google/wicked-good-xpath">wicked-good-xpath</a>.</p> -</div> +> **Note :** La prise en charge de XPath est hétérogène. Si l'implémentation de Firefox est relativement correcte (malgré l'absence de volonté de l'améliorer encore), d'autres navigateurs implémentent une surface moindre de ces fonctionnalités (voire aucune). Si vous avez besoin d'une prothèse (_polyfill_), vous pouvez vous tourner vers [js-xpath](http://nchc.dl.sourceforge.net/project/js-xpath/js-xpath/1.0.0/xpath.js) ou [wicked-good-xpath](https://github.com/google/wicked-good-xpath). -<h2 id="Documentation">Documentation</h2> +## Documentation -<dl> - <dt><a href="/fr/docs/Web/XPath/Introduction_to_using_XPath_in_JavaScript">Introduction à l'utilisation de XPath avec JavaScript</a></dt> - <dd>Une utilisation de XPath qui n'est pas basée sur XSLT.</dd> - <dt><a href="/fr/docs/Web/XPath/Axes">Axes XPath</a></dt> - <dd>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.</dd> - <dt><a href="/fr/docs/Web/XPath/Functions">Functions XPath</a></dt> - <dd>La liste et la description des fonctions principales de XPath et des additions propres à XSLT.</dd> - <dt><a href="/fr/docs/Web/XSLT/Transforming_XML_with_XSLT">Transformer du XML avec XSLT</a></dt> - <dd>XSLT utilise XPath afin de cibler les segments d'un document XML pour ensuite les transformer.</dd> - <dt><a href="/fr/docs/Web/XPath/Snippets">Fragments de code XPath</a></dt> - <dd>Un ensemble d'exemples de code réutilisables en JavaScript qui utilisent les API <a href="https://www.w3.org/TR/DOM-Level-3-XPath/">DOM Level 3 XPath </a>.</dd> - <dt><a href="https://www.xml.com/pub/a/2000/08/holman/">Qu'est-ce que XSLT ? (en anglais)</a></dt> - <dd>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.</dd> -</dl> +- [Introduction à l'utilisation de XPath avec JavaScript](/fr/docs/Web/XPath/Introduction_to_using_XPath_in_JavaScript) + - : Une utilisation de XPath qui n'est pas basée sur XSLT. +- [Axes XPath](/fr/docs/Web/XPath/Axes) + - : La liste et la définition des axes sont définies dans la spécification XPath. Les axes sont utilisés afin de décrire les relations entre les nœuds. +- [Functions XPath](/fr/docs/Web/XPath/Functions) + - : La liste et la description des fonctions principales de XPath et des additions propres à XSLT. +- [Transformer du XML avec XSLT](/fr/docs/Web/XSLT/Transforming_XML_with_XSLT) + - : XSLT utilise XPath afin de cibler les segments d'un document XML pour ensuite les transformer. +- [Fragments de code XPath](/fr/docs/Web/XPath/Snippets) + - : Un ensemble d'exemples de code réutilisables en JavaScript qui utilisent les API [DOM Level 3 XPath ](https://www.w3.org/TR/DOM-Level-3-XPath/). +- [Qu'est-ce que XSLT ? (en anglais)](https://www.xml.com/pub/a/2000/08/holman/) + - : Une introduction à XSLT et XPath sans besoin de connaissances préalables. Le contexte, la structure, les concepts ainsi qu'une terminologie introductive sont fournis au lecteur. -<h2 id="Tools">Outils</h2> +## Outils -<dl> - <dt><a href="https://addons.mozilla.org/fr/firefox/addon/chropath-for-firefox/">ChroPath</a></dt> - <dd>Un module complémentaire de Firefox qui ajoute un panneau dédié à XPath au sein des outils de développement.</dd> - <dt><a href="https://extendsclass.com/xpath-tester.html">XPath tester</a></dt> - <dd>Un outil en ligne pour tester des expressions XPath.</dd> -</dl> +- [ChroPath](https://addons.mozilla.org/fr/firefox/addon/chropath-for-firefox/) + - : Un module complémentaire de Firefox qui ajoute un panneau dédié à XPath au sein des outils de développement. +- [XPath tester](https://extendsclass.com/xpath-tester.html) + - : Un outil en ligne pour tester des expressions XPath. -<h2 id="Related_Topics">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/XSLT">XSLT</a>, <a href="/fr/docs/Web/XML">XML</a>, <a href="/fr/docs/Web/API/Document_Object_Model">DOM</a></li> - <li><a href="/fr/docs/Web/XPath/Comparison_with_CSS_selectors">Comparaison entre XPath et les sélecteurs CSS</a></li> - <li><strong><a href="/fr/docs/Web/XSLT">XSLT</a></strong></li> - <li><strong><a href="/fr/docs/Web/EXSLT">EXSLT</a></strong></li> - <li><strong><a href="/fr/docs/Web/XPath">XPath</a></strong></li> - <li> - Guides - <ol> - <li><a href="/fr/docs/Web/XPath/Comparison_with_CSS_selectors">Comparaison entre XPath et les sélecteurs CSS</a></li> - <li><a href="/fr/docs/Web/XPath/Snippets">Exemples de fragments XPath</a></li> - </ol> - </li> - <li > - <a href="/fr/docs/Web/XPath/Axes">Axes XPath</a> +- [XSLT](/fr/docs/Web/XSLT), [XML](/fr/docs/Web/XML), [DOM](/fr/docs/Web/API/Document_Object_Model) +- [Comparaison entre XPath et les sélecteurs CSS](/fr/docs/Web/XPath/Comparison_with_CSS_selectors) +- **[XSLT](/fr/docs/Web/XSLT)** +- **[EXSLT](/fr/docs/Web/EXSLT)** +- **[XPath](/fr/docs/Web/XPath)** +- Guides + + 1. [Comparaison entre XPath et les sélecteurs CSS](/fr/docs/Web/XPath/Comparison_with_CSS_selectors) + 2. [Exemples de fragments XPath](/fr/docs/Web/XPath/Snippets) + +- [Axes XPath](/fr/docs/Web/XPath/Axes) {{ListSubpagesForSidebar("/fr/docs/Web/XPath/Axes")}} - </li> - <li> - <a href="/fr/docs/Web/XPath/Functions">Fonctions XPath</a>{{ListSubpagesForSidebar("/fr/docs/Web/XPath/Functions")}} - </li> -</ul> +- [Fonctions XPath](/fr/docs/Web/XPath/Functions){{ListSubpagesForSidebar("/fr/docs/Web/XPath/Functions")}} diff --git a/files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.md b/files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.md index 571f41688c..c243759726 100644 --- a/files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.md +++ b/files/fr/web/xpath/introduction_to_using_xpath_in_javascript/index.md @@ -11,401 +11,407 @@ tags: translation_of: Web/XPath/Introduction_to_using_XPath_in_JavaScript original_slug: Web/JavaScript/Introduction_à_l_utilisation_de_XPath_avec_JavaScript --- -<p>Ce document décrit l'interface pour utiliser <a href="/fr/docs/Web/XPath">XPath</a> dans JavaScript, que ce soit en interne, dans les extensions et depuis les sites Web. Mozilla implémente une partie importante de <a href="https://www.w3.org/TR/2004/NOTE-DOM-Level-3-XPath-20040226/">DOM 3 XPath (en)</a>. Cela signifie que les expressions XPath peuvent être utilisées sur des documents HTML et XML.</p> +Ce document décrit l'interface pour utiliser [XPath](/fr/docs/Web/XPath) dans JavaScript, que ce soit en interne, dans les extensions et depuis les sites Web. Mozilla implémente une partie importante de [DOM 3 XPath (en)](https://www.w3.org/TR/2004/NOTE-DOM-Level-3-XPath-20040226/). Cela signifie que les expressions XPath peuvent être utilisées sur des documents HTML et XML. -<p>La principale interface pour l'utilisation de XPath est la fonction <code><a href="/fr/docs/Web/API/Document/evaluate">evaluate()</a></code> de l'objet <code><a href="/fr/docs/Web/API/Document">document</a></code>.</p> +La principale interface pour l'utilisation de XPath est la fonction [`evaluate()`](/fr/docs/Web/API/Document/evaluate) de l'objet [`document`](/fr/docs/Web/API/Document). -<h2 id="document.evaluate()">document.evaluate()</h2> +## document.evaluate() -<p>Cette méthode évalue les expressions <a href="/fr/docs/Web/XPath">XPath</a> dans un document <a href="/fr/docs/Web/XML">XML</a> (y compris les documents HTML), et retourne un objet <code><a href="/fr/docs/Web/XPath/XPathResult">XPathResult</a></code>, qui peut être un nœud unique ou un ensemble de nœuds. La documentation existante sur cette méthode se trouve à la page <code><a href="/fr/docs/Web/API/Document/evaluate">document.evaluate</a></code> 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.</p> +Cette méthode évalue les expressions [XPath](/fr/docs/Web/XPath) dans un document [XML](/fr/docs/Web/XML) (y compris les documents HTML), et retourne un objet [`XPathResult`](/fr/docs/Web/XPath/XPathResult), qui peut être un nœud unique ou un ensemble de nœuds. La documentation existante sur cette méthode se trouve à la page [`document.evaluate`](/fr/docs/Web/API/Document/evaluate) mais elle est plutôt succincte comparée à nos besoins actuels. Nous l'examinerons de façon plus complète dans la suite de ce document. -<pre class="eval">var xpathResult = document.evaluate( xpathExpression, contextNode, namespaceResolver, resultType, result ); -</pre> + var xpathResult = document.evaluate( xpathExpression, contextNode, namespaceResolver, resultType, result ); -<h3 id="Paramètres">Paramètres</h3> +### Paramètres -<p>La fonction <a href="/fr/docs/Web/API/Document/evaluate">evaluate</a> prend cinq arguments au total :</p> +La fonction [evaluate](/fr/docs/Web/API/Document/evaluate) prend cinq arguments au total : -<dl> - <dt><code>xpathExpression</code></dt> - <dd>Une chaîne contenant l'expression XPath à évaluer.</dd> - <dt><code>contextNode</code></dt> - <dd>Un nœud du document pour lequel l'expression <code>xpathExpression</code> doit être évaluée, ainsi que l'ensemble de ses descendants. Le nœud <a href="/fr/docs/Web/API/Document/">document</a> est le plus couramment utilisé.</dd> - <dt><code>namespaceResolver</code></dt> - <dd>Une fonction à laquelle sera passé tout préfixe d'espace de nommage contenu dans l'expression <code>xpathExpression</code> 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 :</dd> -</dl> +- `xpathExpression` + - : Une chaîne contenant l'expression XPath à évaluer. +- `contextNode` + - : Un nœud du document pour lequel l'expression `xpathExpression` doit être évaluée, ainsi que l'ensemble de ses descendants. Le nœud [document](/fr/docs/Web/API/Document/) est le plus couramment utilisé. +- `namespaceResolver` + - : Une fonction à laquelle sera passé tout préfixe d'espace de nommage contenu dans l'expression `xpathExpression` et qui renvoie une chaîne représentant l'URI de l'espace de nommage associé à ce préfixe. Cela permet la conversion entre le préfixe utilisé dans les expressions XPath et les différents préfixes éventuellement utilisés dans le document. Cette fonction peut être : -<ul> - <li><a href="#Impl.C3.A9mentation_d.27un_r.C3.A9solveur_d.27espaces_de_nommage_par_d.C3.A9faut">Créée</a> à l'aide de la méthode <code><a href="/fr/docs/Web/API/Document/createNSResolver">createNSResolver</a></code> d'un objet <code><a href="http://www.xulplanet.com/references/objref/XPathEvaluator.html">XPathEvaluator</a></code>. C'est la solution à utiliser à peu près tout le temps.</li> - <li>Une valeur <code>null</code>, qui peut être utilisé pour les documents HTML ou lorsqu'aucun préfixe n'est utilisé. Remarquez que si l'expression <code>xpathExpression</code> contient un préfixe d'espace de nommage cela déclenchera une exception <code>DOMException</code> portant le code <code>NAMESPACE_ERR</code>.</li> - <li>Une fonction personnalisée définie par l'utilisateur. Voir la section <a href="#Impl.C3.A9mentation_d.27un_r.C3.A9solveur_d.27espace_de_nommage_personnalis.C3.A9">Implémentation d'un résolveur d'espace de nommage personnalisé</a> dans l'annexe pour plus de détails.</li> -</ul> +<!----> -<dl> - <dt><code>resultType</code></dt> - <dd>Une <a href="#Constantes_d.C3.A9finies_de_XPathResult">constante</a> qui définit le type de résultat à renvoyer comme résultat de l'évaluation. La constante la plus courante est <code>XPathResult.ANY_TYPE</code> 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 <a href="#Constantes_d.C3.A9finies_de_XPathResult">constantes disponibles</a>. Elles sont expliquées dans la section <a href="#D.C3.A9finition_du_type_de_retour">#Définition du type de retour</a> ci-dessous.</dd> - <dt><code>result</code></dt> - <dd>Soit un objet <code>XPathResult</code> existant qui sera réutilisé pour contenir les résultats, soit la valeur <code>null</code> qui peut être utilisée pour créer un nouvel objet <code>XPathResult</code>.</dd> -</dl> +- [Créée](#Impl.C3.A9mentation_d.27un_r.C3.A9solveur_d.27espaces_de_nommage_par_d.C3.A9faut) à l'aide de la méthode [`createNSResolver`](/fr/docs/Web/API/Document/createNSResolver) d'un objet [`XPathEvaluator`](http://www.xulplanet.com/references/objref/XPathEvaluator.html). C'est la solution à utiliser à peu près tout le temps. +- Une valeur `null`, qui peut être utilisé pour les documents HTML ou lorsqu'aucun préfixe n'est utilisé. Remarquez que si l'expression `xpathExpression` contient un préfixe d'espace de nommage cela déclenchera une exception `DOMException` portant le code `NAMESPACE_ERR`. +- Une fonction personnalisée définie par l'utilisateur. Voir la section [Implémentation d'un résolveur d'espace de nommage personnalisé](#Impl.C3.A9mentation_d.27un_r.C3.A9solveur_d.27espace_de_nommage_personnalis.C3.A9) dans l'annexe pour plus de détails. -<h3 id="Valeur_de_retour">Valeur de retour</h3> +<!----> -<p>Renvoie <code>xpathResult</code>, qui est un objet <code>XPathResult</code> du type <a href="#D.C3.A9finition_du_type_de_retour">défini</a> dans le paramètre <code>resultType</code>. L'interface <code>XPathResult</code> est définie dans ce <a href="/fr/docs/Web/API/XPathResult">document</a>.</p> +- `resultType` + - : Une [constante](#Constantes_d.C3.A9finies_de_XPathResult) qui définit le type de résultat à renvoyer comme résultat de l'évaluation. La constante la plus courante est `XPathResult.ANY_TYPE` qui renverra un résultat du type le plus naturel par rapport à l'expression XPath. Une section de l'annexe contient une liste complète des [constantes disponibles](#Constantes_d.C3.A9finies_de_XPathResult). Elles sont expliquées dans la section [#Définition du type de retour](#D.C3.A9finition_du_type_de_retour) ci-dessous. +- `result` + - : Soit un objet `XPathResult` existant qui sera réutilisé pour contenir les résultats, soit la valeur `null` qui peut être utilisée pour créer un nouvel objet `XPathResult`. -<h3 id="Implémentation_d'un_résolveur_d'espaces_de_nommage_par_défaut">Implémentation d'un résolveur d'espaces de nommage par défaut</h3> +### Valeur de retour -<p>On crée un résolveur d'espace de nommage à l'aide de la méthode <code>createNSResolver</code> de l'objet <a href="/fr/docs/Web/API/Document/">document</a>.</p> +Renvoie `xpathResult`, qui est un objet `XPathResult` du type [défini](#D.C3.A9finition_du_type_de_retour) dans le paramètre `resultType`. L'interface `XPathResult` est définie dans ce [document](/fr/docs/Web/API/XPathResult). -<pre class="eval">var nsResolver = document.createNSResolver( contextNode.ownerDocument == null ? contextNode.documentElement : contextNode.ownerDocument.documentElement ); -</pre> +### Implémentation d'un résolveur d'espaces de nommage par défaut -<p>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 <code>document.evaluate</code>, la variable <code>nsResolver</code> comme paramètre <code>namespaceResolver</code>.</p> +On crée un résolveur d'espace de nommage à l'aide de la méthode `createNSResolver` de l'objet [document](/fr/docs/Web/API/Document/). -<p>véracité du paragraphe suivant à vérifier avec la doc du w3c Notez que XPath définit que les <code>QNames</code> sans préfixe correspondent uniquement aux éléments de l'espace de nommage <code>null</code>. 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 <a href="#Impl.C3.A9mentation_d.27un_r.C3.A9solveur_d.27espace_de_nommage_personnalis.C3.A9">créer un résolveur d'espace de nommage personnalisé</a> ci-dessous.</p> + var nsResolver = document.createNSResolver( contextNode.ownerDocument == null ? contextNode.documentElement : contextNode.ownerDocument.documentElement ); -<h3 id="Définition_du_type_de_retour">Définition du type de retour</h3> +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`. -<p>La variable <code>xpathResult</code> renvoyée par <code>document.evaluate</code> peut être composée de nœuds individuels (<a href="#Types_simples">types simples</a>), ou un groupe de nœuds (<a href="#Types_d.27ensembles_de_n.C5.93uds">types d'ensembles de nœuds</a>).</p> +véracité du paragraphe suivant à vérifier avec la doc du w3c Notez que XPath définit que les `QNames` sans préfixe correspondent uniquement aux éléments de l'espace de nommage `null`. Il n'existe aucun moyen dans XPath pour récupérer l'espace de nommage par défaut. Pour coupler des éléments ou des attributs dans un espace de nommage non nul, vous devrez détecter les noms préfixés, et créer un résolveur d'espace de nommage qui fera correspondre le préfixe avec l'espace de nommage. Vous en saurez plus sur la façon de [créer un résolveur d'espace de nommage personnalisé](#Impl.C3.A9mentation_d.27un_r.C3.A9solveur_d.27espace_de_nommage_personnalis.C3.A9) ci-dessous. -<h4 id="Types_simples">Types simples</h4> +### Définition du type de retour -<p>Lorsque le type de résultat spécifié dans <code>resultType</code> est soit :</p> +La variable `xpathResult` renvoyée par `document.evaluate` peut être composée de nœuds individuels ([types simples](#Types_simples)), ou un groupe de nœuds ([types d'ensembles de nœuds](#Types_d.27ensembles_de_n.C5.93uds)). -<ul> - <li><code>NUMBER_TYPE</code> — un nombre</li> - <li><code>STRING_TYPE</code> — une chaîne</li> - <li><code>BOOLEAN_TYPE</code> — une valeur booléenne</li> -</ul> +#### Types simples -<p>On obtiendra la valeur de retour de l'expression en accédant respectivement aux propriétés suivantes de l'objet <code>XPathResult</code> :</p> +Lorsque le type de résultat spécifié dans `resultType` est soit : -<ul> - <li><code>numberValue</code></li> - <li><code>stringValue</code></li> - <li><code>booleanValue</code></li> -</ul> +- `NUMBER_TYPE` — un nombre +- `STRING_TYPE` — une chaîne +- `BOOLEAN_TYPE` — une valeur booléenne -<h5 id="Exemple">Exemple</h5> +On obtiendra la valeur de retour de l'expression en accédant respectivement aux propriétés suivantes de l'objet `XPathResult` : -<p>Cet exemple utilise l'expression XPath <code><a href="/fr/docs/Web/XPath/Fonctions/count">count(//p)</a></code> pour obtenir le nombre d'éléments <code><p></code> présents dans le document HTML :</p> +- `numberValue` +- `stringValue` +- `booleanValue` -<pre>var paragraphCount = document.evaluate( 'count(//p)', document, null, XPathResult.ANY_TYPE, null ); +##### Exemple -console.log( 'Ce document contient ' + paragraphCount.numberValue + ' éléments de paragraphe' ); -</pre> +Cet exemple utilise l'expression XPath [`count(//p)`](/fr/docs/Web/XPath/Fonctions/count) pour obtenir le nombre d'éléments `<p>` présents dans le document HTML : -<p>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é <code>stringValue</code> est demandée. Ainsi, le code suivant ne fonctionnera <strong>pas</strong> :</p> + var paragraphCount = document.evaluate( 'count(//p)', document, null, XPathResult.ANY_TYPE, null ); -<pre>var paragraphCount = document.evaluate('count(//p)', document, null, XPathResult.ANY_TYPE, null ); + console.log( 'Ce document contient ' + paragraphCount.numberValue + ' éléments de paragraphe' ); -console.log( 'Ce document contient ' + paragraphCount.stringValue + ' éléments de paragraphe' ); -</pre> +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** : -<p>Au lieu de cela, il déclenchera une exception portant le code <code>NS_DOM_TYPE_ERROR</code>.</p> + var paragraphCount = document.evaluate('count(//p)', document, null, XPathResult.ANY_TYPE, null ); -<h4 id="Types_d'ensembles_de_nœuds">Types d'ensembles de nœuds</h4> + console.log( 'Ce document contient ' + paragraphCount.stringValue + ' éléments de paragraphe' ); -<p>L'objet <code>XPathResult</code> permet de renvoyer les ensembles de nœuds sous la forme de trois types principaux :</p> +Au lieu de cela, il déclenchera une exception portant le code `NS_DOM_TYPE_ERROR`. -<ul> - <li><a href="#It.C3.A9rateurs">Itérateurs</a></li> - <li><a href="#Snapshots">Snapshots</a></li> - <li><a href="#Premiers_n.C5.93uds">Premiers nœuds</a></li> -</ul> +#### Types d'ensembles de nœuds -<h5 id="Itérateurs">Itérateurs</h5> +L'objet `XPathResult` permet de renvoyer les ensembles de nœuds sous la forme de trois types principaux : -<p>Lorsque le type de résultat spécifié dans le paramètre <code>resultType</code> est soit :</p> +- [Itérateurs](#It.C3.A9rateurs) +- [Snapshots](#Snapshots) +- [Premiers nœuds](#Premiers_n.C5.93uds) -<ul> - <li><code>UNORDERED_NODE_ITERATOR_TYPE</code></li> - <li><code>ORDERED_NODE_ITERATOR_TYPE</code></li> -</ul> +##### Itérateurs -<p>L'objet <code>XPathResult</code> 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 <a href="/fr/docs/Web/XPathResult/IterateNext"><code>iterateNext()</code></a> de l'objet <code>XPathResult</code>.</p> +Lorsque le type de résultat spécifié dans le paramètre `resultType` est soit : -<p>Lorsque tous les nœuds ont été parcourus, <a href="/fr/docs/Web/XPathResult/IterateNext"><code>iterateNext()</code></a> renverra <code>null</code>.</p> +- `UNORDERED_NODE_ITERATOR_TYPE` +- `ORDERED_NODE_ITERATOR_TYPE` -<p>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é <code>invalidIteratorState</code> de <code>XPathResult</code> deviendra <code>true</code>. Une exception <code>NS_ERROR_DOM_INVALID_STATE_ERR</code> sera également déclenchée.</p> +L'objet `XPathResult` renvoyé sera un ensemble de nœuds correspondant à l'expression se comportant comme un itérateur. On pourra accéder individuellement aux nœuds qu'il contient en utilisant la méthode [`iterateNext()`](/fr/docs/Web/XPathResult/IterateNext) de l'objet `XPathResult`. -<h6 id="Exemple_d'itérateur">Exemple d'itérateur</h6> +Lorsque tous les nœuds ont été parcourus, [`iterateNext()`](/fr/docs/Web/XPathResult/IterateNext) renverra `null`. -<pre>var iterator = document.evaluate('//phoneNumber', documentNode, null, XPathResult.UNORDERED_NODE_ITERATOR_TYPE, null ); +Notez cependant que si le document est modifié (l'arbre du document est modifié) entre les itérations, l'itérateur sera invalidé et la propriété `invalidIteratorState` de `XPathResult` deviendra `true`. Une exception `NS_ERROR_DOM_INVALID_STATE_ERR` sera également déclenchée. -try { - var thisNode = iterator.iterateNext(); +<h6 id="Exemple_d'itérateur">Exemple d'itérateur</h6> - 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 ); -} -</pre> + var iterator = document.evaluate('//phoneNumber', documentNode, null, XPathResult.UNORDERED_NODE_ITERATOR_TYPE, null ); -<h5 id="Snapshots">Snapshots</h5> + try { + var thisNode = iterator.iterateNext(); -<p>Lorsque le type de résultat spécifié dans le paramètre <code>resultType</code> est l'une des valeurs suivantes :</p> + 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 ); + } -<ul> - <li><code>UNORDERED_NODE_SNAPSHOT_TYPE</code></li> - <li><code>ORDERED_NODE_SNAPSHOT_TYPE</code></li> -</ul> +##### Snapshots -<p>L'objet <code>XPathResult</code> 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 <a href="/fr/docs/Web/XPathResult/SnapshotItem"><code>snapshotItem(itemNumber)</code></a> de l'objet <code>XPathResult</code>, où <code>itemNumber</code> 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é <code>snapshotLength</code>.</p> +Lorsque le type de résultat spécifié dans le paramètre `resultType` est l'une des valeurs suivantes : -<p>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.</p> +- `UNORDERED_NODE_SNAPSHOT_TYPE` +- `ORDERED_NODE_SNAPSHOT_TYPE` + +L'objet `XPathResult` renvoyé sera un ensemble statique de nœuds correspondant à l'expression. L'accès à chaque nœud se fera au travers de la méthode [`snapshotItem(itemNumber)`](/fr/docs/Web/XPathResult/SnapshotItem) de l'objet `XPathResult`, où `itemNumber` est l'indice du nœud à récupérer. On peut accéder au nombre total de nœuds contenus dans l'ensemble par la propriété `snapshotLength`. + +Les snapshots ne changent pas avec les mutations du document. Aussi, contrairement aux itérateurs, le snapshot ne deviendra pas invalide mais peut ne plus correspondre au document actuel. Par exemple, des nœuds peuvent avoir été déplacés, il peut contenir des nœuds qui n'existent plus ou de nouveaux nœuds peuvent avoir été ajoutés. <h6 id="Exemple_de_snapshot">Exemple de snapshot</h6> -<pre>var nodesSnapshot = document.evaluate('//phoneNumber', documentNode, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null ); + var nodesSnapshot = document.evaluate('//phoneNumber', documentNode, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null ); -for ( var i=0 ; i < nodesSnapshot.snapshotLength; i++ ){ - console.log( nodesSnapshot.snapshotItem(i).textContent ); -} -</pre> + for ( var i=0 ; i < nodesSnapshot.snapshotLength; i++ ){ + console.log( nodesSnapshot.snapshotItem(i).textContent ); + } -<h5 id="Premier_nœud">Premier nœud</h5> +##### Premier nœud -<p>Lorsque le type de résultat spécifié dans le paramètre <code>resultType</code> est l'une des valeurs suivantes :</p> +Lorsque le type de résultat spécifié dans le paramètre `resultType` est l'une des valeurs suivantes : -<ul> - <li><code>ANY_UNORDERED_NODE_TYPE</code></li> - <li><code>FIRST_ORDERED_NODE_TYPE</code></li> -</ul> +- `ANY_UNORDERED_NODE_TYPE` +- `FIRST_ORDERED_NODE_TYPE` -<p>L'objet <code>XPathResult</code> renvoyé n'est que le premier nœud trouvé correspondant à l'expression XPath. On peut y accéder à l'aide de la propriété <code>singleNodeValue</code> de l'objet <code>XPathResult</code>. Celle-ci vaudra <code>null</code> si l'ensemble de nœuds est vide.</p> +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. -<p>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.</p> +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. <h6 id="Exemple_de_premier_nœud">Exemple de premier nœud</h6> -<pre class="brush:js">var firstPhoneNumber = document.evaluate('//phoneNumber', documentNode, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null ); +```js +var firstPhoneNumber = document.evaluate('//phoneNumber', documentNode, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null ); console.log( 'Le premier numéro de téléphone trouvé est ' + firstPhoneNumber.singleNodeValue.textContent ); -</pre> +``` -<h4 id="La_constante_ANY_TYPE">La constante ANY_TYPE</h4> +#### La constante ANY_TYPE -<p>Lorsque le type de résultat spécifié dans le paramètre <code>resultType</code> est la valeur <code>ANY_TYPE</code>, l'objet <code>XPathResult</code> renvoyé pourra être de n'importe quel type, c'est-à-dire du type résultant le plus naturellement de l'évaluation de l'expression.</p> +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. -<p>Il peut s'agir de n'importe lequel des types simples (<code>NUMBER_TYPE, STRING_TYPE, BOOLEAN_TYPE</code>), <strong>mais</strong> si le type du résultat retourné est un ensemble de nœuds alors il ne pourra être <strong>que</strong> du type <code>UNORDERED_NODE_ITERATOR_TYPE</code>.</p> +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`. -<p>Pour déterminer le type utilisé après l'évaluation, on utilisera la propriété <code>resultType</code> de l'objet <code>XPathResult</code>. Les valeurs <a href="#Constantes_d.C3.A9finies_de_XPathResult">constantes</a> de cette propriété sont définies dans l'annexe.</p> +Pour déterminer le type utilisé après l'évaluation, on utilisera la propriété `resultType` de l'objet `XPathResult`. Les valeurs [constantes](#Constantes_d.C3.A9finies_de_XPathResult) de cette propriété sont définies dans l'annexe. -<p>None Yet =====Exemple Any_Type===== <pre> </pre></p> +None Yet =====Exemple Any_Type===== \<pre> \</pre> -<h2 id="Exemples">Exemples</h2> +## Exemples -<h3 id="Dans_un_document_HTML">Dans un document HTML</h3> +### Dans un document HTML -<p>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.</p> +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. -<p>Pour extraire tous les éléments d'en-tête <code><h2></code> d'un document HTML à l'aide de XPath, l'expression <code>xpathExpression</code> est simplement '<code>//h2</code>', où <code>//</code> est l'opérateur descendant récursif (ou RDO) qui correspond aux éléments dont la propriété <code>nodeName</code> est <code>h2</code> n'importe où dans l'arbre du document. Le code complet pour cela est : link to introductory xpath doc</p> +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 -<pre class="brush:js">var headings = document.evaluate('//h2', document, null, XPathResult.ANY_TYPE, null ); -</pre> +```js +var headings = document.evaluate('//h2', document, null, XPathResult.ANY_TYPE, null ); +``` -<p>Notez que, comme HTML ne possède pas d'espace de nommage, <code>null</code> a été passé comme paramètre <code>namespaceResolver</code>.</p> +Notez que, comme HTML ne possède pas d'espace de nommage, `null` a été passé comme paramètre `namespaceResolver`. -<p>Comme le but est de chercher les en-têtes dans l'intégralité du document, on utilise l'objet <a href="/fr/docs/Web/API/Document/">document</a> lui-même comme paramètre <code>contextNode</code>.</p> +Comme le but est de chercher les en-têtes dans l'intégralité du document, on utilise l'objet [document](/fr/docs/Web/API/Document/) lui-même comme paramètre `contextNode`. -<p>Le résultat de cette expression est un objet <code>XPathResult</code>. Pour connaître le type de résultat renvoyé, il convient d'évaluer la propriété <code>resultType</code> de l'objet renvoyé. Dans notre cas, il sera évalué à <code>4</code>, c'est donc un <code>UNORDERED_NODE_ITERATOR_TYPE</code>. 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 <code>iterateNext()</code> de l'objet renvoyé :</p> +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é : -<pre>var thisHeading = headings.iterateNext(); + var thisHeading = headings.iterateNext(); -var alertText = 'Les en-têtes de niveau 2 présents dans ce document sont :\n' + var alertText = 'Les en-têtes de niveau 2 présents dans ce document sont :\n' -while (thisHeading) { - alertText += thisHeading.textContent + '\n'; - thisHeading = headings.iterateNext(); -} -</pre> + while (thisHeading) { + alertText += thisHeading.textContent + '\n'; + thisHeading = headings.iterateNext(); + } -<p>Une fois l'itération effectuée sur un nœud, nous avons accès à toutes les <a href="/fr/docs/Web/API/Document_Object_Model#Interfaces_du_DOM">Interfaces DOM</a> standards de ce nœud. Après avoir parcouru tous les éléments <code>h2</code> renvoyés à partir de notre expression, chaque nouvel appel à <code>iterateNext()</code> donnera <code>null</code>.</p> +Une fois l'itération effectuée sur un nœud, nous avons accès à toutes les [Interfaces DOM](/fr/docs/Web/API/Document_Object_Model#Interfaces_du_DOM) standards de ce nœud. Après avoir parcouru tous les éléments `h2` renvoyés à partir de notre expression, chaque nouvel appel à `iterateNext()` donnera `null`. -<h3 id="Évaluation_d'un_document_XML_appartenant_à_une_extension">Évaluation d'un document XML appartenant à une extension</h3> +### Évaluation d'un document XML appartenant à une extension -<p>L'exemple suivant utilise un document XML situé à l'adresse <code><a>chrome://yourextension/content/peopleDB.xml</a></code>.</p> +L'exemple suivant utilise un document XML situé à l'adresse [`chrome://yourextension/content/peopleDB.xml`](). -<pre><?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> -</pre> + <?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> -<p>Pour rendre les contenus du document XML accessibles depuis l'extension, on crée un objet <code><a href="/fr/docs/Web/API/XMLHttpRequest">XMLHttpRequest</a></code> pour charger le document de façon synchrone. La variable <code>xmlDoc</code> contiendra le document comme un objet <code><a href="/fr/docs/Web/API/XMLDocument">XMLDocument</a></code> sur lequel on pourra utiliser la méthode <code>evaluate</code>.</p> +Pour rendre les contenus du document XML accessibles depuis l'extension, on crée un objet [`XMLHttpRequest`](/fr/docs/Web/API/XMLHttpRequest) pour charger le document de façon synchrone. La variable `xmlDoc` contiendra le document comme un objet [`XMLDocument`](/fr/docs/Web/API/XMLDocument) sur lequel on pourra utiliser la méthode `evaluate`. -<p><em>JavaScript utilisé dans les documents XUL/js des extensions.</em></p> +_JavaScript utilisé dans les documents XUL/js des extensions._ -<pre>var req = new XMLHttpRequest(); + var req = new XMLHttpRequest(); -req.open("GET", "chrome://yourextension/content/peopleDB.xml", false); -req.send(null); + req.open("GET", "chrome://yourextension/content/peopleDB.xml", false); + req.send(null); -var xmlDoc = req.responseXML; + var xmlDoc = req.responseXML; -var nsResolver = xmlDoc.createNSResolver( xmlDoc.ownerDocument == null ? xmlDoc.documentElement : xmlDoc.ownerDocument.documentElement); + var nsResolver = xmlDoc.createNSResolver( xmlDoc.ownerDocument == null ? xmlDoc.documentElement : xmlDoc.ownerDocument.documentElement); -var personIterator = xmlDoc.evaluate('//person', xmlDoc, nsResolver, XPathResult.ANY_TYPE, null ); -</pre> + var personIterator = xmlDoc.evaluate('//person', xmlDoc, nsResolver, XPathResult.ANY_TYPE, null ); -<h4 id="Note">Note</h4> +#### Note -<p>Quant l'objet XPathResult n'est pas défini, les constantes peuvent être récupérées dans du code privilégié avec <code>Components.inertfaces.nsIDOMXPathResult.ANY_TYPE(CI.nsIDOMXPathResult)</code>. De la même manière un objet XPathEvaluator peut être créé en utilisant :</p> +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 : -<pre>Components.classes["@mozille.org/dom/xpath-evaluator;1"].createInstance(Components.interfaces.nsIDOMXPathEvaluator)</pre> + Components.classes["@mozille.org/dom/xpath-evaluator;1"].createInstance(Components.interfaces.nsIDOMXPathEvaluator) -<h2 id="Annexe">Annexe</h2> +## Annexe -<h4 id="Implémentation_d'un_résolveur_d'espace_de_nommage_personnalisé">Implémentation d'un résolveur d'espace de nommage personnalisé</h4> +#### Implémentation d'un résolveur d'espace de nommage personnalisé -<p>Cet exemple ne sert que d'illustration. Cette fonction nécessitera de prendre les préfixes d'espaces de nommage depuis la <code>xpathExpression</code> et retourne l'URI correspondante à ces préfixes. Par exemple, l'expression :</p> +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 : -<pre>'//xhtml:td/mathml:math' -</pre> + '//xhtml:td/mathml:math' -<p>sélectionnera toutes les expressions <a href="/fr/MathML">MathML</a> qui sont les descendantes des éléments (X)HTML de cellules de tableau.</p> +sélectionnera toutes les expressions [MathML](/fr/MathML) qui sont les descendantes des éléments (X)HTML de cellules de tableau. -<p>Afin d'associer le préfixe <code>mathml:</code> avec l'URI d'espace de nommage '<code><a href="http://www.w3.org/1998/Math/MathML">http://www.w3.org/1998/Math/MathML</a></code>' et <code>xhtml:</code> avec l'URI <code><a href="http://www.w3.org/1999/xhtml">http://www.w3.org/1999/xhtml</a></code>, nous fournissons une fonction :</p> +Afin d'associer le préfixe `mathml:` avec l'URI d'espace de nommage '[`http://www.w3.org/1998/Math/MathML`](http://www.w3.org/1998/Math/MathML)' et `xhtml:` avec l'URI [`http://www.w3.org/1999/xhtml`](http://www.w3.org/1999/xhtml), nous fournissons une fonction : -<pre>function nsResolver(prefix) { - var ns = { - 'xhtml' : 'http://www.w3.org/1999/xhtml', - 'mathml': 'http://www.w3.org/1998/Math/MathML' - }; - return ns[prefix] || null; -} -</pre> + function nsResolver(prefix) { + var ns = { + 'xhtml' : 'http://www.w3.org/1999/xhtml', + 'mathml': 'http://www.w3.org/1998/Math/MathML' + }; + return ns[prefix] || null; + } -<p>L'appel à <code>document.evaluate</code> ressemblera alors à :</p> +L'appel à `document.evaluate` ressemblera alors à : -<pre class="eval">document.evaluate( '//xhtml:td/mathml:math', document, nsResolver, XPathResult.ANY_TYPE, null ); -</pre> + document.evaluate( '//xhtml:td/mathml:math', document, nsResolver, XPathResult.ANY_TYPE, null ); -<h4 id="Implémentation_d'un_espace_de_nommage_par_défaut_pour_les_documents_XML">Implémentation d'un espace de nommage par défaut pour les documents XML</h4> +#### Implémentation d'un espace de nommage par défaut pour les documents XML -<p>Comme nous l'avons vu précédemment dans la section <a href="#Impl.C3.A9mentation_d.27un_r.C3.A9solveur_d.27espaces_de_nommage_par_d.C3.A9faut">#Implémentation d'un résolveur d'espaces de nommage par défaut</a>, 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 :</p> +Comme nous l'avons vu précédemment dans la section [#Implémentation d'un résolveur d'espaces de nommage par défaut](#Impl.C3.A9mentation_d.27un_r.C3.A9solveur_d.27espaces_de_nommage_par_d.C3.A9faut), le résolveur par défaut ne gère pas l'espace de nommage par défaut pour les documents XML. Par exemple, avec ce document : -<pre><?xml version="1.0" encoding="UTF-8"?> -<feed xmlns="http://www.w3.org/2005/Atom"> - <entry /> - <entry /> - <entry /> -</feed> -</pre> + <?xml version="1.0" encoding="UTF-8"?> + <feed xmlns="http://www.w3.org/2005/Atom"> + <entry /> + <entry /> + <entry /> + </feed> -<p><code>doc.evaluate('//entry', doc, nsResolver, XPathResult.ANY_TYPE, null)</code> retournera un ensemble vide, où <code>nsResolver</code> est le résolveur retourné par <code>createNSResolver</code>. Passé un résolveur <code>null</code> ne fonctionne pas mieux.</p> +`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. -<p>Une alternative possible est de créer un résolveur personnalisé qui retournera le bon espace de nommage (l'espace de nommage <em>Atom</em> dans ce cas). Par exemple :</p> +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 : -<pre> function resolver() { - return 'http://www.w3.org/2005/Atom'; - } - doc.evaluate('//entry', doc, resolver, XPathResult.ANY_TYPE, null) -</pre> + function resolver() { + return 'http://www.w3.org/2005/Atom'; + } + doc.evaluate('//entry', doc, resolver, XPathResult.ANY_TYPE, null) -<p>Un résolveur plus complexe sera nécessaire si le document utilise de multiple espaces de nommage.</p> +Un résolveur plus complexe sera nécessaire si le document utilise de multiple espaces de nommage. -<p>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.</p> +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. -<h4 id="Utiliser_les_fonctions_XPath_pour_référencer_les_éléments_avec_un_espace_de_nom_par_défaut">Utiliser les fonctions XPath pour référencer les éléments avec un espace de nom par défaut</h4> +#### Utiliser les fonctions XPath pour référencer les éléments avec un espace de nom par défaut -<p>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 <code>[namespace-uri()='http://www.w3.org/1999/xhtml' and name()='p' and @id='_monid']</code>. 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.</p> +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. -<h4 id="Obtenir_des_éléments_et_des_attributs_d'un_espace_de_noms_spécifique_en_ignorant_le_préfixe">Obtenir des éléments et des attributs d'un espace de noms spécifique en ignorant le préfixe</h4> +#### Obtenir des éléments et des attributs d'un espace de noms spécifique en ignorant le préfixe -<p>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.</p> +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. -<p>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 <a href="/XPath/Functions/local-name">local-name()</a> combiné avec <a href="/XPath/Functions/namespace-uri">namespace-uri()</a> à la place de <a href="/XPath/Functions/name">name()</a>), 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).</p> +Tandis que l'on peut adapter la technique dans la section supérieure pour tester les éléments appartenant à un espace de noms sans regarder le préfix choisi (en utilisant [local-name()](/XPath/Functions/local-name) combiné avec [namespace-uri()](/XPath/Functions/namespace-uri) à la place de [name()](/XPath/Functions/name)), un situation plus compliquée apparaît cependant, si l'on souhaite obtenir un élément avec un attribut appartenant à un espace de noms spécifique dans un prédicat (étant donnée l'absence des variables indépendantes de l'implémentation en XPath 1.0). -<p>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 : <code>var xpathlink = someElements[local-name(@*)="href" and namespace-uri(@*)='http://www.w3.org/1999/xlink'];</code></p> +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'];` -<p>Cela pourrait récupérer des éléments par inadvertance si un de ces attributs existaient avec un nom local "<code>href</code>", mais que c'était un autre attribut qui avait le nom d'espace ciblé (XLink, à la place de <a href="/XPath/Axes/attribute">@href</a>).</p> +Cela pourrait récupérer des éléments par inadvertance si un de ces attributs existaient avec un nom local "`href`", mais que c'était un autre attribut qui avait le nom d'espace ciblé (XLink, à la place de [@href](/XPath/Axes/attribute)). -<p>Afin d'obtenir des éléments avec l'attribut XLink <code>@href</code> 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 :</p> +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 : -<pre>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(); -</pre> + 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(); -<h4 id="Constantes_définies_de_XPathResult">Constantes définies de XPathResult</h4> +#### Constantes définies de XPathResult <table class="standard-table"> - <tbody> - <tr> - <td class="header">Constante du type de résultat</td> - <td class="header">Valeur</td> - <td class="header">Description</td> - </tr> - <tr> - <td>ANY_TYPE</td> - <td>0</td> - <td>Un ensemble contenant n'importe quel type qui résulte naturellement de l'évaluation de l'expression. Notez que si c'est un ensemble de noeuds qui doit être retourné, alors le type résultant sera toujours UNORDERED_NODE_ITERATOR_TYPE.</td> - </tr> - <tr> - <td>NUMBER_TYPE</td> - <td>1</td> - <td>Un résultat contenant un seul nombre. C'est utile, par exemple, dans une expression XPath utilisant la fonction <code>count()</code>.</td> - </tr> - <tr> - <td>STRING_TYPE</td> - <td>2</td> - <td>Un résultat contenant une seule chaîne de caractère.</td> - </tr> - <tr> - <td>BOOLEAN_TYPE</td> - <td>3</td> - <td>Un résultat contenant une seule valeur booléenne. C'est utile, par exemple, dans une expression XPath utilisant la fonction <code>not()</code>.</td> - </tr> - <tr> - <td>UNORDERED_NODE_ITERATOR_TYPE</td> - <td>4</td> - <td>Un ensemble de nœuds contenant tous les nœuds vérifiant l'expression. Les nœuds ne sont pas nécessairement dans le même ordre que celui dans lequel ils apparaissent dans le document.</td> - </tr> - <tr> - <td>ORDERED_NODE_ITERATOR_TYPE</td> - <td>5</td> - <td>Un ensemble de nœuds contenant tous les nœuds vérifiant l'expression. Les nœuds du résultat sont dans le même ordre que celui dans lequel ils apparaissent dans le document.</td> - </tr> - <tr> - <td>UNORDERED_NODE_SNAPSHOT_TYPE</td> - <td>6</td> - <td>Un ensemble de nœuds contenant les snapshots de tous les nœuds vérifiant l'expression. Les nœuds ne sont pas nécessairement dans le même ordre que celui dans lequel ils apparaissent dans le document.</td> - </tr> - <tr> - <td>ORDERED_NODE_SNAPSHOT_TYPE</td> - <td>7</td> - <td>Un ensemble de nœuds contenant les snapshots de tous les nœuds vérifiant l'expression. Les nœuds du résultat sont dans le même ordre que celui dans lequel ils apparaissent dans le document.</td> - </tr> - <tr> - <td>ANY_UNORDERED_NODE_TYPE</td> - <td>8</td> - <td>Un ensemble de nœuds contenant un seul nœud vérifiant l'expression. Le nœud n'est pas nécessairement le premier dans l'ordre du document qui correspond à l'expression.</td> - </tr> - <tr> - <td>FIRST_ORDERED_NODE_TYPE</td> - <td>9</td> - <td>Un ensemble de nœuds contenant le premier nœud du document vérifiant l'expression.</td> - </tr> - </tbody> + <tbody> + <tr> + <td class="header">Constante du type de résultat</td> + <td class="header">Valeur</td> + <td class="header">Description</td> + </tr> + <tr> + <td>ANY_TYPE</td> + <td>0</td> + <td> + Un ensemble contenant n'importe quel type qui résulte naturellement de + l'évaluation de l'expression. Notez que si c'est un ensemble de noeuds + qui doit être retourné, alors le type résultant sera toujours + UNORDERED_NODE_ITERATOR_TYPE. + </td> + </tr> + <tr> + <td>NUMBER_TYPE</td> + <td>1</td> + <td> + Un résultat contenant un seul nombre. C'est utile, par exemple, dans une + expression XPath utilisant la fonction <code>count()</code>. + </td> + </tr> + <tr> + <td>STRING_TYPE</td> + <td>2</td> + <td>Un résultat contenant une seule chaîne de caractère.</td> + </tr> + <tr> + <td>BOOLEAN_TYPE</td> + <td>3</td> + <td> + Un résultat contenant une seule valeur booléenne. C'est utile, par + exemple, dans une expression XPath utilisant la fonction + <code>not()</code>. + </td> + </tr> + <tr> + <td>UNORDERED_NODE_ITERATOR_TYPE</td> + <td>4</td> + <td> + Un ensemble de nœuds contenant tous les nœuds vérifiant l'expression. + Les nœuds ne sont pas nécessairement dans le même ordre que celui dans + lequel ils apparaissent dans le document. + </td> + </tr> + <tr> + <td>ORDERED_NODE_ITERATOR_TYPE</td> + <td>5</td> + <td> + Un ensemble de nœuds contenant tous les nœuds vérifiant l'expression. + Les nœuds du résultat sont dans le même ordre que celui dans lequel ils + apparaissent dans le document. + </td> + </tr> + <tr> + <td>UNORDERED_NODE_SNAPSHOT_TYPE</td> + <td>6</td> + <td> + Un ensemble de nœuds contenant les snapshots de tous les nœuds vérifiant + l'expression. Les nœuds ne sont pas nécessairement dans le même ordre + que celui dans lequel ils apparaissent dans le document. + </td> + </tr> + <tr> + <td>ORDERED_NODE_SNAPSHOT_TYPE</td> + <td>7</td> + <td> + Un ensemble de nœuds contenant les snapshots de tous les nœuds vérifiant + l'expression. Les nœuds du résultat sont dans le même ordre que celui + dans lequel ils apparaissent dans le document. + </td> + </tr> + <tr> + <td>ANY_UNORDERED_NODE_TYPE</td> + <td>8</td> + <td> + Un ensemble de nœuds contenant un seul nœud vérifiant l'expression. Le + nœud n'est pas nécessairement le premier dans l'ordre du document qui + correspond à l'expression. + </td> + </tr> + <tr> + <td>FIRST_ORDERED_NODE_TYPE</td> + <td>9</td> + <td> + Un ensemble de nœuds contenant le premier nœud du document vérifiant + l'expression. + </td> + </tr> + </tbody> </table> -<h2 id="Voir_aussi">Voir aussi</h2> +## Voir aussi -<ul> - <li><a href="/fr/docs/Web/XPath">XPath</a></li> - <li><a href="http://www.xml.com/pub/a/2000/08/holman/index.html?page=2#xpath-info">XML Path Language</a> de <em><a href="http://www.xml.com/pub/a/2000/08/holman/">What is XSLT?</a></em> par G. Ken Holman</li> -</ul> +- [XPath](/fr/docs/Web/XPath) +- [XML Path Language](http://www.xml.com/pub/a/2000/08/holman/index.html?page=2#xpath-info) de _[What is XSLT?](http://www.xml.com/pub/a/2000/08/holman/)_ par G. Ken Holman |