diff options
Diffstat (limited to 'files/fr/web/xslt')
17 files changed, 62 insertions, 62 deletions
diff --git a/files/fr/web/xslt/element/if/index.md b/files/fr/web/xslt/element/if/index.md index d3f7e250e2..c4a24fd131 100644 --- a/files/fr/web/xslt/element/if/index.md +++ b/files/fr/web/xslt/element/if/index.md @@ -19,7 +19,7 @@ L'élément `<xsl:if>` regroupe un attribut test et un modèle. Si le test renvo ### Attribut obligatoire - `test` - - : Contient une expression XPath qui peut être évaluée (en utilisant les règles définies pour `boolean( )` si nécessaire) en une valeur booléenne. Si la valeur est `true`, le modèle est appliqué ; dans le cas contraire, aucune action n'est exécutée. + - : Contient une expression XPath qui peut être évaluée (en utilisant les règles définies pour `boolean( )` si nécessaire) en une valeur booléenne. Si la valeur est `true`, le modèle est appliqué ; dans le cas contraire, aucune action n'est exécutée. ### Attributs optionnels diff --git a/files/fr/web/xslt/element/index.md b/files/fr/web/xslt/element/index.md index 6b7c4fa2e2..bb28c58822 100644 --- a/files/fr/web/xslt/element/index.md +++ b/files/fr/web/xslt/element/index.md @@ -5,17 +5,17 @@ tags: - Référence_XSLT translation_of: Web/XSLT/Element --- -{{ XsltRef() }} Ce document traite de deux types d'éléments : les éléments de haut niveau, et les instructions. Un élément de haut niveau doit toujours apparaître en tant qu'enfant de `<xsl:stylesheet>` ou de `<xsl:transform>`. Une instruction, de son côté, est associée à un modèle. Une feuille de style peut comporter plusieurs modèles. Un troisième type d'élément, que nous n'aborderons pas ici, est le « Literal Result Element (LRE) ». Un LRE appartient également à un modèle. Le terme regroupe tout ce qui n'est pas une instruction et qui doit être recopié tel-quel dans le document de sortie, par exemple, un élément `<hr>` dans feuille de style de conversion HTML. +{{ XsltRef() }} Ce document traite de deux types d'éléments : les éléments de haut niveau, et les instructions. Un élément de haut niveau doit toujours apparaître en tant qu'enfant de `<xsl:stylesheet>` ou de `<xsl:transform>`. Une instruction, de son côté, est associée à un modèle. Une feuille de style peut comporter plusieurs modèles. Un troisième type d'élément, que nous n'aborderons pas ici, est le « Literal Result Element (LRE) ». Un LRE appartient également à un modèle. Le terme regroupe tout ce qui n'est pas une instruction et qui doit être recopié tel-quel dans le document de sortie, par exemple, un élément `<hr>` dans feuille de style de conversion HTML. -A ce propos, tous les attributs d'un LRE et certains attributs d'un nombre limité d'éléments XSLT peuvent inclure ce que l'on appelle un modèle de valeur d'attribut. Un modèle de valeur d'attribut est simplement une chaîne qui intègre une expression XPath utilisée pour spécifier la valeur de l'attribut. Lors de l'exécution, l'expression est évaluée et le résultat de cette évaluation est substitué à l'expression XPath. Par exemple, considérons que variable « \<tt>image-dir\</tt> » est définie comme ci-dessous : +A ce propos, tous les attributs d'un LRE et certains attributs d'un nombre limité d'éléments XSLT peuvent inclure ce que l'on appelle un modèle de valeur d'attribut. Un modèle de valeur d'attribut est simplement une chaîne qui intègre une expression XPath utilisée pour spécifier la valeur de l'attribut. Lors de l'exécution, l'expression est évaluée et le résultat de cette évaluation est substitué à l'expression XPath. Par exemple, considérons que variable « \<tt>image-dir\</tt> » est définie comme ci-dessous : <xsl:variable name="image-dir">/images</xsl:variable> -L'expression a évaluer est placée entre accolades : +L'expression a évaluer est placée entre accolades : <img src="{$image-dir}/mygraphic.jpg"/> -Ce qui donnera : +Ce qui donnera : <img src="/images/mygraphic.jpg"/> diff --git a/files/fr/web/xslt/element/message/index.md b/files/fr/web/xslt/element/message/index.md index 6f3609f1c0..13640a9989 100644 --- a/files/fr/web/xslt/element/message/index.md +++ b/files/fr/web/xslt/element/message/index.md @@ -23,7 +23,7 @@ Aucun. ### Attributs optionnels - `terminate` - - : Défini à `yes`, il indique que l'exécution doit être interrompue. La valeur par défaut est `no` : dans ce cas, le message est envoyé et l'exécution se poursuit. + - : Défini à `yes`, il indique que l'exécution doit être interrompue. La valeur par défaut est `no` : dans ce cas, le message est envoyé et l'exécution se poursuit. ### Type diff --git a/files/fr/web/xslt/element/number/index.md b/files/fr/web/xslt/element/number/index.md index 3d01ed9e73..0361a57be7 100644 --- a/files/fr/web/xslt/element/number/index.md +++ b/files/fr/web/xslt/element/number/index.md @@ -36,8 +36,8 @@ Aucun. - `level` - : Définit la manière dont les niveaux de l'arbre source doivent pris en compte lors de la génération des - nombres séquentiels. Les trois valeurs possibles sont : `single`, `multiple` et - `any`. La valeur par défaut est `single` : + nombres séquentiels. Les trois valeurs possibles sont : `single`, `multiple` et + `any`. La valeur par défaut est `single` : - `single` - : Numérote de façon séquentielle les nœuds descendants d'un même parent, à la manière des éléments d'une @@ -71,7 +71,7 @@ Aucun. un des formats standards de `<xsl:number>`. - format - - : Définit le format du nombre généré : + - : Définit le format du nombre généré : - format="1" - : \<tt>1 2 3 …\</tt> (C'est le seul format supporté à ce jour) diff --git a/files/fr/web/xslt/element/sort/index.md b/files/fr/web/xslt/element/sort/index.md index 56a10f4fdd..93a75fd3c3 100644 --- a/files/fr/web/xslt/element/sort/index.md +++ b/files/fr/web/xslt/element/sort/index.md @@ -46,7 +46,7 @@ Aucun. <!----> - `data-type` - - : Définit si les éléments doivent être ordonnés alphabétiquement ou numériquement. Les valeurs autorisées sont `text` et `number` ; `text` est la valeur par défaut. + - : Définit si les éléments doivent être ordonnés alphabétiquement ou numériquement. Les valeurs autorisées sont `text` et `number` ; `text` est la valeur par défaut. ### Type diff --git a/files/fr/web/xslt/element/text/index.md b/files/fr/web/xslt/element/text/index.md index 23beb50151..bcd2b606e6 100644 --- a/files/fr/web/xslt/element/text/index.md +++ b/files/fr/web/xslt/element/text/index.md @@ -22,7 +22,7 @@ Aucun. ### Attribut optionnel -- `disable-output-escaping` (Netscape ne sérialise pas le résultat de la transformation - la « sortie » ci-dessous - aussi cet attribut importe peu dans ce contexte. Pour écrire des entités HTML, utilisez les valeurs numériques correspondantes à leur place, par exemple ` ` pour ` `). +- `disable-output-escaping` (Netscape ne sérialise pas le résultat de la transformation - la « sortie » ci-dessous - aussi cet attribut importe peu dans ce contexte. Pour écrire des entités HTML, utilisez les valeurs numériques correspondantes à leur place, par exemple ` ` pour ` `). - : Définit si les caractères spéciaux sont échappés lors de l'écriture vers la sortie. Les valeurs autorisées sont `yes` ou `no`. Si il est définit à `yes`, par exemple, le caractère \<tt>>\</tt> est envoyé tel quel ( `>` )et non comme `>`. ### Type diff --git a/files/fr/web/xslt/element/value-of/index.md b/files/fr/web/xslt/element/value-of/index.md index f9742074c4..e0086dd187 100644 --- a/files/fr/web/xslt/element/value-of/index.md +++ b/files/fr/web/xslt/element/value-of/index.md @@ -21,7 +21,7 @@ L'élément `<xsl:value-of>` évalue une expression XPath, la convertit en chaî ### Attributs optionnels -- `disable-output-escaping` (Netscape ne sérialise pas le résultat de la transformation - la « sortie » ci-dessous - aussi cet attribut importe peu dans ce contexte. Pour sortir des entités HTML, employez leurs valeurs numériques à la place, par exemple ` ` pour ` `). +- `disable-output-escaping` (Netscape ne sérialise pas le résultat de la transformation - la « sortie » ci-dessous - aussi cet attribut importe peu dans ce contexte. Pour sortir des entités HTML, employez leurs valeurs numériques à la place, par exemple ` ` pour ` `). - : Définit si les caractères spéciaux sont échappés quand ils sont écrits sur la sortie. Les valeurs autorisées sont `yes` ou `no`. Par exemple, s'il est définit à `yes`, le caractère \<tt>>\</tt> est transmis brut ( `>` ). Dans le cas contraire, c'est `>` qui serait envoyée à la sortie. ### Type diff --git a/files/fr/web/xslt/element/when/index.md b/files/fr/web/xslt/element/when/index.md index e6f51bbc3a..04ce9e3c59 100644 --- a/files/fr/web/xslt/element/when/index.md +++ b/files/fr/web/xslt/element/when/index.md @@ -19,7 +19,7 @@ L'élément `<xsl:when>` apparaît toujours dans un élément `<xsl:choose>`, et ### Attribut obligatoire - `test` - - : Définit une expression booléenne à évaluer. Si elle est vraie, le contenu de l'élément est exécuté ; sinon, il est ignoré. + - : Définit une expression booléenne à évaluer. Si elle est vraie, le contenu de l'élément est exécuté ; sinon, il est ignoré. ### Attributs obligatoires diff --git a/files/fr/web/xslt/pi_parameters/index.md b/files/fr/web/xslt/pi_parameters/index.md index 67f387db2f..8a6968f908 100644 --- a/files/fr/web/xslt/pi_parameters/index.md +++ b/files/fr/web/xslt/pi_parameters/index.md @@ -10,9 +10,9 @@ original_slug: Web/XSLT/Paramètres_des_instructions_de_traitement XSLT permet de passer des paramètres à une feuille de style lors de son exécution. C'était déjà possible depuis quelques temps dans l'[XSLTProcessor](fr/XSLTProcessor) sous JavaScript, mais pas lors de l'utilisation de l'instruction de traitement (_PI_, pour Processing Instruction) `<?xml-stylesheet?>`. -Pour résoudre cela, deux nouvelles PI (Instructions de traitement) ont été implémentées dans [Firefox 2](fr/Firefox_2) (voir {{ Anch("Versions supportées") }} plus bas pour plus de détails), `<?xslt-param?>` et `<?xslt-param-namespace?>`. Ces deux PI peuvent contenir des « pseudo attributs » de la même manière que la PI (Instruction de traitement) `xml-stylesheet`. +Pour résoudre cela, deux nouvelles PI (Instructions de traitement) ont été implémentées dans [Firefox 2](fr/Firefox_2) (voir {{ Anch("Versions supportées") }} plus bas pour plus de détails), `<?xslt-param?>` et `<?xslt-param-namespace?>`. Ces deux PI peuvent contenir des « pseudo attributs » de la même manière que la PI (Instruction de traitement) `xml-stylesheet`. -L'exemple suivant passe les deux paramètres `color` et `size` à la feuille de style style.xsl : +L'exemple suivant passe les deux paramètres `color` et `size` à la feuille de style style.xsl : <?xslt-param name="color" value="blue"?> <?xslt-param name="size" select="2"?> @@ -30,7 +30,7 @@ S'il existe plusieurs PI `xml-stylesheet` les paramètres s'appliquent à toutes #### xslt-param -La PI `xslt-param` accepte quatre attributs : +La PI `xslt-param` accepte quatre attributs : - name - : La partie locale du nom du paramètre. Aucune vérification de syntaxe n'est faite pour cet attribut. Cependant, si ce n'est pas un [NCName](http://www.w3.org/TR/REC-xml-names/#NT-NCName) valide, il ne correspondra à aucun paramètre de la feuille de style. @@ -53,19 +53,19 @@ Notez que `value="..."` n'est pas strictement égal à `select="'...'"` car valu ##### Exemples -Le paramètre `color` contient la chaîne `red` : +Le paramètre `color` contient la chaîne `red` : <?xslt-param name="color" value="red"?> -Le paramètre `columns` contient `2` : +Le paramètre `columns` contient `2` : <?xslt-param name="columns" select="2"?> -Le paramètre `books` contient l'ensemble de noeuds qui regroupe tous les éléments `<book>` de l'espace de nommage `null` : +Le paramètre `books` contient l'ensemble de noeuds qui regroupe tous les éléments `<book>` de l'espace de nommage `null` : <?xslt-param name="books" select="//book"?> -Le paramètre `show-toc<code> contient le booléen <code>true` : +Le paramètre `show-toc<code> contient le booléen <code>true` : <?xslt-param name="show-toc" select="true()"?> @@ -84,7 +84,7 @@ Si l'attribut **select** ne peut pas être analysé ou exécuté, la PI est igno #### xslt-param-namespace -`xslt-param-namespace` accepte deux attributs : +`xslt-param-namespace` accepte deux attributs : - prefix - : Le préfixe mappé. @@ -101,7 +101,7 @@ Si **namespace** est absent, la PI est ignorée. Si **namespace** est vide, le m ##### Exemples -Le paramètre `books` contient l'ensemble de noeuds qui regroupe tous les éléments `<book>` de l'espace de nommage `http://www.example.org/myNamespace` : +Le paramètre `books` contient l'ensemble de noeuds qui regroupe tous les éléments `<book>` de l'espace de nommage `http://www.example.org/myNamespace` : <?xslt-param-namespace prefix="my" namespace="http://www.example.org/myNamespace"?> <?xslt-param name="books" select="//my:book"?> @@ -112,6 +112,6 @@ Supportées depuis Firefox 2.0.0.1. Dans la version 2, l'attribut **value** est ### Possibilités de développements futurs -Devons-nous autoriser n'importe quelle fonction XSLT dans les expressions ? `document()` semble utile, mais il semble difficile de conserver le fait que `generate-id()` devrait produire la même chaîne pour un même document. +Devons-nous autoriser n'importe quelle fonction XSLT dans les expressions ? `document()` semble utile, mais il semble difficile de conserver le fait que `generate-id()` devrait produire la même chaîne pour un même document. Interwiki Language Links diff --git a/files/fr/web/xslt/transforming_xml_with_xslt/an_overview/index.md b/files/fr/web/xslt/transforming_xml_with_xslt/an_overview/index.md index d7f67a3742..e33eafd76f 100644 --- a/files/fr/web/xslt/transforming_xml_with_xslt/an_overview/index.md +++ b/files/fr/web/xslt/transforming_xml_with_xslt/an_overview/index.md @@ -17,7 +17,7 @@ L'eXtensible Stylesheet Language/Transform est un langage très puissant, et une - Une feuille de styles XSLT est identifiée comme telle par un en-tête XSLT standard. - : L'élément externe dans une feuille de styles XSLT doit être l'élément \<xsl:stylesheet> (ou éventuellement l'élément `<xsl:transform>`). Cet élément inclut au moins une déclaration d'espace de nommage (`namespace`) et l'attribut de version obligatoire. On peut également inclure d'autres espaces de nommage et trois attributs optionnels. - L'espace de nommage imposé pour XSLT est "http\://www\.w3.org/1999/XSL/Transform". - - : Les espaces de nommages sont une source de confusion importante dans XML. Bien qu'ils semblent souvent être des URI, ils ne se réfèrent pas à une ressource située à cette adresse. Ils sont uniquement un moyen d'attribuer un identifiant unique à un ensemble d'éléments connus. La chaîne "http\://www\.w3.org/1999/XSL/Transform" est une constante qui marque les éléments ainsi désignés comme appartenant à l'ensemble des balises définies par le W3C dans sa recommandation XSLT de 1999. Une autre chaîne occasionnellement utilisée dans les feuilles de styles, "http\://www\.w3.org/TR/WD-xsl", indique la conformité avec un des premiers brouillons de travail (Working Draft en anglais, d'où le WD) du document du W3C. Ce dernier espace de nommage n'est pas compatible avec celui que la W3C a adopté et il n'est pas supporté par Netscape. Comme saisir la chaîne "http\://www\.w3.org/1999/XSL/Transform" à chaque fois serait pénible et rendrait la balisage difficile à lire, il existe un mécanisme pour assigner une abréviation à un espace de nommage dans l'en-tête de la feuille de styles. Dans sa totalité, l'élément ouvrant d'une feuille de style serait : + - : Les espaces de nommages sont une source de confusion importante dans XML. Bien qu'ils semblent souvent être des URI, ils ne se réfèrent pas à une ressource située à cette adresse. Ils sont uniquement un moyen d'attribuer un identifiant unique à un ensemble d'éléments connus. La chaîne "http\://www\.w3.org/1999/XSL/Transform" est une constante qui marque les éléments ainsi désignés comme appartenant à l'ensemble des balises définies par le W3C dans sa recommandation XSLT de 1999. Une autre chaîne occasionnellement utilisée dans les feuilles de styles, "http\://www\.w3.org/TR/WD-xsl", indique la conformité avec un des premiers brouillons de travail (Working Draft en anglais, d'où le WD) du document du W3C. Ce dernier espace de nommage n'est pas compatible avec celui que la W3C a adopté et il n'est pas supporté par Netscape. Comme saisir la chaîne "http\://www\.w3.org/1999/XSL/Transform" à chaque fois serait pénible et rendrait la balisage difficile à lire, il existe un mécanisme pour assigner une abréviation à un espace de nommage dans l'en-tête de la feuille de styles. Dans sa totalité, l'élément ouvrant d'une feuille de style serait : <!----> @@ -25,15 +25,15 @@ L'eXtensible Stylesheet Language/Transform est un langage très puissant, et une - Le pseudo attribut xmlns définit xsl comme l'abréviation du nom complet de l'espace de nommage pour ce document. Ainsi l'élément stylesheet ci-dessus est préfixé par `xsl:`. Bien que xsl soit conventionnellement utilisé, il n'est pas imposé et il est possible de choisir un autre raccourci. Les exemples de ce document utilisent tous le préfixe xsl. - Toutes les transformations XSLT sont exécutées sur les arbres, et non sur les documents. -- Le moteur de transformation XSLT, appelé le processeur, ne fonctionne pas directement sur les documents. Avant qu'une transformation ne soit effectuée, le document XML originel et la feuille de styles doivent être analysés, afin de créer une représentation abstraite de la structure du document qui sera mise en mémoire. C'est cette représentation, appelée « arbre », qui sera traitée par le processeur. L'arbre est un type de données abstrait, un modèle conceptuel que peut être implémenté de diverses façons en fonction l'analyseur et le processeur. Netscape utilise une structure d'arbre proche de celle du [DOM](fr/DOM) du W3C, mais d'autres sont également possibles. Les seules obligations concernent la disposition des objets dans l'arbre, leurs propriétés, et leurs relations. L'arbre consiste en une organisation hiérarchique de nœuds. Il peut être constitué à l'aide de sept types de nœuds : le nœud*root* (unique), des nœuds*élément*, des nœuds*text*, des nœuds*attribut*, des nœuds commentaires, des nœuds d'instructions de traitement, et des nœuds d'espaces de nommage. En haut de l'arbre on trouve le nœud racine (root). Le nœud racine ne correspond à aucune partie individuelle du document XML : il représente l'ensemble du document. En dessous du nœud racine se trouvent ses enfants, qui peuvent être des éléments, des commentaires, des instructions de traitement, etc. Certains de ces enfants peuvent également avoir leurs propres enfants, et ainsi de suite sur plusieurs niveaux. Il existe des contraintes concernant le positionnement des noeuds : par exemple, les nœuds texte ne peuvent pas avoir d'enfant. Le résultat du traitement par le processeur est également un arbre. Netscape utilise cet arbre pour créer le contenu dans la fenêtre du navigateur. +- Le moteur de transformation XSLT, appelé le processeur, ne fonctionne pas directement sur les documents. Avant qu'une transformation ne soit effectuée, le document XML originel et la feuille de styles doivent être analysés, afin de créer une représentation abstraite de la structure du document qui sera mise en mémoire. C'est cette représentation, appelée « arbre », qui sera traitée par le processeur. L'arbre est un type de données abstrait, un modèle conceptuel que peut être implémenté de diverses façons en fonction l'analyseur et le processeur. Netscape utilise une structure d'arbre proche de celle du [DOM](fr/DOM) du W3C, mais d'autres sont également possibles. Les seules obligations concernent la disposition des objets dans l'arbre, leurs propriétés, et leurs relations. L'arbre consiste en une organisation hiérarchique de nœuds. Il peut être constitué à l'aide de sept types de nœuds : le nœud*root* (unique), des nœuds*élément*, des nœuds*text*, des nœuds*attribut*, des nœuds commentaires, des nœuds d'instructions de traitement, et des nœuds d'espaces de nommage. En haut de l'arbre on trouve le nœud racine (root). Le nœud racine ne correspond à aucune partie individuelle du document XML : il représente l'ensemble du document. En dessous du nœud racine se trouvent ses enfants, qui peuvent être des éléments, des commentaires, des instructions de traitement, etc. Certains de ces enfants peuvent également avoir leurs propres enfants, et ainsi de suite sur plusieurs niveaux. Il existe des contraintes concernant le positionnement des noeuds : par exemple, les nœuds texte ne peuvent pas avoir d'enfant. Le résultat du traitement par le processeur est également un arbre. Netscape utilise cet arbre pour créer le contenu dans la fenêtre du navigateur. - XSLT est un langage déclaratif de haut niveau. - Une feuille de styles XSLT est un ensemble de règles, appelées*modèles* (templates en anglais), qui déclare chacune qu'un nœud correspondant à ce motif spécifique doit être traité de cette façon spécifique et se retrouver à cette position spécifique dans l'arbre résultat. Les détails de l'exécution sont laissés au processeur, et comme l'ordre d'exécution des règles de la feuille de styles ne peut donc être garanti, XSLT ne supporte aucune fonctionnalité pouvant provoquer un effet de bord. En cela, il se comporte comme*Lisp* ou*Scheme*. - Les emplacements dans les arbres sont spécifiés à l'aide de XPath, une recommandation du W3C. -- Les transformations dépendent de la capacité du processeur à identifier individuellement les nœuds dans l'arbre. Pour faciliter cela, le W3C a décidé d'utiliser un langage séparé, XPath, qui a également d'autres utilisations en dehors du contexte XSLT. Comme son nom l'indique, XPath définit un « chemin » (path en anglais) que le processeur doit suivre dans l'arbre pour parvenir au nœud voulu. Ce chemin se compose d'expressions spécifiques à XPath à évaluer, expressions qui peuvent contenir un certain nombre de conditions à remplir, une méthode pour associer des nœuds et/ou d'une indication de direction dans l'arbre. Vous trouverez une description complète des spécifications de XPath les plus communément utilisées avec XSLT dans les documents de la section*référence*. +- Les transformations dépendent de la capacité du processeur à identifier individuellement les nœuds dans l'arbre. Pour faciliter cela, le W3C a décidé d'utiliser un langage séparé, XPath, qui a également d'autres utilisations en dehors du contexte XSLT. Comme son nom l'indique, XPath définit un « chemin » (path en anglais) que le processeur doit suivre dans l'arbre pour parvenir au nœud voulu. Ce chemin se compose d'expressions spécifiques à XPath à évaluer, expressions qui peuvent contenir un certain nombre de conditions à remplir, une méthode pour associer des nœuds et/ou d'une indication de direction dans l'arbre. Vous trouverez une description complète des spécifications de XPath les plus communément utilisées avec XSLT dans les documents de la section*référence*. - Les conflits éventuels dans la correspondance avec les modèles sont résolus par l'utilisation d'un ensemble de règles de priorité en cascade. - En général, une règle modèle plus spécifique a la priorité sur une d'ordre plus général, et toutes choses égales par ailleurs, une règle apparaissant tard dans la feuille de style a la priorité sur celles qui se trouvent avant elle. - Les feuilles de styles peuvent être attachées à un document XML par l'intermédiaire d'une instruction de traitement. -- La méthode la plus simple pour indiquer la feuille de styles XSLT à utiliser pour traiter un document XML particulier est d'inclure une instruction de traitement dans le document XML lui-même. Par exemple, si la feuille de styles se nomme inventory.xsl et se trouve dans le même répertoire que le document XML, l'instruction de traitement dans le document pourrait ressembler à : +- La méthode la plus simple pour indiquer la feuille de styles XSLT à utiliser pour traiter un document XML particulier est d'inclure une instruction de traitement dans le document XML lui-même. Par exemple, si la feuille de styles se nomme inventory.xsl et se trouve dans le même répertoire que le document XML, l'instruction de traitement dans le document pourrait ressembler à : <!----> diff --git a/files/fr/web/xslt/transforming_xml_with_xslt/for_further_reading/index.md b/files/fr/web/xslt/transforming_xml_with_xslt/for_further_reading/index.md index f619d879e6..00e6c93825 100644 --- a/files/fr/web/xslt/transforming_xml_with_xslt/for_further_reading/index.md +++ b/files/fr/web/xslt/transforming_xml_with_xslt/for_further_reading/index.md @@ -16,9 +16,9 @@ original_slug: Web/XSLT/Transformations_XML_avec_XSLT/Autres_ressources - **XSLT: Programmer's Reference, Second Edition** - - **Auteur** : Michael H. Kay - - **Nombre de page** : 992 pages - - **Éditeur** : Wrox; 2 edition (May 3, 2001) + - **Auteur** : Michael H. Kay + - **Nombre de page** : 992 pages + - **Éditeur** : Wrox; 2 edition (May 3, 2001) - **ISBN**: 0764543814 - Michael Kay est membre du groupe de travail XSL du W3C et le développeur de son propre processeur XSLT libre, Saxon. Il est également l'auteur du seul livre sur ce sujet à avoir bénéficié d'une seconde édition. C'est un @@ -28,9 +28,9 @@ original_slug: Web/XSLT/Transformations_XML_avec_XSLT/Autres_ressources - **XSLT** - - **Auteur** : Doug Tidwell - - **Nombre de page** : 473 pages - - **Éditeur** : O'Reilly Media; 1 edition (August 15, 2001) + - **Auteur** : Doug Tidwell + - **Nombre de page** : 473 pages + - **Éditeur** : O'Reilly Media; 1 edition (August 15, 2001) - **ISBN**: 0596000537 - Doug Tidwell est un développeur senior chez IBM et un*évangéliste* reconnu des technologies XML en général. Il est l'auteur de plusieurs articles et tutoriels concernant divers aspects de XML sur l'exhaustif @@ -40,9 +40,9 @@ original_slug: Web/XSLT/Transformations_XML_avec_XSLT/Autres_ressources - **Learning XML, Second Edition** - - **Auteur** : Erik T. Ray - - **Nombre de page** : 432 pages - - **Éditeur** : O'Reilly Media; 2 edition (September 22, 2003) + - **Auteur** : Erik T. Ray + - **Nombre de page** : 432 pages + - **Éditeur** : O'Reilly Media; 2 edition (September 22, 2003) - **ISBN**: 0596004206 - Comme l'indique le titre, il s'agit d'un aperçu général de XML. Le chapitre 6 est dédié spécifiquement à XSLT. - <http://www.amazon.com/gp/product/0596004206> @@ -53,11 +53,11 @@ original_slug: Web/XSLT/Transformations_XML_avec_XSLT/Autres_ressources - **World Wide Web Consortium** - - **Page d'accueil du W3C** : <http://www.w3.org/> - - **Page de XSL** : <http://www.w3.org/Style/XSL/> - - **Recommandation XSLT 1.0** : <http://www.w3.org/TR/xslt> - - **Archive of public style (CSS and XSLT) discussions** : <http://lists.w3.org/Archives/Public/www-style/> - - **Recommandation XPath 1.0** : <http://www.w3.org/TR/xpath> + - **Page d'accueil du W3C** : <http://www.w3.org/> + - **Page de XSL** : <http://www.w3.org/Style/XSL/> + - **Recommandation XSLT 1.0** : <http://www.w3.org/TR/xslt> + - **Archive of public style (CSS and XSLT) discussions** : <http://lists.w3.org/Archives/Public/www-style/> + - **Recommandation XPath 1.0** : <http://www.w3.org/TR/xpath> - Le World Wide Web Consortium est l'organisme qui publie des recommandations sur un certain nombre de technologies Web, dont beaucoup deviennent de-facto des standards. #### Articles diff --git a/files/fr/web/xslt/transforming_xml_with_xslt/index.md b/files/fr/web/xslt/transforming_xml_with_xslt/index.md index 31319589cc..907e04a459 100644 --- a/files/fr/web/xslt/transforming_xml_with_xslt/index.md +++ b/files/fr/web/xslt/transforming_xml_with_xslt/index.md @@ -16,7 +16,7 @@ Mais au bout du compte, la plus grande partie du contenu des documents XML devra Actuellement, Gecko (le moteur de rendu de Mozilla et Firefox) supporte deux formats de feuilles de styles XML. Pour le contrôle basique de l'apparence -- fontes, couleurs, position, etc. -- Gecko utilise [CSS](fr/CSS), tiré du [DHTML](fr/DHTML). Toutes les spécifications CSS1 et la majorité des CSS2 sont supportées, le support du tout récent CSS3 est en développement. Pour plus d'information à propos de CSS, consultez le site [Eric Meyer's CSS pages](http://www.meyerweb.com/eric/css/). -Nous nous intéressons ici au second type de feuilles de styles supporté par Gecko : la feuille de style XSLT. XSLT signifie _eXtensible Stylesheet Language/Transform_. XSLT permet à un concepteur de feuilles de styles de transformer un document XML de départ de deux façons significatives : manipuler et réordonner le contenu (une réorganisation complète de celui-ci est possible si on le désire), et le transférer dans un autre format (dans le cas de Mozilla, on se concentre sur sa conversion à la volée en HTML pour permettre son affichage dans le navigateur). +Nous nous intéressons ici au second type de feuilles de styles supporté par Gecko : la feuille de style XSLT. XSLT signifie _eXtensible Stylesheet Language/Transform_. XSLT permet à un concepteur de feuilles de styles de transformer un document XML de départ de deux façons significatives : manipuler et réordonner le contenu (une réorganisation complète de celui-ci est possible si on le désire), et le transférer dans un autre format (dans le cas de Mozilla, on se concentre sur sa conversion à la volée en HTML pour permettre son affichage dans le navigateur). ### Référence XSLT/XPath diff --git a/files/fr/web/xslt/using_the_mozilla_javascript_interface_to_xsl_transformations/index.md b/files/fr/web/xslt/using_the_mozilla_javascript_interface_to_xsl_transformations/index.md index 75a50d2048..290e9ff444 100644 --- a/files/fr/web/xslt/using_the_mozilla_javascript_interface_to_xsl_transformations/index.md +++ b/files/fr/web/xslt/using_the_mozilla_javascript_interface_to_xsl_transformations/index.md @@ -11,7 +11,7 @@ Ce document décrit l'interface JavaScript pour le moteur de traitement XSLT (Tr ### Création de XSLTProcessor -Pour commencer, nous avons besoin de créer un objet [XSLTProcessor](fr/XSLTProcessor) : +Pour commencer, nous avons besoin de créer un objet [XSLTProcessor](fr/XSLTProcessor) : var processor = new XSLTProcessor(); @@ -37,7 +37,7 @@ Nous pouvons utiliser les méthodes [`transformToDocument()`](#transformToDocume #### transformToDocument -`transformToDocument()` prend un argument, le nœud source à transformer, et retourne un nouveau `Document` DOM avec les résultats de la transformation : +`transformToDocument()` prend un argument, le nœud source à transformer, et retourne un nouveau `Document` DOM avec les résultats de la transformation : var newDocument = processor.transformToDocument(domToBeTransformed); @@ -47,7 +47,7 @@ L'objet résultant est un `HTMLDocument` si la [méthode de sortie](http://www.w Nous pouvons également utiliser `transformToFragment()` qui retournera un nœud `DocumentFragment` DOM. C'est très efficace car l'adjonction d'un fragment à un autre nœud adjoint de façon transparente tous les descendants de ce fragment, et le fragment lui-même n'est pas fusionné. Les fragment sont donc utiles pour déplacer les nœuds et les stocker sans les éléments inutiles d'un objet document entier. -`transformToFragment` prend deux arguments : le document source à transformer (comme ci-dessus) et un objet `Document` qui possèdera le fragment (tous les fragments doivent être possédés par un document). +`transformToFragment` prend deux arguments : le document source à transformer (comme ci-dessus) et un objet `Document` qui possèdera le fragment (tous les fragments doivent être possédés par un document). var ownerDocument = document.implementation.createDocument("", "test", null); var newFragment = processor.transformToFragment(domToBeTransformed, ownerDocument); diff --git a/files/fr/web/xslt/xslt_js_interface_in_gecko/advanced_example/index.md b/files/fr/web/xslt/xslt_js_interface_in_gecko/advanced_example/index.md index 72c3c1d793..04a2b5512a 100644 --- a/files/fr/web/xslt/xslt_js_interface_in_gecko/advanced_example/index.md +++ b/files/fr/web/xslt/xslt_js_interface_in_gecko/advanced_example/index.md @@ -14,9 +14,9 @@ La fichier XSLT a un paramètre appelé `myOrder` que le JavaScript définit pou Une fois la transformation complétée, le résultat est ajouté au document, comme indiqué dans l'exemple. -**Figure 7 : Tri selon le contenu des divvoir l'exemple** +**Figure 7 : Tri selon le contenu des divvoir l'exemple** -_Fragment XHTML :_ +_Fragment XHTML :_ <div id="example"> <div>1</div> @@ -82,7 +82,7 @@ _JavaScript_ document.getElementById("example").appendChild(fragment) } -_Feuille de style XSL :_ +_Feuille de style XSL :_ <?xml version="1.0" encoding="UTF-8"?> <xsl:stylesheet version="1.0" xmlns="http://www.w3.org/1999/xhtml" xmlns:html="http://www.w3.org/1999/xhtml" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> diff --git a/files/fr/web/xslt/xslt_js_interface_in_gecko/basic_example/index.md b/files/fr/web/xslt/xslt_js_interface_in_gecko/basic_example/index.md index f1519ecde1..a97fc5010b 100644 --- a/files/fr/web/xslt/xslt_js_interface_in_gecko/basic_example/index.md +++ b/files/fr/web/xslt/xslt_js_interface_in_gecko/basic_example/index.md @@ -10,7 +10,7 @@ original_slug: Web/XSLT/Interface_XSLT_JS_dans_Gecko/Exemple_basique L'exemple que nous allons voir va charger un fichier XML et lui appliquer une transformation XSL. Nous utiliserons les mêmes fichiers que dans l'exemple [Génération de HTML](fr/XSLT_dans_Gecko/G%c3%a9n%c3%a9ration_de_HTML) de l'article [XSLT dans Gecko](fr/XSLT_dans_Gecko). Le fichier XML décrit un article et le fichier XSL formate les informations pour l'affichage. -**Figure 4 : fichier XML** +**Figure 4 : fichier XML** Document XML (example1.xml): @@ -28,7 +28,7 @@ Document XML (example1.xml): </myNS:Body> </myNS:Article> -**Figure 5 : feuille de style XSLT** +**Figure 5 : feuille de style XSLT** feuille de style XSL (example1.xsl): @@ -60,7 +60,7 @@ feuille de style XSL (example1.xsl): <xsl:value-of select="/myNS:Article/myNS:Title"/> </span> <br /> - Auteurs : <br /> + Auteurs : <br /> <xsl:apply-templates select="/myNS:Article/myNS:Authors/myNS:Author"/> </p> @@ -77,7 +77,7 @@ feuille de style XSL (example1.xsl): -- <xsl:value-of select="." /> <xsl:if test="@company"> - :: <strong> <xsl:value-of select="@company" /> </strong> + :: <strong> <xsl:value-of select="@company" /> </strong> </xsl:if> <br /> @@ -98,7 +98,7 @@ feuille de style XSL (example1.xsl): L'exemple charge en mémoire les deux fichiers .xsl (`xslStylesheet`) et .xml (`xmlDoc`) à l'aide de `XMLHTTPRequest` synchrone. Le fichier .xsl est alors importé (`xsltProcessor.importStylesheet(xslStylesheet)`) et la transformation exécutée (`xsltProcessor.transformToFragment(xmlDoc, document)`). Cela permet d'extraire des données après le chargement de la page, sans avoir à la rafraîchir. -**Figure 6 : Exemple voir l'exemple** +**Figure 6 : Exemple voir l'exemple** var xslStylesheet; var xsltProcessor = new XSLTProcessor(); diff --git a/files/fr/web/xslt/xslt_js_interface_in_gecko/javascript_xslt_bindings/index.md b/files/fr/web/xslt/xslt_js_interface_in_gecko/javascript_xslt_bindings/index.md index 6ba6e8e47a..1f17d449f3 100644 --- a/files/fr/web/xslt/xslt_js_interface_in_gecko/javascript_xslt_bindings/index.md +++ b/files/fr/web/xslt/xslt_js_interface_in_gecko/javascript_xslt_bindings/index.md @@ -10,7 +10,7 @@ original_slug: Web/XSLT/Interface_XSLT_JS_dans_Gecko/Les_liaisons_JavaScript_XSL JavaScript peut exécuter des transformations XSLT à travers l'objet `XSLTProcessor`. Un fois instancié, un `XSLTProcessor` a une méthode `importStylesheet` qui prend comme argument la feuille de style XSLT à utiliser pour la transformation. La feuille de style doit être passée comme un document XML, ce qui signifie que le fichier .xsl doit être chargé par la page avant d'appeler `importStylesheet`. Cela peut être fait par `XMLHttpRequest` ou par `XMLDocument.load`. -**Figure 1 : Instanciation d'un XSLTProcessor** +**Figure 1 : Instanciation d'un XSLTProcessor** var xsltProcessor = new XSLTProcessor(); @@ -25,9 +25,9 @@ JavaScript peut exécuter des transformations XSLT à travers l'objet `XSLTProce // Importation du .xsl xsltProcessor.importStylesheet(xslRef); -Pour la transformation réelle, `XSLTProcessor` requiert un document XML, qui est utilisé en conjonction avec le fichier XSL importé pour produire le résultat final. Le document XML peut être un fichier XML séparé chargé comme sur la figure 1, ou il peut être une partie d'une page existante. Pour traiter une partie du DOM d'une page, il est nécessaire de commencer par créer un document XML en mémoire. Considérons que le DOM à traiter est contenu dans un élément avec l'ID `example`, que le DOM peut être « cloné » (ou dupliqué) à l'aide de ma méthode `importNode` du document XML en mémoire. `importNode` permet le transfert d'un fragment DOM entre différents documents, dans ce cas, depuis un document HTML vers un document XML. Le premier paramètre référence le nœud DOM à dupliquer. En définissant le deuxième paramètre à `true`, il dupliquera à l'identique tous les descendants (une copie profonde). Le DOM cloné peut alors être facilement inséré dans le document XML à l'aide de `appendChild`, comme indiqué sur la figure 2. +Pour la transformation réelle, `XSLTProcessor` requiert un document XML, qui est utilisé en conjonction avec le fichier XSL importé pour produire le résultat final. Le document XML peut être un fichier XML séparé chargé comme sur la figure 1, ou il peut être une partie d'une page existante. Pour traiter une partie du DOM d'une page, il est nécessaire de commencer par créer un document XML en mémoire. Considérons que le DOM à traiter est contenu dans un élément avec l'ID `example`, que le DOM peut être « cloné » (ou dupliqué) à l'aide de ma méthode `importNode` du document XML en mémoire. `importNode` permet le transfert d'un fragment DOM entre différents documents, dans ce cas, depuis un document HTML vers un document XML. Le premier paramètre référence le nœud DOM à dupliquer. En définissant le deuxième paramètre à `true`, il dupliquera à l'identique tous les descendants (une copie profonde). Le DOM cloné peut alors être facilement inséré dans le document XML à l'aide de `appendChild`, comme indiqué sur la figure 2. -**Figure 2 : Création d'un document XML à partir d'un DOM document** +**Figure 2 : Création d'un document XML à partir d'un DOM document** // création d'u nouveau document XML en mémoire var xmlRef = document.implementation.createDocument("", "", null); @@ -43,13 +43,13 @@ Pour la transformation réelle, `XSLTProcessor` requiert un document XML, qui es Une fois la feuille de style importée, `XSLTProcessor` doit exécuter deux méthodes pour la transformations réelle, à savoir `transformToDocument()` et `transformToFragment()`. `transformToDocument()` retourne un document XML entier alors que `transformToFragment()` retourne un fragment de document qui peut être facilement ajouté à un document XML existant. Les deux prennent le document XML comme premier paramètre à transformer. `transformToFragment()` requiert un second paramètre, à savoir l'objet document qui possédera le fragment généré. Si le fragment généré est inséré dans le document HTML courant, passer document est suffisant. -**Figure 2.1 : Création d'un document XML à partir d'une chaîne 'soupe XML'** +**Figure 2.1 : Création d'un document XML à partir d'une chaîne 'soupe XML'** Alors que nous pouvons utiliser la méthode `loadXML` d'Internet Explorer pour charger une chaîne contenant du XML, nous devons faire quelques arrangements pour faire la même chose dans Mozilla. Nous devons utiliser le DomParser.no pour créer un document, car c'est géré par le*DomParser* . var parser = new DOMParser(); var doc = parser.parseFromString(aStr, "text/xml"); -**Figure 3 : Exécution de la transformation** +**Figure 3 : Exécution de la transformation** var fragment = xsltProcessor.transformToFragment(xmlRef, document); diff --git a/files/fr/web/xslt/xslt_js_interface_in_gecko/setting_parameters/index.md b/files/fr/web/xslt/xslt_js_interface_in_gecko/setting_parameters/index.md index d7f841f350..920540f401 100644 --- a/files/fr/web/xslt/xslt_js_interface_in_gecko/setting_parameters/index.md +++ b/files/fr/web/xslt/xslt_js_interface_in_gecko/setting_parameters/index.md @@ -10,15 +10,15 @@ original_slug: Web/XSLT/Interface_XSLT_JS_dans_Gecko/Définition_de_paramètres Alors que l'exécution de transformations à l'aide des fichiers .xsl et .xml pré codés est utile, la configuration du fichier .xsl par JavaScript peut l'être bien plus. Par exemple, JavaScript et XSLT peuvent être utilisés pour trier des données XML puis les afficher. L'ordre du tri pourra alterner entre le tri ascendant et le tri descendant. -XSLT fournit l'élément `xsl:param`, qui est un descendant de l'élément `xsl:stylesheet`. `XSLTProcessor()` fournit trois méthodes JavaScript pour interagir avec ces paramètres : `setParameter`, `getParameter` et `removeParameter`. Elles prennent toutes comme premier argument l'URI de l'espace de nommage de `xsl:param` (normalement, `param` tombera dans l'espace de nommage par défaut, ainsi le passer à `null` suffira). Le nom local de `xsl:param` est le second argument. `setParameter` requiert un troisième argument, à savoir la valeur à laquelle le paramètre sera défini. +XSLT fournit l'élément `xsl:param`, qui est un descendant de l'élément `xsl:stylesheet`. `XSLTProcessor()` fournit trois méthodes JavaScript pour interagir avec ces paramètres : `setParameter`, `getParameter` et `removeParameter`. Elles prennent toutes comme premier argument l'URI de l'espace de nommage de `xsl:param` (normalement, `param` tombera dans l'espace de nommage par défaut, ainsi le passer à `null` suffira). Le nom local de `xsl:param` est le second argument. `setParameter` requiert un troisième argument, à savoir la valeur à laquelle le paramètre sera défini. -**Figure 7 : Paramètres** +**Figure 7 : Paramètres** -_XSLT :_ +_XSLT :_ <xsl:param name="myOrder" /> -_JavaScript :_ +_JavaScript :_ var sortVal = xsltProcessor.getParameter(null, "monOrdre"); |