diff options
50 files changed, 2286 insertions, 1923 deletions
diff --git a/files/fr/web/xslt/element/apply-imports/index.md b/files/fr/web/xslt/element/apply-imports/index.md index b7cefacc9a..c820e9c780 100644 --- a/files/fr/web/xslt/element/apply-imports/index.md +++ b/files/fr/web/xslt/element/apply-imports/index.md @@ -6,26 +6,30 @@ tags: translation_of: Web/XSLT/Element/apply-imports original_slug: Web/XSLT/apply-imports --- -<p> {{ XsltRef() }} -</p><p><br> -L'élément <code><xsl:apply-imports></code>, utilisé la plupart du temps dans les feuilles de styles complexes, est assez mystérieux. Les règles de priorité de l'importation imposent que les règles de modèles des feuilles de styles principales aient une priorité supérieure aux règles de modèles des feuilles de styles importées. Cependant, il est parfois utile de forcer le processeur à utiliser une règle de modèle de la feuille de styles importée (de priorité plus basse) plutôt que la règle équivalente de la feuille de styles principale. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre class="eval"><xsl:apply-imports/> -</pre> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#apply-imports">XSLT 1.0, section 5.6</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supportée. -</p>
\ No newline at end of file + +L'élément `<xsl:apply-imports>`, utilisé la plupart du temps dans les feuilles de styles complexes, est assez mystérieux. Les règles de priorité de l'importation imposent que les règles de modèles des feuilles de styles principales aient une priorité supérieure aux règles de modèles des feuilles de styles importées. Cependant, il est parfois utile de forcer le processeur à utiliser une règle de modèle de la feuille de styles importée (de priorité plus basse) plutôt que la règle équivalente de la feuille de styles principale. + +### Syntaxe + + <xsl:apply-imports/> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +Aucun. + +### Type + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 5.6](http://www.w3.org/TR/xslt#apply-imports). + +### Support Gecko + +Supportée. diff --git a/files/fr/web/xslt/element/apply-templates/index.md b/files/fr/web/xslt/element/apply-templates/index.md index f936f5ba41..79fc7fcefc 100644 --- a/files/fr/web/xslt/element/apply-templates/index.md +++ b/files/fr/web/xslt/element/apply-templates/index.md @@ -6,32 +6,39 @@ tags: translation_of: Web/XSLT/Element/apply-templates original_slug: Web/XSLT/apply-templates --- -<p> {{ XsltRef() }} -</p><p><br> -L'élément <code><xsl:apply-templates></code> sélectionne un ensemble de nœuds dans l'arbre d'entrée et demande au processeur de leur appliquer les modèles appropriés. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:apply-templates select=EXPRESSION mode=NOM> - <xsl:with-param> [optionnel] - <xsl:sort> [optionnel] -</xsl:apply-templates></pre> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<dl><dt><code>select</code> -</dt><dd>Utilise une expression XPath qui spécifie les nœuds qui doivent être traités. Une astérisque (<code>*</code>) sélectionne l'ensemble des nœuds. Si cet attribut n'est pas défini, tous les nœuds enfants du nœud courant sont sélectionnés. -</dd></dl> -<dl><dt><code>mode</code> -</dt><dd>S'il existe plusieurs traitements définis pour un même nœud, permet de les différencier. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#section-Applying-Template-Rules">XSLT 1.0, section 5.4</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:apply-templates>` sélectionne un ensemble de nœuds dans l'arbre d'entrée et demande au processeur de leur appliquer les modèles appropriés. + +### Syntaxe + + <xsl:apply-templates select=EXPRESSION mode=NOM> + <xsl:with-param> [optionnel] + <xsl:sort> [optionnel] + </xsl:apply-templates> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +- `select` + - : Utilise une expression XPath qui spécifie les nœuds qui doivent être traités. Une astérisque (`*`) sélectionne l'ensemble des nœuds. Si cet attribut n'est pas défini, tous les nœuds enfants du nœud courant sont sélectionnés. + +<!----> + +- `mode` + - : S'il existe plusieurs traitements définis pour un même nœud, permet de les différencier. + +### Type + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 5.4](http://www.w3.org/TR/xslt#section-Applying-Template-Rules). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/attribute-set/index.md b/files/fr/web/xslt/element/attribute-set/index.md index cf90c35452..f8fdeaee6a 100644 --- a/files/fr/web/xslt/element/attribute-set/index.md +++ b/files/fr/web/xslt/element/attribute-set/index.md @@ -6,28 +6,34 @@ tags: translation_of: Web/XSLT/Element/attribute-set original_slug: Web/XSLT/attribute-set --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:attribute-set></code> crée un ensemble nommé d'attributs, qui peut être appliqué dans son intégralité au document de sortie, de façon similaire aux styles CSS nommés. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:attribute-set name=NOM use-attribute-sets=LISTE-DE-NOMS> - <xsl:attribute> -</xsl:attribute-set></pre> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<dl><dt><code>name</code> -</dt><dd>Définit le nom de l'ensemble d'attributs. Le nom doit être un <a href="http://www.w3.org/TR/REC-xml-names/#ns-qualnames">QName</a> valide. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<dl><dt><code>use-attribute-sets</code> -</dt><dd>Construit un ensemble d'attributs à partir d'autres ensembles d'attributs. Les noms des ensembles composants doivent être séparés par une espace et ils ne doivent pas s'inclure eux-mêmes directement ou indirectement. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Haut niveau, doit être l'enfant de <code><xsl:stylesheet></code> ou de <code><xsl:transform></code>. -</p> -<h3 id="D.C3.A9fini"> Défini </h3> -<p><a href="http://www.w3.org/TR/xslt#attribute-sets">XSLT 1.0, section 7.1.4</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:attribute-set>` crée un ensemble nommé d'attributs, qui peut être appliqué dans son intégralité au document de sortie, de façon similaire aux styles CSS nommés. + +### Syntaxe + + <xsl:attribute-set name=NOM use-attribute-sets=LISTE-DE-NOMS> + <xsl:attribute> + </xsl:attribute-set> + +### Attributs obligatoires + +- `name` + - : Définit le nom de l'ensemble d'attributs. Le nom doit être un [QName](http://www.w3.org/TR/REC-xml-names/#ns-qualnames) valide. + +### Attributs optionnels + +- `use-attribute-sets` + - : Construit un ensemble d'attributs à partir d'autres ensembles d'attributs. Les noms des ensembles composants doivent être séparés par une espace et ils ne doivent pas s'inclure eux-mêmes directement ou indirectement. + +### Type + +Haut niveau, doit être l'enfant de `<xsl:stylesheet>` ou de `<xsl:transform>`. + +### Défini + +[XSLT 1.0, section 7.1.4](http://www.w3.org/TR/xslt#attribute-sets). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/attribute/index.md b/files/fr/web/xslt/element/attribute/index.md index da5b4b3c18..561ad57f12 100644 --- a/files/fr/web/xslt/element/attribute/index.md +++ b/files/fr/web/xslt/element/attribute/index.md @@ -6,28 +6,34 @@ tags: translation_of: Web/XSLT/Element/attribute original_slug: Web/XSLT/attribute --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:attribute></code> crée un attribut dans le document de sortie, en utilisant n'importe quelle donnée accessible depuis la feuille de styles. L'élément <b>doit</b> être la première chose définie dans l'élément du document de sortie pour lequel il détermine les valeurs d'attributs. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:attribute name=NOM namespace=URI> - MODÈLE -</xsl:attribute></pre> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<dl><dt><code>name</code> -</dt><dd>Définit le nom de l'attribut à créer dans le document de sortie. Le nom doit être un <a href="http://www.w3.org/TR/REC-xml-names/#ns-qualnames">QName</a> valide. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<dl><dt><code>namespace</code> -</dt><dd>Définit l'URI de l'espace de nommage pour cet attribut dans le document de sortie. Vous ne pouvez pas définir le préfixe de l'espace de nommage correspondant avec cet élément. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle ou dans un élément <code><xsl:attribute-set></code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#creating-attributes">XSLT 1.0, section 7.1.3</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:attribute>` crée un attribut dans le document de sortie, en utilisant n'importe quelle donnée accessible depuis la feuille de styles. L'élément **doit** être la première chose définie dans l'élément du document de sortie pour lequel il détermine les valeurs d'attributs. + +### Syntaxe + + <xsl:attribute name=NOM namespace=URI> + MODÈLE + </xsl:attribute> + +### Attributs obligatoires + +- `name` + - : Définit le nom de l'attribut à créer dans le document de sortie. Le nom doit être un [QName](http://www.w3.org/TR/REC-xml-names/#ns-qualnames) valide. + +### Attributs optionnels + +- `namespace` + - : Définit l'URI de l'espace de nommage pour cet attribut dans le document de sortie. Vous ne pouvez pas définir le préfixe de l'espace de nommage correspondant avec cet élément. + +### Type + +Instruction, apparaît dans un modèle ou dans un élément `<xsl:attribute-set>`. + +### Définition + +[XSLT 1.0, section 7.1.3](http://www.w3.org/TR/xslt#creating-attributes). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/call-template/index.md b/files/fr/web/xslt/element/call-template/index.md index 90461193d3..1b94893c7c 100644 --- a/files/fr/web/xslt/element/call-template/index.md +++ b/files/fr/web/xslt/element/call-template/index.md @@ -6,27 +6,33 @@ tags: translation_of: Web/XSLT/Element/call-template original_slug: Web/XSLT/call-template --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:call-template></code> invoque un modèle nommé. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:call-template name=NOM> - <xsl:with-param> [optionnel] -</xsl:call-template> </pre> -<h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>name</code> -</dt><dd>Définit le nom du modèle à invoquer. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#named-templates">XSLT 1.0, section 6</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:call-template>` invoque un modèle nommé. + +### Syntaxe + + <xsl:call-template name=NOM> + <xsl:with-param> [optionnel] + </xsl:call-template> + +### Attribut obligatoire + +- `name` + - : Définit le nom du modèle à invoquer. + +### Attributs optionnels + +Aucun. + +### Type + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 6](http://www.w3.org/TR/xslt#named-templates). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/choose/index.md b/files/fr/web/xslt/element/choose/index.md index f3c3ddd160..bfa6a3a6d6 100644 --- a/files/fr/web/xslt/element/choose/index.md +++ b/files/fr/web/xslt/element/choose/index.md @@ -6,27 +6,33 @@ tags: translation_of: Web/XSLT/Element/choose original_slug: Web/XSLT/choose --- -<p> {{ XsltRef() }} -</p><p><br> -L'élément <code><xsl:choose></code> définit un choix parmi un certain nombre d'alternatives. Il se comporte comme l'instruction switch d'un langage procédural. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:choose> - <xsl:when> - <xsl:otherwise> [optionnel] -</<xsl:choose></pre> <h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. Il contient un ou plusieurs éléments <code><xsl:when></code>, et éventuellement un élément final <code><xsl:otherwise></code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#section-Conditional-Processing-with-xsl:choose">XSLT 1.0, section 9.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:choose>` définit un choix parmi un certain nombre d'alternatives. Il se comporte comme l'instruction switch d'un langage procédural. + +### Syntaxe + + <xsl:choose> + <xsl:when> + <xsl:otherwise> [optionnel] + </<xsl:choose> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +Aucun. + +### Type + +Instruction, apparaît dans un modèle. Il contient un ou plusieurs éléments `<xsl:when>`, et éventuellement un élément final `<xsl:otherwise>`. + +### Définition + +[XSLT 1.0, section 9.2](http://www.w3.org/TR/xslt#section-Conditional-Processing-with-xsl:choose). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/comment/index.md b/files/fr/web/xslt/element/comment/index.md index e88c37927e..6327a24ba2 100644 --- a/files/fr/web/xslt/element/comment/index.md +++ b/files/fr/web/xslt/element/comment/index.md @@ -6,26 +6,32 @@ tags: translation_of: Web/XSLT/Element/comment original_slug: Web/XSLT/comment --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:comment></code> écrit un commentaire dans le document de sortie. Il ne doit contenir que du texte. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:comment> - MODÈLE -</xsl:comment> </pre> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#section-Creating-Comments">XSLT 1.0, section 7.4</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:comment>` écrit un commentaire dans le document de sortie. Il ne doit contenir que du texte. + +### Syntaxe + + <xsl:comment> + MODÈLE + </xsl:comment> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +Aucun. + +### Type + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 7.4](http://www.w3.org/TR/xslt#section-Creating-Comments). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/copy-of/index.md b/files/fr/web/xslt/element/copy-of/index.md index fc37d479ab..9bffcafa67 100644 --- a/files/fr/web/xslt/element/copy-of/index.md +++ b/files/fr/web/xslt/element/copy-of/index.md @@ -6,26 +6,31 @@ tags: translation_of: Web/XSLT/Element/copy-of original_slug: Web/XSLT/copy-of --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:copy-of></code> fait une copie complète dans le document de sortie (incluant les nœuds enfants) de tout ce que l'élément sélectionné spécifie. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre class="eval"><xsl:copy-of select=EXPRESSION /> -</pre> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<dl><dt><code>select</code> -</dt><dd>Utilise une expression XPath qui spécifie les éléments à copier. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#copy-of">XSLT 1.0, section 11.3</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:copy-of>` fait une copie complète dans le document de sortie (incluant les nœuds enfants) de tout ce que l'élément sélectionné spécifie. + +### Syntaxe + + <xsl:copy-of select=EXPRESSION /> + +### Attributs obligatoires + +- `select` + - : Utilise une expression XPath qui spécifie les éléments à copier. + +### Attributs optionnels + +Aucun. + +### Type + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 11.3](http://www.w3.org/TR/xslt#copy-of). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/copy/index.md b/files/fr/web/xslt/element/copy/index.md index dd6d9eb162..2342a4ac9f 100644 --- a/files/fr/web/xslt/element/copy/index.md +++ b/files/fr/web/xslt/element/copy/index.md @@ -6,27 +6,33 @@ tags: translation_of: Web/XSLT/Element/copy original_slug: Web/XSLT/copy --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:copy></code> transfert une copie limitée (le nœud et tous les nœuds d'espace de nommage associés) du nœud courant vers le document de sortie. Il ne copie aucun enfant ni attribut du nœud courant. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:copy use-attribute-sets=LISTE-DE-NOMS> - MODÈLE -</xsl:copy></pre> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<dl><dt><code>use-attribute-sets</code> -</dt><dd>Liste les ensembles d'attributs qui doivent être appliqués au nœud de sortie, si c'est un élément. Les noms des ensembles doivent être séparés par des espaces. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#copying">XSLT 1.0, section 7.5</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:copy>` transfert une copie limitée (le nœud et tous les nœuds d'espace de nommage associés) du nœud courant vers le document de sortie. Il ne copie aucun enfant ni attribut du nœud courant. + +### Syntaxe + + <xsl:copy use-attribute-sets=LISTE-DE-NOMS> + MODÈLE + </xsl:copy> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +- `use-attribute-sets` + - : Liste les ensembles d'attributs qui doivent être appliqués au nœud de sortie, si c'est un élément. Les noms des ensembles doivent être séparés par des espaces. + +### Type + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 7.5](http://www.w3.org/TR/xslt#copying). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/decimal-format/index.md b/files/fr/web/xslt/element/decimal-format/index.md index 7bc9fb7434..fa8e310c23 100644 --- a/files/fr/web/xslt/element/decimal-format/index.md +++ b/files/fr/web/xslt/element/decimal-format/index.md @@ -6,66 +6,92 @@ tags: translation_of: Web/XSLT/Element/decimal-format original_slug: Web/XSLT/decimal-format --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:decimal-format></code> définit les caractères et symboles à utiliser lors de la conversion de nombres en chaînes à l'aide de la fonction <code>format-number( )</code>. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:decimal-format - name=NOM - decimal-separator=CARACTÈRE - grouping-separator=CARACTÈRE - infinity=CHAÎNE - minus-sign=CARACTÈRE - NaN=CHAÎNE - percent=CARACTÈRE - per-mille=CARACTÈRE - zero-digit=CARACTÈRE - digit=CARACTÈRE - pattern-separator=CARACTÈRE /></pre> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<dl><dt><code>name</code> -</dt><dd>Définit un nom pour ce format. -</dd></dl> -<dl><dt><code>decimal-separator</code> -</dt><dd>Définit le caractère séparateur des décimales. Le caractère par défaut est (<code>.</code>). -</dd></dl> -<dl><dt><code>grouping-separator</code> -</dt><dd>Définit le caractère séparateur des milliers. Le caractère par défaut est (<code>,</code>). -</dd></dl> -<dl><dt><code>infinity</code> -</dt><dd>Définit la chaîne utilisée pour représenter l'infini. La chaîne par défaut est "<code>Infinity</code>". -</dd></dl> -<dl><dt><code>minus-sign</code> -</dt><dd>Définit le caractère du signe moins. Le caractère par défaut est le trait d'union (<code>-</code>). -</dd></dl> -<dl><dt><code>NaN</code> -</dt><dd>Définit la chaîné utilisée lorsque la valeur n'est pas un nombre. La chaîne par défaut est "<code>NaN</code>". -</dd></dl> -<dl><dt><code>percent</code> -</dt><dd>Définit le caractère du signe pourcentage. Le caractère par défaut est (<code>%</code>). -</dd></dl> -<dl><dt><code>per-mille</code> -</dt><dd>Définit le caractère signe pour mille. Le caractère par défaut est (<code>‰</code>). -</dd></dl> -<dl><dt><code>zero-digit</code> -</dt><dd>Définit le caractère pour le chiffre 0. Le caractère par défaut est (<code>0</code>). -</dd></dl> -<dl><dt><code>digit</code> -</dt><dd>Définit le caractère représentant un nombre dans le modèle de format. Le caractère par défaut est (<code>#</code>). -</dd></dl> -<dl><dt><code>pattern-separator</code> -</dt><dd>Définit le caractère séparant les sous-modèles positifs et négatifs dans le modèle de format. Le caractère par défaut est le point-virgule (<code>;</code>). -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Haut niveau, doit être l'enfant de <code><xsl:stylesheet></code> ou de <code><xsl:transform></code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#format-number">XSLT 1.0, section 12.3</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté depuis 1.0 (Mozilla 1.0, Netscape 7.0). -</p>
\ No newline at end of file + +L'élément `<xsl:decimal-format>` définit les caractères et symboles à utiliser lors de la conversion de nombres en chaînes à l'aide de la fonction `format-number( )`. + +### Syntaxe + + <xsl:decimal-format + name=NOM + decimal-separator=CARACTÈRE + grouping-separator=CARACTÈRE + infinity=CHAÎNE + minus-sign=CARACTÈRE + NaN=CHAÎNE + percent=CARACTÈRE + per-mille=CARACTÈRE + zero-digit=CARACTÈRE + digit=CARACTÈRE + pattern-separator=CARACTÈRE /> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +- `name` + - : Définit un nom pour ce format. + +<!----> + +- `decimal-separator` + - : Définit le caractère séparateur des décimales. Le caractère par défaut est (`.`). + +<!----> + +- `grouping-separator` + - : Définit le caractère séparateur des milliers. Le caractère par défaut est (`,`). + +<!----> + +- `infinity` + - : Définit la chaîne utilisée pour représenter l'infini. La chaîne par défaut est "`Infinity`". + +<!----> + +- `minus-sign` + - : Définit le caractère du signe moins. Le caractère par défaut est le trait d'union (`-`). + +<!----> + +- `NaN` + - : Définit la chaîné utilisée lorsque la valeur n'est pas un nombre. La chaîne par défaut est "`NaN`". + +<!----> + +- `percent` + - : Définit le caractère du signe pourcentage. Le caractère par défaut est (`%`). + +<!----> + +- `per-mille` + - : Définit le caractère signe pour mille. Le caractère par défaut est (`‰`). + +<!----> + +- `zero-digit` + - : Définit le caractère pour le chiffre 0. Le caractère par défaut est (`0`). + +<!----> + +- `digit` + - : Définit le caractère représentant un nombre dans le modèle de format. Le caractère par défaut est (`#`). + +<!----> + +- `pattern-separator` + - : Définit le caractère séparant les sous-modèles positifs et négatifs dans le modèle de format. Le caractère par défaut est le point-virgule (`;`). + +### Type + +Haut niveau, doit être l'enfant de `<xsl:stylesheet>` ou de `<xsl:transform>`. + +### Définition + +[XSLT 1.0, section 12.3](http://www.w3.org/TR/xslt#format-number). + +### Support Gecko + +Supporté depuis 1.0 (Mozilla 1.0, Netscape 7.0). diff --git a/files/fr/web/xslt/element/element/index.md b/files/fr/web/xslt/element/element/index.md index 42ea4f59ce..e5cb7676bd 100644 --- a/files/fr/web/xslt/element/element/index.md +++ b/files/fr/web/xslt/element/element/index.md @@ -5,30 +5,36 @@ tags: - Référence_XSLT translation_of: Web/XSLT/Element/element --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:element></code> crée un élément dans le document de sortie. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:element name=NOM namespace=URI use-attribute-sets=LISTE-DE-NOMS > - MODÈLE -</xsl:element></pre> -<h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>name</code> -</dt><dd>Définit le nom voulu pour l'élément de sortie. Le nom doit être un QName valide. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<dl><dt><code>namespace</code> -</dt><dd>Définit l'espace de nommage de l'élément de sortie. -</dd><dt><code>use-attribute-sets</code> -</dt><dd>Liste les ensembles d'attributs nommés à utiliser dans le document de sortie. Les noms doivent être séparés par des espaces. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#section-Creating-Elements-with-xsl:element">XSLT 1.0, section 7.1.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:element>` crée un élément dans le document de sortie. + +### Syntaxe + + <xsl:element name=NOM namespace=URI use-attribute-sets=LISTE-DE-NOMS > + MODÈLE + </xsl:element> + +### Attribut obligatoire + +- `name` + - : Définit le nom voulu pour l'élément de sortie. Le nom doit être un QName valide. + +### Attributs optionnels + +- `namespace` + - : Définit l'espace de nommage de l'élément de sortie. +- `use-attribute-sets` + - : Liste les ensembles d'attributs nommés à utiliser dans le document de sortie. Les noms doivent être séparés par des espaces. + +### Type + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 7.1.2](http://www.w3.org/TR/xslt#section-Creating-Elements-with-xsl:element). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/fallback/index.md b/files/fr/web/xslt/element/fallback/index.md index 9cf3514a9e..0bf977b9b5 100644 --- a/files/fr/web/xslt/element/fallback/index.md +++ b/files/fr/web/xslt/element/fallback/index.md @@ -6,25 +6,32 @@ tags: translation_of: Web/XSLT/Element/fallback original_slug: Web/XSLT/fallback --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:fallback></code> définit le modèle à utiliser si un élément d'extension donné (ou, éventuellement, une nouvelle version) n'est pas supporté. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:fallback> - MODÈLE -</xsl:fallback></pre> <h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#fallback">XSLT 1.0, section 15</a>. -</p> -<h3 id="Gecko_support"> Gecko support </h3> -<p>Pas encore supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:fallback>` définit le modèle à utiliser si un élément d'extension donné (ou, éventuellement, une nouvelle version) n'est pas supporté. + +### Syntaxe + + <xsl:fallback> + MODÈLE + </xsl:fallback> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +Aucun. + +### Type + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 15](http://www.w3.org/TR/xslt#fallback). + +### Gecko support + +Pas encore supporté. diff --git a/files/fr/web/xslt/element/for-each/index.md b/files/fr/web/xslt/element/for-each/index.md index 24b396e9ad..531a88d895 100644 --- a/files/fr/web/xslt/element/for-each/index.md +++ b/files/fr/web/xslt/element/for-each/index.md @@ -6,27 +6,34 @@ tags: translation_of: Web/XSLT/Element/for-each original_slug: Web/XSLT/for-each --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:for-each></code> sélectionne un ensemble de nœuds et traite chacun d'eux de la même façon. Il est souvent utilisé pour des itérations sur un ensemble de nœuds ou pour changer le nœud courant. Si un ou plusieurs éléments <code><xsl:sort></code> apparaissent comme enfants de cet élément, le tri est effectué avant le traitement. Autrement, les nœuds sont traités dans l'ordre d'apparition dans le document. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:for-each select=EXPRESSION> - <xsl:sort> [optionnel] - MODÈLE -</xsl:for-each></pre> <h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>select</code> -</dt><dd>Utilise une expression XPath pour spécifier les nœuds qui doivent être traités. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#for-each">XSLT 1.0, section 8</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:for-each>` sélectionne un ensemble de nœuds et traite chacun d'eux de la même façon. Il est souvent utilisé pour des itérations sur un ensemble de nœuds ou pour changer le nœud courant. Si un ou plusieurs éléments `<xsl:sort>` apparaissent comme enfants de cet élément, le tri est effectué avant le traitement. Autrement, les nœuds sont traités dans l'ordre d'apparition dans le document. + +### Syntaxe + + <xsl:for-each select=EXPRESSION> + <xsl:sort> [optionnel] + MODÈLE + </xsl:for-each> + +### Attribut obligatoire + +- `select` + - : Utilise une expression XPath pour spécifier les nœuds qui doivent être traités. + +### Attributs optionnels + +Aucun. + +### Type + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 8](http://www.w3.org/TR/xslt#for-each). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/if/index.md b/files/fr/web/xslt/element/if/index.md index 652098adcc..d3f7e250e2 100644 --- a/files/fr/web/xslt/element/if/index.md +++ b/files/fr/web/xslt/element/if/index.md @@ -6,27 +6,33 @@ tags: translation_of: Web/XSLT/Element/if original_slug: Web/XSLT/if --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:if></code> regroupe un attribut test et un modèle. Si le test renvoie <code>true</code>, le modèle est appliqué. En cela, il est très semblable à l'instruction <code>if</code> d'autres langages. Cependant, pour simuler un <tt>if-then-else</tt>, vous devrez utilisez l'élément <code><xsl:choose></code> avec un descendant <code><xsl:when></code> et un <code><xsl:otherwise></code>. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:if test=EXPRESSION> - MODÈLE -</xsl:if></pre> -<h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>test</code> -</dt><dd>Contient une expression XPath qui peut être évaluée (en utilisant les règles définies pour <code>boolean( )</code> si nécessaire) en une valeur booléenne. Si la valeur est <code>true</code>, le modèle est appliqué ; dans le cas contraire, aucune action n'est exécutée. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#section-Conditional-Processing-with-xsl:if">XSLT 1.0 section 9.1</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:if>` regroupe un attribut test et un modèle. Si le test renvoie `true`, le modèle est appliqué. En cela, il est très semblable à l'instruction `if` d'autres langages. Cependant, pour simuler un \<tt>if-then-else\</tt>, vous devrez utilisez l'élément `<xsl:choose>` avec un descendant `<xsl:when>` et un `<xsl:otherwise>`. + +### Syntaxe + + <xsl:if test=EXPRESSION> + MODÈLE + </xsl:if> + +### 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. + +### Attributs optionnels + +Aucun. + +### Type + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0 section 9.1](http://www.w3.org/TR/xslt#section-Conditional-Processing-with-xsl:if). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/import/index.md b/files/fr/web/xslt/element/import/index.md index 88714e8faf..bda4a74cd8 100644 --- a/files/fr/web/xslt/element/import/index.md +++ b/files/fr/web/xslt/element/import/index.md @@ -6,34 +6,31 @@ tags: translation_of: Web/XSLT/Element/import original_slug: Web/XSLT/import --- -<p>{{ XsltRef() }}</p> +{{ XsltRef() }} -<p>L'élément <code><xsl:import></code> est un élément de haut niveau qui sert à importer le contenu d'une feuille de styles dans une autre. Généralement, le contenu importé a une priorité inférieure à celui de la feuille qui effectue l'importation. Ceci contraste avec <a href="/fr/docs/Web/XSLT/include"><xsl:include></a> où les contenus des deux feuilles ont exactement la même priorité.</p> +L'élément `<xsl:import>` est un élément de haut niveau qui sert à importer le contenu d'une feuille de styles dans une autre. Généralement, le contenu importé a une priorité inférieure à celui de la feuille qui effectue l'importation. Ceci contraste avec [\<xsl:include>](/fr/docs/Web/XSLT/include) où les contenus des deux feuilles ont exactement la même priorité. -<h3 id="Syntaxe">Syntaxe</h3> +### Syntaxe -<p><xsl:import href=URI /></p> +\<xsl:import href=URI /> -<h3 id="Attribut_obligatoire">Attribut obligatoire</h3> +### Attribut obligatoire -<dl> - <dt><code>href</code></dt> - <dd>Définit l'URI de la feuille de styles à importer.</dd> -</dl> +- `href` + - : Définit l'URI de la feuille de styles à importer. -<h3 id="Attributs_optionnels">Attributs optionnels</h3> +### Attributs optionnels -<p>Aucun.</p> +Aucun. -<h3 id="Type">Type</h3> +### Type -<p>Haut niveau, doit apparaître avant tout autre descendant de <code><xsl:stylesheet></code> ou de <code><xsl:transform></code> dans la feuille de styles qui effectue l'importation.</p> +Haut niveau, doit apparaître avant tout autre descendant de `<xsl:stylesheet>` ou de `<xsl:transform>` dans la feuille de styles qui effectue l'importation. +### Définition -<h3 id="Définition">Définition</h3> +[XSLT 1.0, section 2.6.2](http://www.w3.org/TR/xslt#import). -<p><a href="http://www.w3.org/TR/xslt#import">XSLT 1.0, section 2.6.2</a>.</p> +### Support Gecko -<h3 id="Support_Gecko">Support Gecko</h3> - -<p>Support presque complet, quelques problèmes avec les variables et les paramètres de haut niveau dans Mozilla 1.0.</p> +Support presque complet, quelques problèmes avec les variables et les paramètres de haut niveau dans Mozilla 1.0. diff --git a/files/fr/web/xslt/element/include/index.md b/files/fr/web/xslt/element/include/index.md index 90c5d6ccda..27b5460a4d 100644 --- a/files/fr/web/xslt/element/include/index.md +++ b/files/fr/web/xslt/element/include/index.md @@ -6,34 +6,31 @@ tags: translation_of: Web/XSLT/Element/include original_slug: Web/XSLT/include --- -<p>{{ XsltRef() }}</p> +{{ XsltRef() }} -<p>L'élément <code><xsl:include></code> fusionne les contenus de deux feuilles de styles. Contrairement à l'élément <a href="/fr/XSLT/import"><xsl:import></a>, les contenus des deux feuilles de styles fusionnées ont la même priorité.</p> +L'élément `<xsl:include>` fusionne les contenus de deux feuilles de styles. Contrairement à l'élément [\<xsl:import>](/fr/XSLT/import), les contenus des deux feuilles de styles fusionnées ont la même priorité. -<h3 id="Syntaxe">Syntaxe</h3> +### Syntaxe -<pre class="eval"><xsl:include href=URI /> -</pre> + <xsl:include href=URI /> -<h3 id="Attribut_obligatoire">Attribut obligatoire</h3> +### Attribut obligatoire -<dl> - <dt><code>href</code></dt> - <dd>Définit l'URI de la feuille de styles à inclure.</dd> -</dl> +- `href` + - : Définit l'URI de la feuille de styles à inclure. -<h3 id="Attributs_optionnels">Attributs optionnels</h3> +### Attributs optionnels -<p>Aucun.</p> +Aucun. -<h3 id="Type">Type</h3> +### Type -<p>Haut niveau, peut apparaître dans n'importe quel ordre comme enfant de <code><xsl:stylesheet></code> ou de <code><xsl:transform></code>.</p> +Haut niveau, peut apparaître dans n'importe quel ordre comme enfant de `<xsl:stylesheet>` ou de `<xsl:transform>`. -<h3 id="D.C3.A9finition">Définition</h3> +### Définition -<p><a href="http://www.w3.org/TR/xslt#include">XSLT 1.0, section 2.6.1</a>.</p> +[XSLT 1.0, section 2.6.1](http://www.w3.org/TR/xslt#include). -<h3 id="Support_Gecko">Support Gecko</h3> +### Support Gecko -<p>Supporté.</p>
\ No newline at end of file +Supporté. diff --git a/files/fr/web/xslt/element/index.md b/files/fr/web/xslt/element/index.md index 091eb80bc5..6b7c4fa2e2 100644 --- a/files/fr/web/xslt/element/index.md +++ b/files/fr/web/xslt/element/index.md @@ -5,52 +5,54 @@ tags: - Référence_XSLT translation_of: Web/XSLT/Element --- -<p> </p> -<p>{{ 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 <code><xsl:stylesheet></code> ou de <code><xsl:transform></code>. 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 <code><hr></code> dans feuille de style de conversion HTML.</p> -<p>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 :</p> -<pre class="eval"><xsl:variable name="image-dir">/images</xsl:variable> -</pre> -<p>L'expression a évaluer est placée entre accolades :</p> -<pre class="eval"><img src="{$image-dir}/mygraphic.jpg"/> -</pre> -<p>Ce qui donnera :</p> -<pre class="eval"><img src="/images/mygraphic.jpg"/> -</pre> -<p>Les définitions des éléments ci-dessous incluent une description, la syntaxe, une liste des attributs requis ou optionnels, une description du type et de la position, les sources dans la recommandation du W3C et le niveau de support actuel dans Gecko.</p> -<ul> - <li><a href="apply-imports">xsl:apply-imports</a></li> - <li><a href="apply-templates">xsl:apply-templates</a></li> - <li><a href="attribute">xsl:attribute</a></li> - <li><a href="attribute-set">xsl:attribute-set</a></li> - <li><a href="call-template">xsl:call-template</a></li> - <li><a href="choose">xsl:choose</a></li> - <li><a href="comment">xsl:comment</a></li> - <li><a href="copy">xsl:copy</a></li> - <li><a href="copy-of">xsl:copy-of</a></li> - <li><a href="decimal-format">xsl:decimal-format</a></li> - <li><a href="element">xsl:element</a></li> - <li><a href="fallback">xsl:fallback</a> <i>(non supporté)</i></li> - <li><a href="for-each">xsl:for-each</a></li> - <li><a href="if">xsl:if</a></li> - <li><a href="import">xsl:import</a> <i>(supporté)</i></li> - <li><a href="include">xsl:include</a></li> - <li><a href="key">xsl:key</a></li> - <li><a href="message">xsl:message</a></li> - <li><a href="namespace-alias">xsl:namespace-alias</a> <i>(non supporté)</i></li> - <li><a href="number">xsl:number</a> <i>(partiellement supporté)</i></li> - <li><a href="otherwise">xsl:otherwise</a></li> - <li><a href="output">xsl:output</a> <i>(partiellement supporté)</i></li> - <li><a href="param">xsl:param</a></li> - <li><a href="preserve-space">xsl:preserve-space</a></li> - <li><a href="processing-instruction">xsl:processing-instruction</a></li> - <li><a href="sort">xsl:sort</a></li> - <li><a href="strip-space">xsl:strip-space</a></li> - <li><a href="stylesheet">xsl:stylesheet</a> <i>(partiellement supporté)</i></li> - <li><a href="template">xsl:template</a></li> - <li><a href="text">xsl:text</a> <i>(partiellement supporté)</i></li> - <li><a href="transform">xsl:transform</a></li> - <li><a href="value-of">xsl:value-of</a> <i>(partiellement supporté)</i></li> - <li><a href="variable">xsl:variable</a></li> - <li><a href="when">xsl:when</a></li> - <li><a href="with-param">xsl:with-param</a></li> -</ul>
\ No newline at end of file +{{ 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 : + + <xsl:variable name="image-dir">/images</xsl:variable> + +L'expression a évaluer est placée entre accolades : + + <img src="{$image-dir}/mygraphic.jpg"/> + +Ce qui donnera : + + <img src="/images/mygraphic.jpg"/> + +Les définitions des éléments ci-dessous incluent une description, la syntaxe, une liste des attributs requis ou optionnels, une description du type et de la position, les sources dans la recommandation du W3C et le niveau de support actuel dans Gecko. + +- [xsl:apply-imports](apply-imports) +- [xsl:apply-templates](apply-templates) +- [xsl:attribute](attribute) +- [xsl:attribute-set](attribute-set) +- [xsl:call-template](call-template) +- [xsl:choose](choose) +- [xsl:comment](comment) +- [xsl:copy](copy) +- [xsl:copy-of](copy-of) +- [xsl:decimal-format](decimal-format) +- [xsl:element](element) +- [xsl:fallback](fallback) _(non supporté)_ +- [xsl:for-each](for-each) +- [xsl:if](if) +- [xsl:import](import) _(supporté)_ +- [xsl:include](include) +- [xsl:key](key) +- [xsl:message](message) +- [xsl:namespace-alias](namespace-alias) _(non supporté)_ +- [xsl:number](number) _(partiellement supporté)_ +- [xsl:otherwise](otherwise) +- [xsl:output](output) _(partiellement supporté)_ +- [xsl:param](param) +- [xsl:preserve-space](preserve-space) +- [xsl:processing-instruction](processing-instruction) +- [xsl:sort](sort) +- [xsl:strip-space](strip-space) +- [xsl:stylesheet](stylesheet) _(partiellement supporté)_ +- [xsl:template](template) +- [xsl:text](text) _(partiellement supporté)_ +- [xsl:transform](transform) +- [xsl:value-of](value-of) _(partiellement supporté)_ +- [xsl:variable](variable) +- [xsl:when](when) +- [xsl:with-param](with-param) diff --git a/files/fr/web/xslt/element/key/index.md b/files/fr/web/xslt/element/key/index.md index 097b2c9db3..b3f5f70846 100644 --- a/files/fr/web/xslt/element/key/index.md +++ b/files/fr/web/xslt/element/key/index.md @@ -6,30 +6,36 @@ tags: translation_of: Web/XSLT/Element/key original_slug: Web/XSLT/key --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:key></code> déclare une clef nommée qui peut être utilisée dans toute la feuille de styles à l'aide de la fonction <code>key( )</code>. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:key name=NOM match=EXPRESSION - use=EXPRESSION /> </pre> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<dl><dt><code>name</code> -</dt><dd>Définit un nom pour cette clef. Le nom doit être un QName valide. -</dd><dt><code>match</code> -</dt><dd>Définit les nœuds sur lesquels cette clef est applicable. -</dd><dt><code>use</code> -</dt><dd>Définit une expression XPath qui sera utilisée pour déterminer la valeur de la clef pour chacun des nœuds sur lesquels elle est applicable. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Haut niveau, doit être l'enfant de <code><xsl:stylesheet></code> ou de <code><xsl:transform></code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#key">XSLT 1.0, section 12.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:key>` déclare une clef nommée qui peut être utilisée dans toute la feuille de styles à l'aide de la fonction `key( )`. + +### Syntaxe + + <xsl:key name=NOM match=EXPRESSION + use=EXPRESSION /> + +### Attributs obligatoires + +- `name` + - : Définit un nom pour cette clef. Le nom doit être un QName valide. +- `match` + - : Définit les nœuds sur lesquels cette clef est applicable. +- `use` + - : Définit une expression XPath qui sera utilisée pour déterminer la valeur de la clef pour chacun des nœuds sur lesquels elle est applicable. + +### Attributs optionnels + +Aucun. + +### Type + +Haut niveau, doit être l'enfant de `<xsl:stylesheet>` ou de `<xsl:transform>`. + +### Définition + +[XSLT 1.0, section 12.2](http://www.w3.org/TR/xslt#key). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/message/index.md b/files/fr/web/xslt/element/message/index.md index 17daae94a8..6f3609f1c0 100644 --- a/files/fr/web/xslt/element/message/index.md +++ b/files/fr/web/xslt/element/message/index.md @@ -6,26 +6,33 @@ tags: translation_of: Web/XSLT/Element/message original_slug: Web/XSLT/message --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:message></code> écrit un message de sortie (dans la console JavaScript) et, éventuellement, met fin à l'exécution de la feuille de styles. Il peut être utile pour le débogage. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:message terminate="yes" | "no" > - MODÈLE -</xsl:message></pre> <h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<dl><dt><code>terminate</code> -</dt><dd>Défini à <code>yes</code>, il indique que l'exécution doit être interrompue. La valeur par défaut est <code>no</code> : dans ce cas, le message est envoyé et l'exécution se poursuit. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#message">XSLT 1.0, section 13</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:message>` écrit un message de sortie (dans la console JavaScript) et, éventuellement, met fin à l'exécution de la feuille de styles. Il peut être utile pour le débogage. + +### Syntaxe + + <xsl:message terminate="yes" | "no" > + MODÈLE + </xsl:message> + +### Attributs obligatoires + +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. + +### Type + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 13](http://www.w3.org/TR/xslt#message). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/namespace-alias/index.md b/files/fr/web/xslt/element/namespace-alias/index.md index af9c1987a3..301a30cf1c 100644 --- a/files/fr/web/xslt/element/namespace-alias/index.md +++ b/files/fr/web/xslt/element/namespace-alias/index.md @@ -6,28 +6,33 @@ tags: translation_of: Web/XSLT/Element/namespace-alias original_slug: Web/XSLT/namespace-alias --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:namespace-alias></code> est un dispositif rarement utilisé qui établit une équivalence entre un espace de nommage d'une feuille de styles et un espace de nommage différent dans l'arbre de sortie. L'utilisation la plus courante de cet élément est la génération d'une feuille de styles depuis une autre feuille de styles. Pour éviter qu'un élément résultat correctement préfixé par <code>xsl:</code> (qui doit être copié tel quel dans l'arbre résultant) soit interprêté à tort par le processeur, il lui est assigné un espace de nommage temporaire qui est convenablement reconverti en l'espace de nommage XSLT dans l'arbre de sortie. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre class="eval"><xsl:namespace-alias stylesheet-prefix=NOM result-prefix=NOM /> -</pre> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<dl><dt><code>stylesheet-prefix</code> -</dt><dd>Définit l'espace de nommage temporaire. -</dd><dt><code>result-prefix</code> -</dt><dd>Définit l'espace de nommage voulu pour l'arbre de sortie. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Haut niveau, doit être l'enfant de <code><xsl:stylesheet></code> ou de <code><xsl:transform></code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#literal-result-element">XSLT 1.0, section 7.1.1</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Pas encore supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:namespace-alias>` est un dispositif rarement utilisé qui établit une équivalence entre un espace de nommage d'une feuille de styles et un espace de nommage différent dans l'arbre de sortie. L'utilisation la plus courante de cet élément est la génération d'une feuille de styles depuis une autre feuille de styles. Pour éviter qu'un élément résultat correctement préfixé par `xsl:` (qui doit être copié tel quel dans l'arbre résultant) soit interprêté à tort par le processeur, il lui est assigné un espace de nommage temporaire qui est convenablement reconverti en l'espace de nommage XSLT dans l'arbre de sortie. + +### Syntaxe + + <xsl:namespace-alias stylesheet-prefix=NOM result-prefix=NOM /> + +### Attributs obligatoires + +- `stylesheet-prefix` + - : Définit l'espace de nommage temporaire. +- `result-prefix` + - : Définit l'espace de nommage voulu pour l'arbre de sortie. + +### Attributs optionnels + +Aucun. + +### Type + +Haut niveau, doit être l'enfant de `<xsl:stylesheet>` ou de `<xsl:transform>`. + +### Définition + +[XSLT 1.0, section 7.1.1](http://www.w3.org/TR/xslt#literal-result-element). + +### Support Gecko + +Pas encore supporté. diff --git a/files/fr/web/xslt/element/number/index.md b/files/fr/web/xslt/element/number/index.md index 3eeb7869de..3d01ed9e73 100644 --- a/files/fr/web/xslt/element/number/index.md +++ b/files/fr/web/xslt/element/number/index.md @@ -2,120 +2,111 @@ title: number slug: Web/XSLT/Element/number tags: -- Référence_XSLT + - Référence_XSLT translation_of: Web/XSLT/Element/number original_slug: Web/XSLT/number --- -<p>{{ XsltRef() }}</p> -<p>L'élément <code><xsl:number></code> compte des éléments de façon séquentielle. Il peut également être utilisé - pour formater rapidement un nombre.</p> - -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:number - count=EXPRESSION - level="single" | "multiple" | "any" - from=EXPRESSION - value=EXPRESSION - format=FORMAT-CHAÎNE - lang=XML:CODE-LANG - letter-value="alphabetic" | "traditional" - grouping-separator=CARACTÈRE - grouping-size=NOMBRE /></pre> - -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> - -<p>Aucun.</p> - -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> - -<dl> - <dt><code>count</code></dt> - <dd>Définit les éléments devant être numérotés de façon séquentielle dans l'arbre source. Il utilise une expression - XPath.</dd> - <dt><code>level</code></dt> - <dd> - <p>Définit la manière dont les niveaux de l'arbre source doivent pris en compte lors de la génération des - nombres séquentiels. Les trois valeurs possibles sont : <code>single</code>, <code>multiple</code> et - <code>any</code>. La valeur par défaut est <code>single</code> :</p> - <dl> - <dt><code>single</code></dt> - <dd>Numérote de façon séquentielle les nœuds descendants d'un même parent, à la manière des éléments d'une - liste. Le processeur va au premier nœud dans l'axe <a - href="fr/XPath/Axes/ancestor-or-self"><code>ancestor-or-self</code></a> qui correspond à l'attribut - <code>count</code>, puis compte ce nœud ainsi que tous les nœuds précédents issus de son parent (il - s'arrête lorsqu'il rencontre une référence à l'attribut <code>from</code>, si il en trouve une) qui - correspond également à l'attribut <code>count</code>. Si aucune correspondance n'est trouvée, la +{{ XsltRef() }} + +L'élément `<xsl:number>` compte des éléments de façon séquentielle. Il peut également être utilisé +pour formater rapidement un nombre. + +### Syntaxe + + <xsl:number + count=EXPRESSION + level="single" | "multiple" | "any" + from=EXPRESSION + value=EXPRESSION + format=FORMAT-CHAÎNE + lang=XML:CODE-LANG + letter-value="alphabetic" | "traditional" + grouping-separator=CARACTÈRE + grouping-size=NOMBRE /> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +- `count` + - : Définit les éléments devant être numérotés de façon séquentielle dans l'arbre source. Il utilise une expression + XPath. +- `level` + + - : Définit la manière dont les niveaux de l'arbre source doivent pris en compte lors de la génération des + nombres séquentiels. Les trois valeurs possibles sont : `single`, `multiple` et + `any`. La valeur par défaut est `single` : + + - `single` + - : Numérote de façon séquentielle les nœuds descendants d'un même parent, à la manière des éléments d'une + liste. Le processeur va au premier nœud dans l'axe [`ancestor-or-self`](fr/XPath/Axes/ancestor-or-self) qui correspond à l'attribut + `count`, puis compte ce nœud ainsi que tous les nœuds précédents issus de son parent (il + s'arrête lorsqu'il rencontre une référence à l'attribut `from`, si il en trouve une) qui + correspond également à l'attribut `count`. Si aucune correspondance n'est trouvée, la séquence produite sera une liste vide. - </dd> - <dt><code>multiple</code></dt> - <dd>Numérote les nœuds avec une séquence composite qui reflète la position hiérarchique du nœud, par exemple - 1.2.2.5. (le format peut être défini avec l'attribut <code>format</code>, par exemple A.1.1). Le - processeur vérifie tous les <a href="fr/XPath/Axes/ancestor"><code>ancestors</code></a> du nœud courant + - `multiple` + - : Numérote les nœuds avec une séquence composite qui reflète la position hiérarchique du nœud, par exemple + 1.2.2.5. (le format peut être défini avec l'attribut `format`, par exemple A.1.1). Le + processeur vérifie tous les [`ancestors`](fr/XPath/Axes/ancestor) du nœud courant ainsi que le nœud lui-même, il s'arrête lorsqu'il rencontre une correspondance avec l'attribut - <code>from</code>, si il y en a une. Pour chaque nœud de la liste qui vérifie l'attribut - <code>count</code>, le processeur compte combien il possède de frères vérifiant également cet attribut, + `from`, si il y en a une. Pour chaque nœud de la liste qui vérifie l'attribut + `count`, le processeur compte combien il possède de frères vérifiant également cet attribut, et ajoute un pour le nœud lui-même. Si aucune correspondance n'est trouvée, la séquence produite sera une liste vide. - </dd> - <dt><code>any</code> (Non supporté à l'heure actuelle)</dt> - <dd>Numérote tous les nœuds vérifiant <code>count</code> de façon séquentielle, sans considération de - niveau. Les axes <a href="fr/XPath/Axes/ancestor"><code>ancestor</code></a>, <a - href="fr/XPath/Axes/self"><code>self</code></a> et <a - href="fr/XPath/Axes/preceding"><code>preceding</code></a> sont tous pris en compte. Le processeur + - `any` (Non supporté à l'heure actuelle) + - : Numérote tous les nœuds vérifiant `count` de façon séquentielle, sans considération de + niveau. Les axes [`ancestor`](fr/XPath/Axes/ancestor), [`self`](fr/XPath/Axes/self) et [`preceding`](fr/XPath/Axes/preceding) sont tous pris en compte. Le processeur débute au nœud courant et continue dans l'ordre inverse du document, s'arrêtant s'il rencontre une - correspondance avec un attribut <code>from</code>. Si aucune correspondance avec l'attribut - <code>count</code> n'est trouvé,e la séquence produite sera une liste vide. Ce niveau n'est pas supporté + correspondance avec un attribut `from`. Si aucune correspondance avec l'attribut + `count` n'est trouvé,e la séquence produite sera une liste vide. Ce niveau n'est pas supporté à l'heure actuelle. - </dd> - </dl> - </dd> - <dt>from</dt> - <dd>Définit l'endroit où la numérotation doit débuter. La séquence débute avec le premier descendant du nœud - vérifiant l'attribut <code>from</code>.</dd> - <dt>value</dt> - <dd>Applique un format donné à un nombre. C'est un moyen rapide de formater un nombre fourni par l'utilisateur dans - un des formats standards de <code><xsl:number></code>.</dd> - <dt>format</dt> - <dd> - <p>Définit le format du nombre généré :</p> - <dl> - <dt>format="1"</dt> - <dd> <tt>1 2 3 …</tt> (C'est le seul format supporté à ce jour)</dd> - <dt>format="01"</dt> - <dd> <tt>01 02 03 … 09 10 11 …</tt></dd> - <dt>format="a"</dt> - <dd> <tt>a b c … y z aa ab …</tt></dd> - <dt>format="A"</dt> - <dd> <tt>A B C … Y Z AA AB …</tt></dd> - <dt>format="i"</dt> - <dd> <tt>i ii iii iv v …</tt></dd> - <dt>format="I"</dt> - <dd> <tt>I II III IV V …</tt></dd> - </dl> - </dd> - <dt>lang (Non supporté à l'heure actuelle)</dt> - <dd>Définit les alphabets pouvant être utilisés pour les formats de numérotation basés sur les lettres.</dd> - <dt>letter-value</dt> - <dd>Permet de lever l'ambiguïté sur les séquences numérotées qui utilisent des lettres. Certaines langues possèdent + +- from + - : Définit l'endroit où la numérotation doit débuter. La séquence débute avec le premier descendant du nœud + vérifiant l'attribut `from`. +- value + - : Applique un format donné à un nombre. C'est un moyen rapide de formater un nombre fourni par l'utilisateur dans + un des formats standards de `<xsl:number>`. +- format + + - : Définit le format du nombre généré : + + - format="1" + - : \<tt>1 2 3 …\</tt> (C'est le seul format supporté à ce jour) + - format="01" + - : \<tt>01 02 03 … 09 10 11 …\</tt> + - format="a" + - : \<tt>a b c … y z aa ab …\</tt> + - format="A" + - : \<tt>A B C … Y Z AA AB …\</tt> + - format="i" + - : \<tt>i ii iii iv v …\</tt> + - format="I" + - : \<tt>I II III IV V …\</tt> + +- lang (Non supporté à l'heure actuelle) + - : Définit les alphabets pouvant être utilisés pour les formats de numérotation basés sur les lettres. +- letter-value + - : Permet de lever l'ambiguïté sur les séquences numérotées qui utilisent des lettres. Certaines langues possèdent plus d'un système de numérotation utilisant les lettres. Si deux systèmes commencent avec le même glyphe, il - peut y avoir une ambiguïté. Ce attribut peut avoir la valeur <code>alphabetic</code> ou - <code>traditional</code>. La valeur par défaut est <code>alphabetic</code>. - </dd> - <dt>grouping-separator</dt> - <dd>Définit le caractère devant être utilisé pour les séparations des groupes (par exemple, le séparateur des - milliers). Le caractère par défaut est la virgule (<code>,</code>).</dd> - <dt>grouping-size</dt> - <dd>Définit le nombre de chiffres formant un groupe. La valeur par défaut est <code>3</code>.</dd> -</dl> + peut y avoir une ambiguïté. Ce attribut peut avoir la valeur `alphabetic` ou + `traditional`. La valeur par défaut est `alphabetic`. +- grouping-separator + - : Définit le caractère devant être utilisé pour les séparations des groupes (par exemple, le séparateur des + milliers). Le caractère par défaut est la virgule (`,`). +- grouping-size + - : Définit le nombre de chiffres formant un groupe. La valeur par défaut est `3`. -<h3 id="Type"> Type </h3> +### Type -<p>Instruction, apparaît dans un modèle.</p> +Instruction, apparaît dans un modèle. -<h3 id="D.C3.A9finition"> Définition </h3> +### Définition -<p><a href="http://www.w3.org/TR/xslt#number">XSLT 1.0, section 7.7</a>.</p> +[XSLT 1.0, section 7.7](http://www.w3.org/TR/xslt#number). -<h3 id="Support_Gecko"> Support Gecko </h3> +### Support Gecko -<p>Support partiel. Voir les commentaires ci-dessus.</p>
\ No newline at end of file +Support partiel. Voir les commentaires ci-dessus. diff --git a/files/fr/web/xslt/element/otherwise/index.md b/files/fr/web/xslt/element/otherwise/index.md index e45edb94fc..e8814e2932 100644 --- a/files/fr/web/xslt/element/otherwise/index.md +++ b/files/fr/web/xslt/element/otherwise/index.md @@ -6,25 +6,32 @@ tags: translation_of: Web/XSLT/Element/otherwise original_slug: Web/XSLT/otherwise --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:otherwise></code> est utilisé pour définir une action qui doit être exécutée lorsqu'aucune condition <code><xsl:when></code> ne s'applique. Elle est comparable aux instructions <code>else</code> ou <code>default</code> d'autres langages de programmation. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:otherwise> - MODÈLE -</xsl:otherwise></pre> <h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Sous-instruction, doit apparaître comme le dernier enfant d'un élément <code><xsl:choose></code>, dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#section-Conditional-Processing-with-xsl:choose">XSLT 1.0, section 9.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:otherwise>` est utilisé pour définir une action qui doit être exécutée lorsqu'aucune condition `<xsl:when>` ne s'applique. Elle est comparable aux instructions `else` ou `default` d'autres langages de programmation. + +### Syntaxe + + <xsl:otherwise> + MODÈLE + </xsl:otherwise> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +Aucun. + +### Type + +Sous-instruction, doit apparaître comme le dernier enfant d'un élément `<xsl:choose>`, dans un modèle. + +### Définition + +[XSLT 1.0, section 9.2](http://www.w3.org/TR/xslt#section-Conditional-Processing-with-xsl:choose). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/output/index.md b/files/fr/web/xslt/element/output/index.md index 0c6a440521..61100c8121 100644 --- a/files/fr/web/xslt/element/output/index.md +++ b/files/fr/web/xslt/element/output/index.md @@ -6,62 +6,86 @@ tags: translation_of: Web/XSLT/Element/output original_slug: Web/XSLT/output --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:output></code> contrôle les caractéristiques du document de sortie. Pour fonctionner correctement dans Netscape, cet élément doit être utilisé, avec l'attribut <code>method</code>. À partir de Netscape 7.0, <code>method="text"</code> fonctionne comme prévu. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:output - method="xml" | "html" | "text" - version=CHAÎNE - encoding=CHAÎNE - omit-xml-declaration="yes" | "no" - standalone="yes" | "no" - doctype-public=CHAÎNE - doctype-system=CHAÎNE - cdata-section-elements=LISTE-DE-NOMS - indent="yes" | "no" - media-type=CHAÎNE /> -</pre> <h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attributs_optionnels"> Attributs optionnels</h3> -<dl><dt><code>method</code> -</dt><dd>Définit le format de sortie. -</dd></dl> -<dl><dt><code>version</code> -</dt><dd>Définit la valeur de l'attribut version dans la déclaration XML ou HTML du document de sortie. Cet attribut n'est utilisé qu'avec <code>method="html"</code> ou <code>method="xml"</code>. -</dd></dl> -<dl><dt><code>encoding</code> -</dt><dd>Définit la valeur de l'attribut <code>encoding</code> dans le document de sortie. -</dd></dl> -<dl><dt><code>omit-xml-declaration</code> -</dt><dd>Indique d'inclure ou non, une déclaration XML dans le document de sortie. Les valeurs possibles sont <code>yes</code> ou <code>no</code>. -</dd></dl> -<dl><dt><code>standalone</code> (Non supporté) -</dt><dd>Indique, si utilisé, qu'une déclaration autonome doit être incluse dans le document de sortie et donne sa valeur. Les valeurs possibles sont <code>yes</code> ou <code>no</code>. -</dd></dl> -<dl><dt><code>doctype-public</code> -</dt><dd>Définit la valeur de l'attribut <code>PUBLIC</code> de la déclaration du <code>DOCTYPE</code> dans le document de sortie. -</dd></dl> -<dl><dt><code>doctype-system</code> -</dt><dd>Définit la valeur de l'attribut <code>SYSTEM</code> de la déclaration du <code>DOCTYPE</code> dans le document de sortie. -</dd></dl> -<dl><dt><code>cdata-section-elements</code> -</dt><dd>Liste les éléments dont le contenu texte doit être écrit en tant que section <code>CDATA</code>. Les éléments sont séparés par des espaces. -</dd></dl> -<dl><dt><code>indent</code> (Non supporté.) -</dt><dd>Spécifie si la sortie doit indentée pour indiquer sa structure hiérarchique. -</dd></dl> -<dl><dt><code>media-type</code> (Non supporté.) -</dt><dd>Définit le type MIME du document de sortie. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Haut niveau, doit être l'enfant de <code><xsl:stylesheet></code> ou de <code><xsl:transform></code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#output">XSLT 1.0, section 16</a>. -</p> -<h3 id="Gecko_support"> Gecko support </h3> -<p>Support partiel. Voir les commentaires ci-dessus. -</p>
\ No newline at end of file + +L'élément `<xsl:output>` contrôle les caractéristiques du document de sortie. Pour fonctionner correctement dans Netscape, cet élément doit être utilisé, avec l'attribut `method`. À partir de Netscape 7.0, `method="text"` fonctionne comme prévu. + +### Syntaxe + + <xsl:output + method="xml" | "html" | "text" + version=CHAÎNE + encoding=CHAÎNE + omit-xml-declaration="yes" | "no" + standalone="yes" | "no" + doctype-public=CHAÎNE + doctype-system=CHAÎNE + cdata-section-elements=LISTE-DE-NOMS + indent="yes" | "no" + media-type=CHAÎNE /> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +- `method` + - : Définit le format de sortie. + +<!----> + +- `version` + - : Définit la valeur de l'attribut version dans la déclaration XML ou HTML du document de sortie. Cet attribut n'est utilisé qu'avec `method="html"` ou `method="xml"`. + +<!----> + +- `encoding` + - : Définit la valeur de l'attribut `encoding` dans le document de sortie. + +<!----> + +- `omit-xml-declaration` + - : Indique d'inclure ou non, une déclaration XML dans le document de sortie. Les valeurs possibles sont `yes` ou `no`. + +<!----> + +- `standalone` (Non supporté) + - : Indique, si utilisé, qu'une déclaration autonome doit être incluse dans le document de sortie et donne sa valeur. Les valeurs possibles sont `yes` ou `no`. + +<!----> + +- `doctype-public` + - : Définit la valeur de l'attribut `PUBLIC` de la déclaration du `DOCTYPE` dans le document de sortie. + +<!----> + +- `doctype-system` + - : Définit la valeur de l'attribut `SYSTEM` de la déclaration du `DOCTYPE` dans le document de sortie. + +<!----> + +- `cdata-section-elements` + - : Liste les éléments dont le contenu texte doit être écrit en tant que section `CDATA`. Les éléments sont séparés par des espaces. + +<!----> + +- `indent` (Non supporté.) + - : Spécifie si la sortie doit indentée pour indiquer sa structure hiérarchique. + +<!----> + +- `media-type` (Non supporté.) + - : Définit le type MIME du document de sortie. + +### Type + +Haut niveau, doit être l'enfant de `<xsl:stylesheet>` ou de `<xsl:transform>`. + +### Définition + +[XSLT 1.0, section 16](http://www.w3.org/TR/xslt#output). + +### Gecko support + +Support partiel. Voir les commentaires ci-dessus. diff --git a/files/fr/web/xslt/element/param/index.md b/files/fr/web/xslt/element/param/index.md index 3ccd9a0da5..bc126caca6 100644 --- a/files/fr/web/xslt/element/param/index.md +++ b/files/fr/web/xslt/element/param/index.md @@ -6,28 +6,34 @@ tags: translation_of: Web/XSLT/Element/param original_slug: Web/XSLT/param --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:param></code> définit un paramètre par son nom et, éventuellement, lui attribue une valeur par défaut. Lorsqu'il est utilisé comme élément de premier niveau, le paramètre est global. Utilisé dans un élément <code><xsl:template></code>, le paramètre est local à ce modèle. Dans ce dernier cas, il doit être le premier élément enfant du modèle. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:param name=NOM select=EXPRESSION> - MODÈLE -</xsl:param></pre> -<h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>name</code> -</dt><dd>Nomme le paramètre. Le nom doit être un QName valide. -</dd></dl> -<h3 id="Attribut_optionnel"> Attribut optionnel </h3> -<dl><dt><code>select</code> -</dt><dd>Utilise une expression XPath pour fournir une valeur par défaut si elle n'est pas spécifiée. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Instruction, peut apparaître comme élément de premier niveau ou dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#variables">XSLT 1.0, section 11</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:param>` définit un paramètre par son nom et, éventuellement, lui attribue une valeur par défaut. Lorsqu'il est utilisé comme élément de premier niveau, le paramètre est global. Utilisé dans un élément `<xsl:template>`, le paramètre est local à ce modèle. Dans ce dernier cas, il doit être le premier élément enfant du modèle. + +### Syntaxe + + <xsl:param name=NOM select=EXPRESSION> + MODÈLE + </xsl:param> + +### Attribut obligatoire + +- `name` + - : Nomme le paramètre. Le nom doit être un QName valide. + +### Attribut optionnel + +- `select` + - : Utilise une expression XPath pour fournir une valeur par défaut si elle n'est pas spécifiée. + +### Type + +Instruction, peut apparaître comme élément de premier niveau ou dans un modèle. + +### Définition + +[XSLT 1.0, section 11](http://www.w3.org/TR/xslt#variables). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/preserve-space/index.md b/files/fr/web/xslt/element/preserve-space/index.md index 66c2ddc5fc..42e99baa1e 100644 --- a/files/fr/web/xslt/element/preserve-space/index.md +++ b/files/fr/web/xslt/element/preserve-space/index.md @@ -6,26 +6,31 @@ tags: translation_of: Web/XSLT/Element/preserve-space original_slug: Web/XSLT/preserve-space --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:preserve-space></code> définit les éléments du document source pour lesquels les espaces doivent être préservées. Si il y a plus d'un élément, leurs noms doivent être séparés par des espaces. La politique par défaut est de conserver les espaces, cet élément n'est donc utile que pour contrer l'effet de <code><xsl:strip-space></code>. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre class="eval"><xsl:preserve-space elements=LISTE-DE-NOMS-D-ÉLÉMENTS /> -</pre> -<h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>elements</code> -</dt><dd>Définit les éléments pour lesquels les espaces doivent être préservées. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Haut niveau, doit être un enfant de <code><xsl:stylesheet></code> ou de <code><xsl:transform></code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#strip">XSLT 1.0, section 3.4</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:preserve-space>` définit les éléments du document source pour lesquels les espaces doivent être préservées. Si il y a plus d'un élément, leurs noms doivent être séparés par des espaces. La politique par défaut est de conserver les espaces, cet élément n'est donc utile que pour contrer l'effet de `<xsl:strip-space>`. + +### Syntaxe + + <xsl:preserve-space elements=LISTE-DE-NOMS-D-ÉLÉMENTS /> + +### Attribut obligatoire + +- `elements` + - : Définit les éléments pour lesquels les espaces doivent être préservées. + +### Attributs optionnels + +Aucun. + +### Type + +Haut niveau, doit être un enfant de `<xsl:stylesheet>` ou de `<xsl:transform>`. + +### Définition + +[XSLT 1.0, section 3.4](http://www.w3.org/TR/xslt#strip). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/processing-instruction/index.md b/files/fr/web/xslt/element/processing-instruction/index.md index f8decc6212..d39ad2bd49 100644 --- a/files/fr/web/xslt/element/processing-instruction/index.md +++ b/files/fr/web/xslt/element/processing-instruction/index.md @@ -6,27 +6,33 @@ tags: translation_of: Web/XSLT/Element/processing-instruction original_slug: Web/XSLT/processing-instruction --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:processing-instruction></code> écrit une instruction de traitement dans le document de sortie. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><code><xsl:processing-instruction name=NOM> - MODÈLE -</xsl:processing-instruction></code></pre> -<h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>name</code> -</dt><dd>Définit le nom de cette instruction de traitement. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#section-Creating-Processing-Instructions">XSLT 1.0, section 7.3</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:processing-instruction>` écrit une instruction de traitement dans le document de sortie. + +### Syntaxe + + <code><xsl:processing-instruction name=NOM> + MODÈLE + </xsl:processing-instruction></code> + +### Attribut obligatoire + +- `name` + - : Définit le nom de cette instruction de traitement. + +### Attributs optionnels + +Aucun. + +### Type + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 7.3](http://www.w3.org/TR/xslt#section-Creating-Processing-Instructions). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/sort/index.md b/files/fr/web/xslt/element/sort/index.md index 650cb1be2a..56a10f4fdd 100644 --- a/files/fr/web/xslt/element/sort/index.md +++ b/files/fr/web/xslt/element/sort/index.md @@ -6,44 +6,57 @@ tags: translation_of: Web/XSLT/Element/sort original_slug: Web/XSLT/sort --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:sort></code> définit les paramètres de tri pour des nœuds sélectionnés par <code><xsl:apply-templates></code> ou par <code><xsl:for-each></code>. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre class="eval"><xsl:sort - select=EXPRESSION - order="ascending" | "descending" - case-order="upper-first"| "lower-first" - lang=XML:LANG-CODE - data-type="text" | "number" /> -</pre> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<dl><dt><code>select</code> -</dt><dd>Utilise une expression XPath pour définir les nœuds à classer. -</dd></dl> -<dl><dt><code>order</code> -</dt><dd>Définit si les nœuds doivent être classés dans l'ordre ascendant ou descendant. La valeur par défaut est <code>ascending</code>. -</dd></dl> -<dl><dt><code>case-order</code> -</dt><dd>Indique si ce sont les majuscules ou les minuscules qui apparaitront en premier. Les valeurs autorisées sont <code>upper-first</code> et <code>lower-first</code>. -</dd></dl> -<dl><dt><code>lang</code> -</dt><dd>Définit la langue à utiliser pour le classement. -</dd></dl> -<dl><dt><code>data-type</code> -</dt><dd>Définit si les éléments doivent être ordonnés alphabétiquement ou numériquement. Les valeurs autorisées sont <code>text</code> et <code>number</code> ; <code>text</code> est la valeur par défaut. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Sous-instruction, apparaît toujours comme un enfant de <xsl:for-each>, où il doit apparaître avant le modèle lui-même, ou comme enfant de <code><xsl:apply-templates></code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<ul><li> <a href="http://www.w3.org/TR/xslt#sorting">XSLT 1.0, section 10 (en)</a>. -</li><li> <a href="http://xmlfr.org/w3c/TR/xslt/#sorting">XSLT 1.0, tri (fr)</a>. -</li></ul> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:sort>` définit les paramètres de tri pour des nœuds sélectionnés par `<xsl:apply-templates>` ou par `<xsl:for-each>`. + +### Syntaxe + + <xsl:sort + select=EXPRESSION + order="ascending" | "descending" + case-order="upper-first"| "lower-first" + lang=XML:LANG-CODE + data-type="text" | "number" /> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +- `select` + - : Utilise une expression XPath pour définir les nœuds à classer. + +<!----> + +- `order` + - : Définit si les nœuds doivent être classés dans l'ordre ascendant ou descendant. La valeur par défaut est `ascending`. + +<!----> + +- `case-order` + - : Indique si ce sont les majuscules ou les minuscules qui apparaitront en premier. Les valeurs autorisées sont `upper-first` et `lower-first`. + +<!----> + +- `lang` + - : Définit la langue à utiliser pour le classement. + +<!----> + +- `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. + +### Type + +Sous-instruction, apparaît toujours comme un enfant de \<xsl:for-each>, où il doit apparaître avant le modèle lui-même, ou comme enfant de `<xsl:apply-templates>`. + +### Définition + +- [XSLT 1.0, section 10 (en)](http://www.w3.org/TR/xslt#sorting). +- [XSLT 1.0, tri (fr)](http://xmlfr.org/w3c/TR/xslt/#sorting). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/strip-space/index.md b/files/fr/web/xslt/element/strip-space/index.md index b954133040..f6e69fbde1 100644 --- a/files/fr/web/xslt/element/strip-space/index.md +++ b/files/fr/web/xslt/element/strip-space/index.md @@ -6,26 +6,31 @@ tags: translation_of: Web/XSLT/Element/strip-space original_slug: Web/XSLT/strip-space --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:strip-space></code> définit les éléments du document source dont les noeuds descendants ne contenant que des espaces doivent être supprimés. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre class="eval"><xsl:strip-space elements=LISTE-DE-NOMS-D-ÉLÉMENTS /> -</pre> -<h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>elements</code> -</dt><dd>Définit une liste d'éléments du document source, séparés par des espaces, desquels les nœuds ne comportant que des espaces doivent être supprimés. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Haut niveau, doit être l'enfant de <code><xsl:stylesheet></code> ou de <code><xsl:transform></code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#strip">XSLT 1.0, section 3.4</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:strip-space>` définit les éléments du document source dont les noeuds descendants ne contenant que des espaces doivent être supprimés. + +### Syntaxe + + <xsl:strip-space elements=LISTE-DE-NOMS-D-ÉLÉMENTS /> + +### Attribut obligatoire + +- `elements` + - : Définit une liste d'éléments du document source, séparés par des espaces, desquels les nœuds ne comportant que des espaces doivent être supprimés. + +### Attributs optionnels + +Aucun. + +### Type + +Haut niveau, doit être l'enfant de `<xsl:stylesheet>` ou de `<xsl:transform>`. + +### Définition + +[XSLT 1.0, section 3.4](http://www.w3.org/TR/xslt#strip). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/stylesheet/index.md b/files/fr/web/xslt/element/stylesheet/index.md index 1d90b57e9c..2f47f3e8ed 100644 --- a/files/fr/web/xslt/element/stylesheet/index.md +++ b/files/fr/web/xslt/element/stylesheet/index.md @@ -6,41 +6,53 @@ tags: translation_of: Web/XSLT/Element/stylesheet original_slug: Web/XSLT/stylesheet --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:stylesheet></code> (ou son équivalent <code><xsl:transform></code>) est l'élément le plus externe d'une feuille de style, celui qui contient tout les autres éléments. -</p> -<h3 id="D.C3.A9claration_de_l.27espace_de_nommage"> Déclaration de l'espace de nommage </h3> -<p>Un pseudo-attribut est nécessaire pour identifier le document comme étant une feuille de style XSLT. Typiquement, on utilise <code>xmlns:xsl="http://www.w3.org/1999/XSL/Transform"</code>. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:stylesheet - version=NOMBRE - xmlns:xsl="http://www.w3.org/1999/XSL/Transform" - id=NOM - extension-element-prefixes=LISTE-DE-NOMS - exclude-result-prefixes=LISTE-DE-NOMS> - FEUILLE DE STYLE ENTIÈRE -</xsl:stylesheet></pre> <h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>version</code> -</dt><dd>Définit la version de XSLT requise par cette feuille de style. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<dl><dt><code>id </code>(Supporté comme dans Netscape 7.0 uniquement s'il est explicitement appelé par une DTD intégrée) -</dt><dd>Définit un identifiant <code>id</code> pour cette feuille de style. Cet attribut est le plus souvent utilisé lorsque la feuille de style est incorporée dans un autre document XML. -</dd></dl> -<dl><dt>extension-element-prefixes (Non supporté) -</dt><dd>Définit la liste des préfixes des espaces de nommage pour les éléments d'extension présent dans ce document. Les noms sont séparés par des espaces. -</dd></dl> -<dl><dt>exclude-result-prefixes -</dt><dd>Définit tous les espaces de nommage utilisés dans le document qui ne doivent pas être envoyés vers le document de sortie. Les noms sont séparés par des espaces. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Élément le plus externe de la feuille de style, obligatoire. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#stylesheet-element">XSLT 1.0, section 2.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Support partiel. Voir les commentaires ci-dessus. -</p>
\ No newline at end of file + +L'élément `<xsl:stylesheet>` (ou son équivalent `<xsl:transform>`) est l'élément le plus externe d'une feuille de style, celui qui contient tout les autres éléments. + +### Déclaration de l'espace de nommage + +Un pseudo-attribut est nécessaire pour identifier le document comme étant une feuille de style XSLT. Typiquement, on utilise `xmlns:xsl="http://www.w3.org/1999/XSL/Transform"`. + +### Syntaxe + + <xsl:stylesheet + version=NOMBRE + xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + id=NOM + extension-element-prefixes=LISTE-DE-NOMS + exclude-result-prefixes=LISTE-DE-NOMS> + FEUILLE DE STYLE ENTIÈRE + </xsl:stylesheet> + +### Attribut obligatoire + +- `version` + - : Définit la version de XSLT requise par cette feuille de style. + +### Attributs optionnels + +- `id `(Supporté comme dans Netscape 7.0 uniquement s'il est explicitement appelé par une DTD intégrée) + - : Définit un identifiant `id` pour cette feuille de style. Cet attribut est le plus souvent utilisé lorsque la feuille de style est incorporée dans un autre document XML. + +<!----> + +- extension-element-prefixes (Non supporté) + - : Définit la liste des préfixes des espaces de nommage pour les éléments d'extension présent dans ce document. Les noms sont séparés par des espaces. + +<!----> + +- exclude-result-prefixes + - : Définit tous les espaces de nommage utilisés dans le document qui ne doivent pas être envoyés vers le document de sortie. Les noms sont séparés par des espaces. + +### Type + +Élément le plus externe de la feuille de style, obligatoire. + +### Définition + +[XSLT 1.0, section 2.2](http://www.w3.org/TR/xslt#stylesheet-element). + +### Support Gecko + +Support partiel. Voir les commentaires ci-dessus. diff --git a/files/fr/web/xslt/element/template/index.md b/files/fr/web/xslt/element/template/index.md index d3a918a382..13b61ca1e8 100644 --- a/files/fr/web/xslt/element/template/index.md +++ b/files/fr/web/xslt/element/template/index.md @@ -6,40 +6,53 @@ tags: translation_of: Web/XSLT/Element/template original_slug: Web/XSLT/template --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:template></code> définit un modèle produisant une sortie. Au moins l'un des atttributs match et set doit posséder une valeur. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:template - match=MOTIF - name=NOM - mode=NOM - priority=NOMBRE> - <xsl:param> [optionnel] - MODÈLE -</xsl:template></pre> <h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<dl><dt><code>match</code> -</dt><dd>Définit le motif qui détermine les éléments auxquels ce modèle doit être appliqué. Il devient attribut obligatoire si l'attribut <code>name</code> n'est pas présent. -</dd></dl> -<dl><dt><code>name</code> -</dt><dd>Définit un nom pour ce modèle, par lequel il sera invoqué à l'aide de l'élément <code><xsl:call-template></code>. -</dd></dl> -<dl><dt><code>mode</code> -</dt><dd>Définit un mode particulier pour ce modèle, qui peut correspondre à un attribut de l'élément <code><xsl:apply-templates></code>. Utile pour traiter la même information de différentes façons. -</dd></dl> -<dl><dt><code>priority</code> -</dt><dd>Définit une priorité pour ce modèle, sous forme d'un nombre quelconque, à l'eception de <code>Infinity</code> (infini). Le processeur utilise ce nombre lorsque plusieurs modèles s'appliquent au même nœud. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Haut niveau, doit être l'enfant de <code><xsl:stylesheet></code> ou de <code><xsl:transform></code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#section-Defining-Template-Rules">XSLT 1.0, section 5.3</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:template>` définit un modèle produisant une sortie. Au moins l'un des atttributs match et set doit posséder une valeur. + +### Syntaxe + + <xsl:template + match=MOTIF + name=NOM + mode=NOM + priority=NOMBRE> + <xsl:param> [optionnel] + MODÈLE + </xsl:template> + +### Attributs obligatoires + +Aucun. + +### Attributs optionnels + +- `match` + - : Définit le motif qui détermine les éléments auxquels ce modèle doit être appliqué. Il devient attribut obligatoire si l'attribut `name` n'est pas présent. + +<!----> + +- `name` + - : Définit un nom pour ce modèle, par lequel il sera invoqué à l'aide de l'élément `<xsl:call-template>`. + +<!----> + +- `mode` + - : Définit un mode particulier pour ce modèle, qui peut correspondre à un attribut de l'élément `<xsl:apply-templates>`. Utile pour traiter la même information de différentes façons. + +<!----> + +- `priority` + - : Définit une priorité pour ce modèle, sous forme d'un nombre quelconque, à l'eception de `Infinity` (infini). Le processeur utilise ce nombre lorsque plusieurs modèles s'appliquent au même nœud. + +### Type + +Haut niveau, doit être l'enfant de `<xsl:stylesheet>` ou de `<xsl:transform>`. + +### Définition + +[XSLT 1.0, section 5.3](http://www.w3.org/TR/xslt#section-Defining-Template-Rules). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/text/index.md b/files/fr/web/xslt/element/text/index.md index 564a757336..23beb50151 100644 --- a/files/fr/web/xslt/element/text/index.md +++ b/files/fr/web/xslt/element/text/index.md @@ -6,27 +6,33 @@ tags: translation_of: Web/XSLT/Element/text original_slug: Web/XSLT/text --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:text></code> écrit un texte littéral dans l'arbre de sortie. Il peut contenir des <code>#PCDATA</code>, du texte littéral, et des références aux entités. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:text disable-output-escaping="yes" | "no"> - TEXTE -</xsl:text> </pre> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Attribut_optionnel"> Attribut optionnel </h3> -<dl><dt><code>disable-output-escaping</code> (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 <code>&#160</code> pour <code>&nbsp</code>). -</dt><dd>Définit si les caractères spéciaux sont échappés lors de l'écriture vers la sortie. Les valeurs autorisées sont <code>yes</code> ou <code>no</code>. Si il est définit à <code>yes</code>, par exemple, le caractère <tt>></tt> est envoyé tel quel ( <code>></code> )et non comme <code>&gt</code>. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#section-Creating-Text">XSLT 1.0, section 7.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté comme indiqué plus haut. -</p>
\ No newline at end of file + +L'élément `<xsl:text>` écrit un texte littéral dans l'arbre de sortie. Il peut contenir des `#PCDATA`, du texte littéral, et des références aux entités. + +### Syntaxe + + <xsl:text disable-output-escaping="yes" | "no"> + TEXTE + </xsl:text> + +### Attributs obligatoires + +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 ` `). + - : 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 + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 7.2](http://www.w3.org/TR/xslt#section-Creating-Text). + +### Support Gecko + +Supporté comme indiqué plus haut. diff --git a/files/fr/web/xslt/element/transform/index.md b/files/fr/web/xslt/element/transform/index.md index a4a405302e..2bb94bf59e 100644 --- a/files/fr/web/xslt/element/transform/index.md +++ b/files/fr/web/xslt/element/transform/index.md @@ -6,10 +6,10 @@ tags: translation_of: Web/XSLT/Element/transform original_slug: Web/XSLT/transform --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:transform></code> est l'équivalent exact de l'élément <code><a href="fr/XSLT/stylesheet"><xsl:stylesheet></a></code>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:transform>` est l'équivalent exact de l'élément [`<xsl:stylesheet>`](fr/XSLT/stylesheet). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/value-of/index.md b/files/fr/web/xslt/element/value-of/index.md index 23a00ef6c4..f9742074c4 100644 --- a/files/fr/web/xslt/element/value-of/index.md +++ b/files/fr/web/xslt/element/value-of/index.md @@ -6,27 +6,32 @@ tags: translation_of: Web/XSLT/Element/value-of original_slug: Web/XSLT/value-of --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:value-of></code> évalue une expression XPath, la convertit en chaîne et écrit cette chaîne dans l'arbre de sortie. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre class="eval"><xsl:value-of select=EXPRESSION disable-output-escaping="yes" | "no" /> -</pre> -<h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>select</code> -</dt><dd>Définit l'expression XPath à évaluer et à écrire dans l'arbre de sortie. -</dd></dl> -<h3 id="Attributs_optionnels"> Attributs optionnels </h3> -<dl><dt><code>disable-output-escaping</code> (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 <code>&#160</code> pour <code>&nbsp</code>). -</dt><dd>Définit si les caractères spéciaux sont échappés quand ils sont écrits sur la sortie. Les valeurs autorisées sont <code>yes</code> ou <code>no</code>. Par exemple, s'il est définit à <code>yes</code>, le caractère <tt>></tt> est transmis brut ( <code>></code> ). Dans le cas contraire, c'est <code>&gt</code> qui serait envoyée à la sortie. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Instruction, apparaît dans un modèle. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#value-of">XSLT 1.0, section 7.6.1</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté, comme décrit ci-dessus. -</p>
\ No newline at end of file + +L'élément `<xsl:value-of>` évalue une expression XPath, la convertit en chaîne et écrit cette chaîne dans l'arbre de sortie. + +### Syntaxe + + <xsl:value-of select=EXPRESSION disable-output-escaping="yes" | "no" /> + +### Attribut obligatoire + +- `select` + - : Définit l'expression XPath à évaluer et à écrire dans l'arbre de sortie. + +### 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 ` `). + - : 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 + +Instruction, apparaît dans un modèle. + +### Définition + +[XSLT 1.0, section 7.6.1](http://www.w3.org/TR/xslt#value-of). + +### Support Gecko + +Supporté, comme décrit ci-dessus. diff --git a/files/fr/web/xslt/element/variable/index.md b/files/fr/web/xslt/element/variable/index.md index a1b3708d24..acc68fd38d 100644 --- a/files/fr/web/xslt/element/variable/index.md +++ b/files/fr/web/xslt/element/variable/index.md @@ -6,28 +6,34 @@ tags: translation_of: Web/XSLT/Element/variable original_slug: Web/XSLT/variable --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:variable></code> déclare une variable globale ou locale dans une feuille de style et lui attribue une valeur. Comme XSLT ne permet pas d'effet de bord, une fois que la valeur de la variable est établie, elle reste la même jusqu'à ce que la variable soit hors de portée. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:variable name=NOM select=EXPRESSION > - MODÈLE -</xsl:variable> </pre> -<h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>name</code> -</dt><dd>Donne un nom à la variable. -</dd></dl> -<h3 id="Attribut_optionnel"> Attribut optionnel </h3> -<dl><dt><code>select</code> -</dt><dd>Définit la valeur de la variable à l'aide d'une expression XPath. Si l'élément contient un modèle, cet attribut est ignoré. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Premier niveau ou instruction. S'il intervient comme élément de premier niveau, la variable est de portée globale, et est accessible depuis l'ensemble du document. S'il intervient dans un modèle, la variable est de portée locale, et n'est accessible que dans le modèle dans lequel elle apparaît. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#variables">XSLT 1.0, section 11</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:variable>` déclare une variable globale ou locale dans une feuille de style et lui attribue une valeur. Comme XSLT ne permet pas d'effet de bord, une fois que la valeur de la variable est établie, elle reste la même jusqu'à ce que la variable soit hors de portée. + +### Syntaxe + + <xsl:variable name=NOM select=EXPRESSION > + MODÈLE + </xsl:variable> + +### Attribut obligatoire + +- `name` + - : Donne un nom à la variable. + +### Attribut optionnel + +- `select` + - : Définit la valeur de la variable à l'aide d'une expression XPath. Si l'élément contient un modèle, cet attribut est ignoré. + +### Type + +Premier niveau ou instruction. S'il intervient comme élément de premier niveau, la variable est de portée globale, et est accessible depuis l'ensemble du document. S'il intervient dans un modèle, la variable est de portée locale, et n'est accessible que dans le modèle dans lequel elle apparaît. + +### Définition + +[XSLT 1.0, section 11](http://www.w3.org/TR/xslt#variables). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/when/index.md b/files/fr/web/xslt/element/when/index.md index 41b54e47e4..e6f51bbc3a 100644 --- a/files/fr/web/xslt/element/when/index.md +++ b/files/fr/web/xslt/element/when/index.md @@ -6,26 +6,33 @@ tags: translation_of: Web/XSLT/Element/when original_slug: Web/XSLT/when --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:when></code> apparaît toujours dans un élément <code><xsl:choose></code>, et se comporte comme une structure conditionelle 'case'. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:when test=EXPRESSION> - MODÈLE -</xsl:when></pre> <h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>test</code> -</dt><dd>Définit une expression booléenne à évaluer. Si elle est vraie, le contenu de l'élément est exécuté ; sinon, il est ignoré. -</dd></dl> -<h3 id="Attributs_obligatoires"> Attributs obligatoires </h3> -<p>Aucun. -</p> -<h3 id="Type"> Type </h3> -<p>Sous-instruction, apparaît toujours dans un élément <code><xsl:choose></code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#section-Conditional-Processing-with-xsl:choose">XSLT 1.0, section 9.2</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:when>` apparaît toujours dans un élément `<xsl:choose>`, et se comporte comme une structure conditionelle 'case'. + +### Syntaxe + + <xsl:when test=EXPRESSION> + MODÈLE + </xsl:when> + +### 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é. + +### Attributs obligatoires + +Aucun. + +### Type + +Sous-instruction, apparaît toujours dans un élément `<xsl:choose>`. + +### Définition + +[XSLT 1.0, section 9.2](http://www.w3.org/TR/xslt#section-Conditional-Processing-with-xsl:choose). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/element/with-param/index.md b/files/fr/web/xslt/element/with-param/index.md index 81e0f38b89..9c7f036b04 100644 --- a/files/fr/web/xslt/element/with-param/index.md +++ b/files/fr/web/xslt/element/with-param/index.md @@ -6,27 +6,34 @@ tags: translation_of: Web/XSLT/Element/with-param original_slug: Web/XSLT/with-param --- -<p> {{ XsltRef() }} -</p><p>L'élément <code><xsl:with-param></code> définit la valeur d'un paramètre à passer à un modèle. -</p> -<h3 id="Syntaxe"> Syntaxe </h3> -<pre><xsl:with-param name=NOM select=EXPRESSION> - MODÈLE -</xsl:with-param></pre> <h3 id="Attribut_obligatoire"> Attribut obligatoire </h3> -<dl><dt><code>name</code> -</dt><dd>Définit un nom pour ce paramètre. -</dd></dl> -<h3 id="Attribut_optionnel"> Attribut optionnel </h3> -<dl><dt><code>select</code> -</dt><dd>Définit la valeur du paramètre à l'aide d'une expression XPath. Si l'élément contient un modèle, l'attribut est ignoré. -</dd></dl> -<h3 id="Type"> Type </h3> -<p>Sous-instruction, apparaît toujours dans un élément <code><xsl:apply-templates></code> ou un élément <code><xsl:call-template></code>. -</p> -<h3 id="D.C3.A9finition"> Définition </h3> -<p><a href="http://www.w3.org/TR/xslt#section-Passing-Parameters-to-Templates">XSLT 1.0, section 11.6</a>. -</p> -<h3 id="Support_Gecko"> Support Gecko </h3> -<p>Supporté. -</p>
\ No newline at end of file + +L'élément `<xsl:with-param>` définit la valeur d'un paramètre à passer à un modèle. + +### Syntaxe + + <xsl:with-param name=NOM select=EXPRESSION> + MODÈLE + </xsl:with-param> + +### Attribut obligatoire + +- `name` + - : Définit un nom pour ce paramètre. + +### Attribut optionnel + +- `select` + - : Définit la valeur du paramètre à l'aide d'une expression XPath. Si l'élément contient un modèle, l'attribut est ignoré. + +### Type + +Sous-instruction, apparaît toujours dans un élément `<xsl:apply-templates>` ou un élément `<xsl:call-template>`. + +### Définition + +[XSLT 1.0, section 11.6](http://www.w3.org/TR/xslt#section-Passing-Parameters-to-Templates). + +### Support Gecko + +Supporté. diff --git a/files/fr/web/xslt/index.md b/files/fr/web/xslt/index.md index 5589e0344e..2900e22481 100644 --- a/files/fr/web/xslt/index.md +++ b/files/fr/web/xslt/index.md @@ -5,76 +5,145 @@ tags: - XSLT translation_of: Web/XSLT --- -<p><strong>XSLT (eXtended Stylesheet Language Transformations)</strong>, défini au sein de la recommandation XSL du W3C, est un langage de transformation <a href="/fr/XML" title="fr/XML">XML</a> de type fonctionnel.</p> +**XSLT (eXtended Stylesheet Language Transformations)**, défini au sein de la recommandation XSL du W3C, est un langage de transformation [XML](/fr/XML "fr/XML") de type fonctionnel. -<p>L'objectif principal est la transformation d'un document <a href="/fr/XML" title="fr/XML">XML</a> vers un autre, ou un dialecte <a href="/fr/XML" title="fr/XML">XML</a> (XHTML, XSL-FO, <a href="/fr/HTML" title="fr/HTML">HTML</a>, etc.). Cependant, le langage XSLT permet aussi les transformations vers tout autre type de document, au format texte ou dans un format binaire (bien que ceci ne soit pas nativement prévu par la recommandation XSLT).</p> +L'objectif principal est la transformation d'un document [XML](/fr/XML "fr/XML") vers un autre, ou un dialecte [XML](/fr/XML "fr/XML") (XHTML, XSL-FO, [HTML](/fr/HTML "fr/HTML"), etc.). Cependant, le langage XSLT permet aussi les transformations vers tout autre type de document, au format texte ou dans un format binaire (bien que ceci ne soit pas nativement prévu par la recommandation XSLT). -<p>XSLT s'appuie sur XPath (une autre partie de la recommandation XSL) pour désigner une partie d'un arbre <a href="/fr/XML" title="fr/XML">XML</a>.</p> +XSLT s'appuie sur XPath (une autre partie de la recommandation XSL) pour désigner une partie d'un arbre [XML](/fr/XML "fr/XML"). -<p>XSLT est lui-même un dialecte <a href="/fr/XML" title="fr/XML">XML</a>. Un programme XSLT est donc, avant tout, un document <a href="/fr/XML" title="fr/XML">XML</a></p> +XSLT est lui-même un dialecte [XML](/fr/XML "fr/XML"). Un programme XSLT est donc, avant tout, un document [XML](/fr/XML "fr/XML") <table> - <tbody> - <tr> - <td> - <h4 id="Documentation"><a href="/Special:Tags?tag=XSLT&language=fr" title="Special:Tags?tag=XSLT&language=fr">Documentation</a></h4> - - <dl> - <dt><a href="/fr/XSLT/Éléments" title="fr/XSLT/Éléments">Référence des éléments XSLT</a></dt> - </dl> - - <dl> - <dt><a href="/fr/Transformations_XML_avec_XSLT" title="fr/Transformations_XML_avec_XSLT">Transformations XML avec XSLT</a></dt> - <dd><small>XSLT permet à un auteur de feuille de style de transformer un document XML primaire de deux manières significatives : en manipulant et triant le contenu, en le réordonnant si désiré, et en le transformant en un format différent.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/Utilisation_de_l'interface_JavaScript_de_Mozilla_pour_les_transformations_XSL" title="fr/Utilisation_de_l'interface_JavaScript_de_Mozilla_pour_les_transformations_XSL">Utilisation de l'interface JavaScript de Mozilla pour les transformations XSL</a></dt> - <dd><small>Ce document décrit l'interface JavaScript du moteur d'analyse XSLT dans Mozilla 1.2 et supérieur.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/XSLT/Paramètres_des_instructions_de_traitement" title="fr/XSLT/Paramètres_des_instructions_de_traitement">Spécification de paramètres à l'aide d'instructions de traitement</a></dt> - <dd><small>Firefox permet de spécifier des paramètres de feuille de style à utiliser avec l'instruction de traitement <code><?xml-stylesheet?></code>. Ceci se fait avec l'instruction <code><?xslt-param?></code> décrite dans ce document. (à traduire de <a href="/en/XSLT/PI_Parameters">en:XSLT:PI Parameters</a>)</small></dd> - </dl> - - <dl> - <dt><a href="http://www.topxml.com/xsl/tutorials/intro/">Tutoriel XSLT et XPath</a></dt> - <dd><small>Le tutoriel XSLT de TopXML présente les bases des concepts de XSLT, de sa syntaxe et sa programmation.</small></dd> - </dl> - - <dl> - <dt><a href="http://www.w3schools.com/xsl/">Tutoriel XSLT</a></dt> - <dd><small>Ce tutoriel de <a href="http://www.w3schools.com">W3Schools</a> explique comment utiliser XSLT pour transformer des document XML en d'autres formats, comme XHTML.</small></dd> - </dl> - - <dl> - <dt><a href="http://www.xml.com/pub/a/2000/08/holman/">What is XSLT?</a></dt> - <dd><small>Cette large introduction de XSLT et XPath ne nécessite aucune connaissance préalable de ces technologies et guide le lecteur à travers leur contexte, leur structure, les différents concepts et les bases de leur terminologie.</small></dd> - </dl> - - <dl> - <dt><a href="/fr/XSLT_2.0" title="fr/XSLT_2.0">XSLT 2.0</a> (Nouveau)</dt> - </dl> - - </td> - <td> - <h4 id="Communaut.C3.A9">Communauté</h4> - - <ul> - <li>Voir les forums de Mozilla…</li> - </ul> - - <p>{{ DiscussionList("dev-tech-xslt", "mozilla.dev.tech.xslt") }}</p> - - <p> </p> - - <h4 id="Sujets_li.C3.A9s">Sujets liés</h4> - - <dl> - <dd><a href="/fr/XML" title="fr/XML">XML</a>, <a href="/fr/XPath" title="fr/XPath">XPath</a></dd> - </dl> - </td> - </tr> - </tbody> + <tbody> + <tr> + <td> + <h4 id="Documentation"> + <a + href="/Special:Tags?tag=XSLT&language=fr" + title="Special:Tags?tag=XSLT&language=fr" + >Documentation</a + > + </h4> + <dl> + <dt> + <a href="/fr/XSLT/Éléments" title="fr/XSLT/Éléments" + >Référence des éléments XSLT</a + > + </dt> + </dl> + <dl> + <dt> + <a + href="/fr/Transformations_XML_avec_XSLT" + title="fr/Transformations_XML_avec_XSLT" + >Transformations XML avec XSLT</a + > + </dt> + <dd> + <small + >XSLT permet à un auteur de feuille de style de transformer un + document XML primaire de deux manières significatives : en + manipulant et triant le contenu, en le réordonnant si désiré, et + en le transformant en un format différent.</small + > + </dd> + </dl> + <dl> + <dt> + <a + href="/fr/Utilisation_de_l'interface_JavaScript_de_Mozilla_pour_les_transformations_XSL" + title="fr/Utilisation_de_l'interface_JavaScript_de_Mozilla_pour_les_transformations_XSL" + >Utilisation de l'interface JavaScript de Mozilla pour les + transformations XSL</a + > + </dt> + <dd> + <small + >Ce document décrit l'interface JavaScript du moteur d'analyse + XSLT dans Mozilla 1.2 et supérieur.</small + > + </dd> + </dl> + <dl> + <dt> + <a + href="/fr/XSLT/Paramètres_des_instructions_de_traitement" + title="fr/XSLT/Paramètres_des_instructions_de_traitement" + >Spécification de paramètres à l'aide d'instructions de + traitement</a + > + </dt> + <dd> + <small + >Firefox permet de spécifier des paramètres de feuille de style à + utiliser avec l'instruction de traitement + <code><?xml-stylesheet?></code>. Ceci se fait avec + l'instruction <code><?xslt-param?></code> décrite dans ce + document. (à traduire de + <a href="/en/XSLT/PI_Parameters">en:XSLT:PI Parameters</a>)</small + > + </dd> + </dl> + <dl> + <dt> + <a href="http://www.topxml.com/xsl/tutorials/intro/" + >Tutoriel XSLT et XPath</a + > + </dt> + <dd> + <small + >Le tutoriel XSLT de TopXML présente les bases des concepts de + XSLT, de sa syntaxe et sa programmation.</small + > + </dd> + </dl> + <dl> + <dt><a href="http://www.w3schools.com/xsl/">Tutoriel XSLT</a></dt> + <dd> + <small + >Ce tutoriel de + <a href="http://www.w3schools.com">W3Schools</a> explique comment + utiliser XSLT pour transformer des document XML en d'autres + formats, comme XHTML.</small + > + </dd> + </dl> + <dl> + <dt> + <a href="http://www.xml.com/pub/a/2000/08/holman/">What is XSLT?</a> + </dt> + <dd> + <small + >Cette large introduction de XSLT et XPath ne nécessite aucune + connaissance préalable de ces technologies et guide le lecteur à + travers leur contexte, leur structure, les différents concepts et + les bases de leur terminologie.</small + > + </dd> + </dl> + <dl> + <dt> + <a href="/fr/XSLT_2.0" title="fr/XSLT_2.0">XSLT 2.0</a> (Nouveau) + </dt> + </dl> + </td> + <td> + <h4 id="Communaut.C3.A9">Communauté</h4> + <ul> + <li>Voir les forums de Mozilla…</li> + </ul> + <p> + {{ DiscussionList("dev-tech-xslt", "mozilla.dev.tech.xslt") }} + </p> + <p> </p> + <h4 id="Sujets_li.C3.A9s">Sujets liés</h4> + <dl> + <dd> + <a href="/fr/XML" title="fr/XML">XML</a>, + <a href="/fr/XPath" title="fr/XPath">XPath</a> + </dd> + </dl> + </td> + </tr> + </tbody> </table> diff --git a/files/fr/web/xslt/index/index.md b/files/fr/web/xslt/index/index.md index ee6596dc61..0e4fb850a3 100644 --- a/files/fr/web/xslt/index/index.md +++ b/files/fr/web/xslt/index/index.md @@ -4,6 +4,6 @@ slug: Web/XSLT/Index translation_of: Web/XSLT/Index original_slug: Web/XSLT/Sommaire --- -<div>{{XSLTRef}}{{QuickLinksWithSubpages("/fr/docs/Web/XSLT")}}</div> +{{XSLTRef}}{{QuickLinksWithSubpages("/fr/docs/Web/XSLT")}} -<p>{{Index("/fr/docs/Web/XSLT")}}</p> +{{Index("/fr/docs/Web/XSLT")}} diff --git a/files/fr/web/xslt/pi_parameters/index.md b/files/fr/web/xslt/pi_parameters/index.md index 73cad1794e..67f387db2f 100644 --- a/files/fr/web/xslt/pi_parameters/index.md +++ b/files/fr/web/xslt/pi_parameters/index.md @@ -6,124 +6,112 @@ tags: translation_of: Web/XSLT/PI_Parameters original_slug: Web/XSLT/Paramètres_des_instructions_de_traitement --- -<h3 id="Pr.C3.A9sentation">Présentation</h3> +### Présentation -<p>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'<a href="fr/XSLTProcessor">XSLTProcessor</a> sous JavaScript, mais pas lors de l'utilisation de l'instruction de traitement (<em>PI</em>, pour Processing Instruction) <code><?xml-stylesheet?></code>.</p> +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?>`. -<p>Pour résoudre cela, deux nouvelles PI (Instructions de traitement) ont été implémentées dans <a href="fr/Firefox_2">Firefox 2</a> (voir {{ Anch("Versions supportées") }} plus bas pour plus de détails), <code><?xslt-param?></code> et <code><?xslt-param-namespace?></code>. Ces deux PI peuvent contenir des « pseudo attributs » de la même manière que la PI (Instruction de traitement) <code>xml-stylesheet</code>.</p> +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`. -<p>L'exemple suivant passe les deux paramètres <code>color</code> et <code>size</code> à la feuille de style style.xsl :</p> +L'exemple suivant passe les deux paramètres `color` et `size` à la feuille de style style.xsl : -<pre class="eval"><?xslt-param name="color" value="blue"?> -<?xslt-param name="size" select="2"?> -<?xml-stylesheet type="text/xsl" href="style.xsl"?> -</pre> + <?xslt-param name="color" value="blue"?> + <?xslt-param name="size" select="2"?> + <?xml-stylesheet type="text/xsl" href="style.xsl"?> -<p>Notez que ces PI n'ont aucun effet lorsque la transformation est faite à l'aide de l'objet <code>XSLTProcessor</code> en JavaScript.</p> +Notez que ces PI n'ont aucun effet lorsque la transformation est faite à l'aide de l'objet `XSLTProcessor` en JavaScript. -<h3 id="Instructions_de_traitement">Instructions de traitement</h3> +### Instructions de traitement -<p>Les attributs des PI <code>xslt-param</code> et <code>xslt-param-namespace</code> sont analysés en utilisant les règles définies dans <a href="http://www.w3.org/TR/xml-stylesheet/">xml-stylesheet</a>. Tous les attributs non reconnus sont ignorés. L'analyse d'un attribut n'échouera pas à cause de la présence d'un attribut non reconnu tant que cet attribut respecte la syntaxe définie dans <code>xml-stylesheet</code>.</p> +Les attributs des PI `xslt-param` et `xslt-param-namespace` sont analysés en utilisant les règles définies dans [xml-stylesheet](http://www.w3.org/TR/xml-stylesheet/). Tous les attributs non reconnus sont ignorés. L'analyse d'un attribut n'échouera pas à cause de la présence d'un attribut non reconnu tant que cet attribut respecte la syntaxe définie dans `xml-stylesheet`. -<p>Les deux instructions de traitement <code>xslt-param</code> et <code>xslt-param-namespace</code> doivent apparaître dans le prologue du document, c'est-à-dire avant la balise du premier élément. Toutes les PI du prologue sont exécutées, celles présentes avant une PI <code>xml-stylesheet</code> comme celles présentes après.</p> +Les deux instructions de traitement `xslt-param` et `xslt-param-namespace` doivent apparaître dans le prologue du document, c'est-à-dire avant la balise du premier élément. Toutes les PI du prologue sont exécutées, celles présentes avant une PI `xml-stylesheet` comme celles présentes après. -<p>S'il existe plusieurs PI <code>xml-stylesheet</code> les paramètres s'appliquent à toutes les feuilles de style, conséquence du fait que selon la spécification XSLT, toutes les feuilles de style sont importées concaténées en une seule feuille.reference? Notez que les PI XSLT <code>xml-stylesheet</code> multiples ne sont pas supportées par Firefox à l'heure actuelle.</p> +S'il existe plusieurs PI `xml-stylesheet` les paramètres s'appliquent à toutes les feuilles de style, conséquence du fait que selon la spécification XSLT, toutes les feuilles de style sont importées concaténées en une seule feuille.reference? Notez que les PI XSLT `xml-stylesheet` multiples ne sont pas supportées par Firefox à l'heure actuelle. -<h4 id="xslt-param">xslt-param</h4> +#### xslt-param -<p>La PI <code>xslt-param</code> accepte quatre attributs :</p> +La PI `xslt-param` accepte quatre attributs : -<dl> - <dt>name</dt> - <dd>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 <a href="http://www.w3.org/TR/REC-xml-names/#NT-NCName">NCName</a> valide, il ne correspondra à aucun paramètre de la feuille de style.</dd> - <dt>namespace</dt> - <dd>L'espace de nommage du nom du paramètre. Aucune vérification de syntaxe n'est faite pour cet attribut.</dd> - <dt>value</dt> - <dd>Contient la valeur de chaîne du paramètre. La valeur de l'attribut est utilisée comme valeur du paramètre. Le type de donnée sera toujours<em>chaîne</em>.</dd> - <dt>select</dt> - <dd>Un expression <a href="fr/XPath">XPath</a> pour le paramètre. La valeur de cet attribut est analysée comme une expressions XPath. Le résultat de l'évaluation de l'expression est utilisé comme valeur pour le paramètre.</dd> -</dl> +- 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. +- namespace + - : L'espace de nommage du nom du paramètre. Aucune vérification de syntaxe n'est faite pour cet attribut. +- value + - : Contient la valeur de chaîne du paramètre. La valeur de l'attribut est utilisée comme valeur du paramètre. Le type de donnée sera toujours*chaîne*. +- select + - : Un expression [XPath](fr/XPath) pour le paramètre. La valeur de cet attribut est analysée comme une expressions XPath. Le résultat de l'évaluation de l'expression est utilisé comme valeur pour le paramètre. -<p>Si l'attribut <strong>name</strong> est absent ou vide, la PI est ignorée.</p> +Si l'attribut **name** est absent ou vide, la PI est ignorée. -<p>Si l'attribut <strong>namespace</strong> est absent ou vide, l'espace de nommage <code>null</code> est utilisé.</p> +Si l'attribut **namespace** est absent ou vide, l'espace de nommage `null` est utilisé. -<p>Spécifier un nom de paramètre qui n'existe pas dans la feuille de style (ou qui soit une variable dans la feuille de style) n'est pas une erreur. La PI est simplement ignorée dans ce cas.</p> +Spécifier un nom de paramètre qui n'existe pas dans la feuille de style (ou qui soit une variable dans la feuille de style) n'est pas une erreur. La PI est simplement ignorée dans ce cas. -<p>Si les attributs <strong>value</strong> et <strong>select</strong> sont tous deux présents (ou absents) la PI est ignorée.</p> +Si les attributs **value** et **select** sont tous deux présents (ou absents) la PI est ignorée. -<p>Notez que <code>value="..."</code> n'est pas strictement égal à <code>select="'...'"</code> car value peut contenir à la fois des caractères apostrophe et des caractères guillemet.</p> +Notez que `value="..."` n'est pas strictement égal à `select="'...'"` car value peut contenir à la fois des caractères apostrophe et des caractères guillemet. -<h5 id="Exemples">Exemples</h5> +##### Exemples -<p>Le paramètre <code>color</code> contient la chaîne <code>red</code> :</p> +Le paramètre `color` contient la chaîne `red` : -<pre class="eval"><?xslt-param name="color" value="red"?> -</pre> + <?xslt-param name="color" value="red"?> -<p>Le paramètre <code>columns</code> contient <code>2</code> :</p> +Le paramètre `columns` contient `2` : -<pre class="eval"><?xslt-param name="columns" select="2"?> -</pre> + <?xslt-param name="columns" select="2"?> -<p>Le paramètre <code>books</code> contient l'ensemble de noeuds qui regroupe tous les éléments <code><book></code> de l'espace de nommage <code>null</code> :</p> +Le paramètre `books` contient l'ensemble de noeuds qui regroupe tous les éléments `<book>` de l'espace de nommage `null` : -<pre class="eval"><?xslt-param name="books" select="//book"?> -</pre> + <?xslt-param name="books" select="//book"?> -<p>Le paramètre <code>show-toc<code> contient le booléen <code>true</code> :</p> +Le paramètre `show-toc<code> contient le booléen <code>true` : -<pre class="eval"> <?xslt-param name="show-toc" select="true()"?> -</pre> + <?xslt-param name="show-toc" select="true()"?> -<h5 id="Le_contexte_de_l.27attribut_select">Le contexte de l'attribut<em>select</em></h5> +##### Le contexte de l'attribut*select* -<p>Le contexte suivant est utilisé pour analyser et évaluer l'expression de l'attribut <strong>select</strong>.</p> +Le contexte suivant est utilisé pour analyser et évaluer l'expression de l'attribut **select**. -<ul> - <li>Le nœud de contexte est le nœud utilisé comme nœud courant initial lors de l'exécution de la feuille de style.</li> - <li>La position du contexte est la position du noeud de contexte dans la liste initiale de nœuds courants utilisée lors de l'exécution de la feuille de style.</li> - <li>La taille du contexte est la taille de la liste initiale de nœuds courants utilisée lors de l'exécution de la feuille de style.</li> - <li>Aucune variable n'est disponible.</li> - <li>La bibliothèque de fonctions est la bibliothèque standard de fonctions XPath.</li> - <li>Les déclarations d'espace de nommage sont déterminées par les PI <code>xslt-param-namespace</code>, voir ci-dessous.</li> -</ul> +- Le nœud de contexte est le nœud utilisé comme nœud courant initial lors de l'exécution de la feuille de style. +- La position du contexte est la position du noeud de contexte dans la liste initiale de nœuds courants utilisée lors de l'exécution de la feuille de style. +- La taille du contexte est la taille de la liste initiale de nœuds courants utilisée lors de l'exécution de la feuille de style. +- Aucune variable n'est disponible. +- La bibliothèque de fonctions est la bibliothèque standard de fonctions XPath. +- Les déclarations d'espace de nommage sont déterminées par les PI `xslt-param-namespace`, voir ci-dessous. -<p>Si l'attribut <strong>select</strong> ne peut pas être analysé ou exécuté, la PI est ignorée (en particulier, l'attribut <strong>value</strong> ne sera pas utilisé comme valeur de secours).</p> +Si l'attribut **select** ne peut pas être analysé ou exécuté, la PI est ignorée (en particulier, l'attribut **value** ne sera pas utilisé comme valeur de secours). -<h4 id="xslt-param-namespace">xslt-param-namespace</h4> +#### xslt-param-namespace -<p><code>xslt-param-namespace</code> accepte deux attributs :</p> +`xslt-param-namespace` accepte deux attributs : -<dl> - <dt>prefix</dt> - <dd>Le préfixe mappé.</dd> - <dt>namespace</dt> - <dd>L'espace de nommage vers lequel le préfixe mappe.</dd> -</dl> +- prefix + - : Le préfixe mappé. +- namespace + - : L'espace de nommage vers lequel le préfixe mappe. -<p>Une PI <code>xslt-param-namespace</code> affecte l'expression de l'attribut <strong>select</strong> de tous les <code>xslt-param</code> qui la suivent. Cela s'applique même s'il y a d'autres nœuds tels que des commentaires ou d'autres PI entre les PI <code>xslt-param-namespace</code> et <code>xslt-param</code>.</p> +Une PI `xslt-param-namespace` affecte l'expression de l'attribut **select** de tous les `xslt-param` qui la suivent. Cela s'applique même s'il y a d'autres nœuds tels que des commentaires ou d'autres PI entre les PI `xslt-param-namespace` et `xslt-param`. -<p>Utiliser le même préfixe pour plusieurs instructions de traitement n'est pas une erreur, chaque nouvelle PI ne fait que changer l'espace de nommage vers lequel le préfixe renvoie.</p> +Utiliser le même préfixe pour plusieurs instructions de traitement n'est pas une erreur, chaque nouvelle PI ne fait que changer l'espace de nommage vers lequel le préfixe renvoie. -<p>Si <strong>prefix</strong> est absent, vide ou égal un à NCName invalide, la PI est ignorée.</p> +Si **prefix** est absent, vide ou égal un à NCName invalide, la PI est ignorée. -<p>Si <strong>namespace</strong> est absent, la PI est ignorée. Si <strong>namespace</strong> est vide, le mappage du préfixe est supprimé.</p> +Si **namespace** est absent, la PI est ignorée. Si **namespace** est vide, le mappage du préfixe est supprimé. -<h5 id="Exemples_2">Exemples</h5> +##### Exemples -<p>Le paramètre <code>books</code> contient l'ensemble de noeuds qui regroupe tous les éléments <code><book></code> de l'espace de nommage <code>http://www.example.org/myNamespace</code> :</p> +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` : -<pre class="eval"><?xslt-param-namespace prefix="my" namespace="http://www.example.org/myNamespace"?> -<?xslt-param name="books" select="//my:book"?> -</pre> + <?xslt-param-namespace prefix="my" namespace="http://www.example.org/myNamespace"?> + <?xslt-param name="books" select="//my:book"?> -<h3 id="Versions_support.C3.A9es">Versions supportées</h3> +### Versions supportées -<p>Supportées depuis Firefox 2.0.0.1. Dans la version 2, l'attribut <strong>value</strong> est supporté mais l'attribut <strong>select</strong> provoque des plantages pour certaines expressions.</p> +Supportées depuis Firefox 2.0.0.1. Dans la version 2, l'attribut **value** est supporté mais l'attribut **select** provoque des plantages pour certaines expressions. -<h3 id="Possibilit.C3.A9s_de_d.C3.A9veloppements_futurs">Possibilités de développements futurs</h3> +### Possibilités de développements futurs -<p>Devons-nous autoriser n'importe quelle fonction XSLT dans les expressions ? <code>document()</code> semble utile, mais il semble difficile de conserver le fait que <code>generate-id()</code> devrait produire la même chaîne pour un même document.</p> +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. -<p>Interwiki Language Links</p> +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 a34aaec766..d7f67a3742 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 @@ -8,39 +8,37 @@ tags: translation_of: Web/XSLT/Transforming_XML_with_XSLT/An_Overview original_slug: Web/XSLT/Transformations_XML_avec_XSLT/Présentation --- -<a href="/fr/docs/Transformations_XML_avec_XSLT">« Transformations XML avec XSLT</a> - -<p>L'eXtensible Stylesheet Language/Transform est un langage très puissant, et une étude approfondie de celui-ci n'est pas l'objectif de ce document, mais une présentation succincte des concepts fondamentaux vous aidera à mieux appréhender la description des capacités de Netscape qui suit.</p> - -<dl> - <dt>Une feuille de styles XSLT est un document XML.</dt> - <dd>Contrairement aux CSS qui ont leur propre syntaxe, une feuille de style XSLT est un document XML, qui doit se conformer à toutes les règles du langage XML. Ainsi, le principe d'une transformation est qu'un document XML est utilisé pour transformer un autre document XML.</dd> - <dt>Une feuille de styles XSLT est identifiée comme telle par un en-tête XSLT standard.</dt> - <dd>L'élément externe dans une feuille de styles XSLT doit être l'élément <xsl:stylesheet> (ou éventuellement l'élément <code><xsl:transform></code>). Cet élément inclut au moins une déclaration d'espace de nommage (<code>namespace</code>) et l'attribut de version obligatoire. On peut également inclure d'autres espaces de nommage et trois attributs optionnels.</dd> - <dt>L'espace de nommage imposé pour XSLT est "http://www.w3.org/1999/XSL/Transform".</dt> - <dd>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 :</dd> -</dl> - -<pre class="eval"><xsl:stylesheet xmlns:xsl="<a href="http://www.w3.org/1999/XSL/Transform">http://www.w3.org/1999/XSL/Transform</a>" version="1.0"> -</pre> - -<ul> - <li>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 <code>xsl:</code>. 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.</li> - <li>Toutes les transformations XSLT sont exécutées sur les arbres, et non sur les documents.</li> - <li>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 <a href="fr/DOM">DOM</a> 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<em>root</em> (unique), des nœuds<em>élément</em>, des nœuds<em>text</em>, des nœuds<em>attribut</em>, 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.</li> - <li>XSLT est un langage déclaratif de haut niveau.</li> - <li>Une feuille de styles XSLT est un ensemble de règles, appelées<em>modèles</em> (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<em>Lisp</em> ou<em>Scheme</em>.</li> - <li>Les emplacements dans les arbres sont spécifiés à l'aide de XPath, une recommandation du W3C.</li> - <li>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<em>référence</em>.</li> - <li>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.</li> - <li>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.</li> - <li>Les feuilles de styles peuvent être attachées à un document XML par l'intermédiaire d'une instruction de traitement.</li> - <li>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 à :</li> -</ul> - -<pre class="eval"><?xml-stylesheet type="text/xml" href="inventory.xsl"?> -</pre> - -<p>Cette instruction doit être placée dans le prologue du document XML.</p> - -<p>Pour en savoir plus sur XSLT et XPath, voir la section <a href="fr/Transformations_XML_avec_XSLT/Autres_ressources">Autres ressources</a> à la fin de cet article.</p>
\ No newline at end of file +[« Transformations XML avec XSLT](/fr/docs/Transformations_XML_avec_XSLT) + +L'eXtensible Stylesheet Language/Transform est un langage très puissant, et une étude approfondie de celui-ci n'est pas l'objectif de ce document, mais une présentation succincte des concepts fondamentaux vous aidera à mieux appréhender la description des capacités de Netscape qui suit. + +- Une feuille de styles XSLT est un document XML. + - : Contrairement aux CSS qui ont leur propre syntaxe, une feuille de style XSLT est un document XML, qui doit se conformer à toutes les règles du langage XML. Ainsi, le principe d'une transformation est qu'un document XML est utilisé pour transformer un autre document XML. +- 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 : + +<!----> + + <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"> + +- 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. +- 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 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 à : + +<!----> + + <?xml-stylesheet type="text/xml" href="inventory.xsl"?> + +Cette instruction doit être placée dans le prologue du document XML. + +Pour en savoir plus sur XSLT et XPath, voir la section [Autres ressources](fr/Transformations_XML_avec_XSLT/Autres_ressources) à la fin de cet article. 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 c03b5bcd84..f619d879e6 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 @@ -2,110 +2,80 @@ title: Autres ressources slug: Web/XSLT/Transforming_XML_with_XSLT/For_Further_Reading tags: -- Transformations_XML_avec_XSLT -- XML -- XSLT + - Transformations_XML_avec_XSLT + - XML + - XSLT translation_of: Web/XSLT/Transforming_XML_with_XSLT/For_Further_Reading original_slug: Web/XSLT/Transformations_XML_avec_XSLT/Autres_ressources --- -<a href="/fr/docs/Transformations_XML_avec_XSLT">« Transformations XML avec XSLT</a> - -<h3 id="Sources_imprim.C3.A9es">Sources imprimées</h3> - -<h4 id="Livres">Livres</h4> - -<ul> - <li><strong>XSLT: Programmer's Reference, Second Edition</strong> - - <ul> - <li><strong>Auteur</strong> : Michael H. Kay</li> - <li><strong>Nombre de page</strong> : 992 pages</li> - <li><strong>Éditeur</strong> : Wrox; 2 edition (May 3, 2001)</li> - <li><strong>ISBN</strong>: 0764543814</li> - <li>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 - gros livre, bien articulé, détaillé, épuisant le sujet, voire parfois le lecteur, et qui couvre toutes les bases - possibles de XSLT.</li> - - <li><a - href="http://www.amazon.com/XSLT-Programmers-Reference-Programmer/dp/0764543814">http://www.amazon.com/XSLT-Programme.../dp/0764543814</a> - </li> - </ul> - </li> - <li><strong>XSLT</strong> - - <ul> - <li><strong>Auteur</strong> : Doug Tidwell</li> - <li><strong>Nombre de page</strong> : 473 pages</li> - <li><strong>Éditeur</strong> : O'Reilly Media; 1 edition (August 15, 2001)</li> - <li><strong>ISBN</strong>: 0596000537</li> - <li>Doug Tidwell est un développeur senior chez IBM et un<em>évangéliste</em> 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 - site Web développeur d'IBM. Ce livre est moins complet que celui de Michael Kay, mais il couvre correctement les - bases, et offre quelques exemples intéressants.</li> - <li><a - href="http://www.amazon.com/Xslt-Doug-Tidwell/dp/0596000537">http://www.amazon.com/Xslt-Doug-Tidwell/dp/0596000537</a> - </li> - - </ul> - </li> - - <li><strong>Learning XML, Second Edition</strong> - - <ul> - <li><strong>Auteur</strong> : Erik T. Ray</li> - <li><strong>Nombre de page</strong> : 432 pages</li> - <li><strong>Éditeur</strong> : O'Reilly Media; 2 edition (September 22, 2003)</li> - <li><strong>ISBN</strong>: 0596004206</li> - <li>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. - </li> - <li><a href="http://www.amazon.com/gp/product/0596004206">http://www.amazon.com/gp/product/0596004206</a></li> - </ul> - </li> -</ul> - -<h3 id="Sources_num.C3.A9riques">Sources numériques</h3> - -<h4 id="Sites_Web">Sites Web</h4> - -<ul> - <li><strong>World Wide Web Consortium</strong> - <ul> - <li><strong>Page d'accueil du W3C</strong> : <a href="http://www.w3.org/">http://www.w3.org/</a></li> - <li><strong>Page de XSL</strong> : <a href="http://www.w3.org/Style/XSL/">http://www.w3.org/Style/XSL/</a></li> - <li><strong>Recommandation XSLT 1.0</strong> : <a href="http://www.w3.org/TR/xslt">http://www.w3.org/TR/xslt</a></li> - <li><strong>Archive of public style (CSS and XSLT) discussions</strong> : <a href="http://lists.w3.org/Archives/Public/www-style/">http://lists.w3.org/Archives/Public/www-style/</a></li> - <li><strong>Recommandation XPath 1.0</strong> : <a href="http://www.w3.org/TR/xpath">http://www.w3.org/TR/xpath</a></li> - <li>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.</li> - </ul> - </li> -</ul> - -<h4 id="Articles">Articles</h4> - -<ul> - <li><a href="http://www-106.ibm.com/developerworks/library/x-hands-on-xsl/">http://www-106.ibm.com/developerwork...-hands-on-xsl/</a></li> - <li><a href="http://hotwired.lycos.com/webmonkey/98/43/index2a.html?tw=authoring">http://hotwired.lycos.com/webmonkey/...l?tw=authoring</a></li> - <li><a href="http://www.xml.com/pub/a/2000/08/holman/index.html">http://www.xml.com/pub/a/2000/08/holman/index.html</a></li> -</ul> - -<h4 id="Tutoriels_et_exemples">Tutoriels et exemples</h4> - -<ul> - <li><a href="http://www.jenitennison.com/xslt/">http://www.jenitennison.com/xslt/</a></li> - <li><a href="http://www.xmlpitstop.com/Default.asp?DataType=SSC">http://www.xmlpitstop.com/Default.asp?DataType=SSC</a></li> - <li><a href="http://www.nwalsh.com/docs/tutorials/xsl/">http://www.nwalsh.com/docs/tutorials/xsl/</a></li> -</ul> - - -<h4 id="Autres_ressources">Autres ressources</h4> - -<ul> - <li><a href="http://www.oasis-open.org/cover/xsl.html">Cover Pages - XSL</a></li> - <li>XSL-List - <ul> - <li><a href="http://www.biglist.com/lists/xsl-list/archives/">Archives</a></li> - <li><a href="http://www.mulberrytech.com/xsl/xsl-list/">Inscription</a></li> - </ul> - </li> -</ul> +[« Transformations XML avec XSLT](/fr/docs/Transformations_XML_avec_XSLT) + +### Sources imprimées + +#### Livres + +- **XSLT: Programmer's Reference, Second Edition** + + - **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 + gros livre, bien articulé, détaillé, épuisant le sujet, voire parfois le lecteur, et qui couvre toutes les bases + possibles de XSLT. + - [http://www.amazon.com/XSLT-Programme.../dp/0764543814](http://www.amazon.com/XSLT-Programmers-Reference-Programmer/dp/0764543814) + +- **XSLT** + + - **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 + site Web développeur d'IBM. Ce livre est moins complet que celui de Michael Kay, mais il couvre correctement les + bases, et offre quelques exemples intéressants. + - <http://www.amazon.com/Xslt-Doug-Tidwell/dp/0596000537> + +- **Learning XML, Second Edition** + + - **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> + +### Sources numériques + +#### Sites Web + +- **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> + - 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 + +- [http://www-106.ibm.com/developerwork...-hands-on-xsl/](http://www-106.ibm.com/developerworks/library/x-hands-on-xsl/) +- [http://hotwired.lycos.com/webmonkey/...l?tw=authoring](http://hotwired.lycos.com/webmonkey/98/43/index2a.html?tw=authoring) +- <http://www.xml.com/pub/a/2000/08/holman/index.html> + +#### Tutoriels et exemples + +- <http://www.jenitennison.com/xslt/> +- <http://www.xmlpitstop.com/Default.asp?DataType=SSC> +- <http://www.nwalsh.com/docs/tutorials/xsl/> + +#### Autres ressources + +- [Cover Pages - XSL](http://www.oasis-open.org/cover/xsl.html) +- XSL-List + + - [Archives](http://www.biglist.com/lists/xsl-list/archives/) + - [Inscription](http://www.mulberrytech.com/xsl/xsl-list/) 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 24e477bf69..31319589cc 100644 --- a/files/fr/web/xslt/transforming_xml_with_xslt/index.md +++ b/files/fr/web/xslt/transforming_xml_with_xslt/index.md @@ -8,96 +8,120 @@ tags: translation_of: Web/XSLT/Transforming_XML_with_XSLT original_slug: Web/XSLT/Transformations_XML_avec_XSLT --- -<p> -</p><p><br> -</p> -<h3 id="Pr.C3.A9sentation"> <a href="fr/Transformations_XML_avec_XSLT/Pr%c3%a9sentation">Présentation</a> </h3> -<p>La séparation du contenu et de la présentation est l'une des caractéristiques principale du <a href="fr/XML">XML</a>. La structure d'un document XML est conçue pour refléter et clarifier les relations entre les différents aspects du contenu lui-même, sans l'obsurcir par la nécessité d'y intégrer des indications sur la présentation qui lui sera appliquée ensuite. Cette structure intelligente est particulièrement importante, car de plus en plus de transferts de données sont automatisés et se font entre des machines très hétérogènes reliées par un réseau. -</p><p>Mais au bout du compte, la plus grande partie du contenu des documents XML devra être présentée à des lecteurs humains. Parce qu'un navigateur possède une interface familière et extrêmement flexible, c'est un moyen idéal pour afficher une version du contenu XML remise en forme spécifiquement pour être présentée. Conçu dès ses débuts pour s'appuyer sur un large éventail de technologies XML, Mozilla intègre tous les mécanismes nécessaires au traitement des documents XML originaux, et des feuilles de styles spécialisées utilisées pour définir le traitement à leur appliquer pour un affichage en HTML. En déplaçant le processus de transformation du côté client, on réduit ainsi la charge serveur. -</p><p>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 <a href="fr/CSS">CSS</a>, tiré du <a href="fr/DHTML">DHTML</a>. 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 <a href="http://www.meyerweb.com/eric/css/">Eric Meyer's CSS pages</a>. -</p><p>Nous nous intéressons ici au second type de feuilles de styles supporté par Gecko : la feuille de style XSLT. XSLT signifie <i>eXtensible Stylesheet Language/Transform</i>. 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). -</p> -<h3 id="R.C3.A9f.C3.A9rence_XSLT.2FXPath"> Référence XSLT/XPath </h3> -<h4 id=".C3.89l.C3.A9ments"> <a href="fr/XSLT/%c3%89l%c3%a9ments">Éléments</a> </h4> -<ul><li> <a href="fr/XSLT/apply-imports">xsl:apply-imports</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/apply-templates">xsl:apply-templates</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/attribute">xsl:attribute</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/attribute-set">xsl:attribute-set</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/call-template">xsl:call-template</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/choose">xsl:choose</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/comment">xsl:comment</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/copy">xsl:copy</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/copy-of">xsl:copy-of</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/decimal-format">xsl:decimal-format</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/element">xsl:element</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/fallback">xsl:fallback</a> <i>(non supporté)</i> -</li><li> <a href="fr/XSLT/for-each">xsl:for-each</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/if">xsl:if</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/import">xsl:import</a> <i>(mostly supported)</i> -</li><li> <a href="fr/XSLT/include">xsl:include</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/key">xsl:key</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/message">xsl:message</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/namespace-alias">xsl:namespace-alias</a> <i>(non supporté)</i> -</li><li> <a href="fr/XSLT/number">xsl:number</a> <i>(partiellement supporté)</i> -</li><li> <a href="fr/XSLT/otherwise">xsl:otherwise</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/output">xsl:output</a> <i>(partiellement supporté)</i> -</li><li> <a href="fr/XSLT/param">xsl:param</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/preserve-space">xsl:preserve-space</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/processing-instruction">xsl:processing-instruction</a> </li><li> <a href="fr/XSLT/sort">xsl:sort</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/strip-space">xsl:strip-space</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/stylesheet">xsl:stylesheet</a> <i>(partiellement supporté)</i> -</li><li> <a href="fr/XSLT/template">xsl:template</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/text">xsl:text</a> <i>(partially supported)</i> -</li><li> <a href="fr/XSLT/transform">xsl:transform</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/value-of">xsl:value-of</a> <i>(partiellement supporté)</i> -</li><li> <a href="fr/XSLT/variable">xsl:variable</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/when">xsl:when</a> <i>(supporté)</i> -</li><li> <a href="fr/XSLT/with-param">xsl:with-param</a> <i>(supporté)</i> -</li></ul> -<h4 id="Axes"> <a href="fr/XPath/Axes">Axes</a> </h4> -<ul><li> <a href="fr/XPath/Axes/ancestor">ancestor</a> </li><li> <a href="fr/XPath/Axes/ancestor-or-self">ancestor-or-self</a> </li><li> <a href="fr/XPath/Axes/attribute">attribute</a> </li><li> <a href="fr/XPath/Axes/child">child</a> </li><li> <a href="fr/XPath/Axes/descendant">descendant</a> </li><li> <a href="fr/XPath/Axes/descendant-or-self">descendant-or-self</a> </li><li> <a href="fr/XPath/Axes/following">following</a> </li><li> <a href="fr/XPath/Axes/following-sibling">following-sibling</a> </li><li> <a href="fr/XPath/Axes/namespace">namespace</a> <i>(non supporté)</i> -</li><li> <a href="fr/XPath/Axes/parent">parent</a> </li><li> <a href="fr/XPath/Axes/preceding">preceding</a> </li><li> <a href="fr/XPath/Axes/preceding-sibling">preceding-sibling</a> </li><li> <a href="fr/XPath/Axes/self">self</a> -</li></ul> -<h4 id="Fonctions"> <a href="fr/XPath/Fonctions">Fonctions</a> </h4> -<ul><li> <a href="fr/XPath/Fonctions/boolean">boolean()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/ceiling">ceiling()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/concat">concat()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/contains">contains()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/count">count()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/current">current()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/document">document()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/element-available">element-available()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/false">false()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/floor">floor()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/format-number">format-number()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/function-available">function-available()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/generate-id">generate-id()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/id">id()</a> <i>(partiellement supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/key">key()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/lang">lang()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/last">last()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/local-name">local-name()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/name">name()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/namespace-uri">namespace-uri()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/normalize-space">normalize-space()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/not">not()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/number">number()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/position">position()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/round">round()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/starts-with">starts-with()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/string">string()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/string-length">string-length()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/substring">substring()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/substring-after">substring-after()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/substring-before">substring-before()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/sum">sum()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/system-property">system-property()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/translate">translate()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/true">true()</a> <i>(supporté)</i> -</li><li> <a href="fr/XPath/Fonctions/unparsed-entity-url">unparsed-entity-url()</a> <i>(non supporté)</i> -</li></ul> -<h3 id="Autres_ressources"> <a href="fr/Transformations_XML_avec_XSLT/Autres_ressources">Autres ressources</a> </h3> -<ul><li> <a href="fr/Transformations_XML_avec_XSLT/Autres_ressources#Livres">Livres</a> </li><li> <a href="fr/Transformations_XML_avec_XSLT/Autres_ressources#En_ligne">En ligne</a> <ul><li> <a href="fr/Transformations_XML_avec_XSLT/Autres_ressources#Le_World_Wide_Web_Consortium">Le World Wide Web Consortium</a> </li><li> <a href="fr/Transformations_XML_avec_XSLT/Autres_ressources#Portails">Portails</a> </li><li> <a href="fr/Transformations_XML_avec_XSLT/Autres_ressources#Articles">Articles</a> </li><li> <a href="fr/Transformations_XML_avec_XSLT/Autres_ressources#Tutoriels.2FExemples">Tutoriels/Exemples</a> </li><li> <a href="fr/Transformations_XML_avec_XSLT/Autres_ressources#Mailing_Lists.2FNewsgroups">Mailing Lists/Newsgroups</a> -</li></ul> -</li><li> <a href="fr/Transformations_XML_avec_XSLT/Autres_ressources#Extensions">Extensions</a> -</li></ul> +### [Présentation](fr/Transformations_XML_avec_XSLT/Pr%c3%a9sentation) + +La séparation du contenu et de la présentation est l'une des caractéristiques principale du [XML](fr/XML). La structure d'un document XML est conçue pour refléter et clarifier les relations entre les différents aspects du contenu lui-même, sans l'obsurcir par la nécessité d'y intégrer des indications sur la présentation qui lui sera appliquée ensuite. Cette structure intelligente est particulièrement importante, car de plus en plus de transferts de données sont automatisés et se font entre des machines très hétérogènes reliées par un réseau. + +Mais au bout du compte, la plus grande partie du contenu des documents XML devra être présentée à des lecteurs humains. Parce qu'un navigateur possède une interface familière et extrêmement flexible, c'est un moyen idéal pour afficher une version du contenu XML remise en forme spécifiquement pour être présentée. Conçu dès ses débuts pour s'appuyer sur un large éventail de technologies XML, Mozilla intègre tous les mécanismes nécessaires au traitement des documents XML originaux, et des feuilles de styles spécialisées utilisées pour définir le traitement à leur appliquer pour un affichage en HTML. En déplaçant le processus de transformation du côté client, on réduit ainsi la charge serveur. + +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). + +### Référence XSLT/XPath + +#### [Éléments](fr/XSLT/%c3%89l%c3%a9ments) + +- [xsl:apply-imports](fr/XSLT/apply-imports) _(supporté)_ +- [xsl:apply-templates](fr/XSLT/apply-templates) _(supporté)_ +- [xsl:attribute](fr/XSLT/attribute) _(supporté)_ +- [xsl:attribute-set](fr/XSLT/attribute-set) _(supporté)_ +- [xsl:call-template](fr/XSLT/call-template) _(supporté)_ +- [xsl:choose](fr/XSLT/choose) _(supporté)_ +- [xsl:comment](fr/XSLT/comment) _(supporté)_ +- [xsl:copy](fr/XSLT/copy) _(supporté)_ +- [xsl:copy-of](fr/XSLT/copy-of) _(supporté)_ +- [xsl:decimal-format](fr/XSLT/decimal-format) _(supporté)_ +- [xsl:element](fr/XSLT/element) _(supporté)_ +- [xsl:fallback](fr/XSLT/fallback) _(non supporté)_ +- [xsl:for-each](fr/XSLT/for-each) _(supporté)_ +- [xsl:if](fr/XSLT/if) _(supporté)_ +- [xsl:import](fr/XSLT/import) _(mostly supported)_ +- [xsl:include](fr/XSLT/include) _(supporté)_ +- [xsl:key](fr/XSLT/key) _(supporté)_ +- [xsl:message](fr/XSLT/message) _(supporté)_ +- [xsl:namespace-alias](fr/XSLT/namespace-alias) _(non supporté)_ +- [xsl:number](fr/XSLT/number) _(partiellement supporté)_ +- [xsl:otherwise](fr/XSLT/otherwise) _(supporté)_ +- [xsl:output](fr/XSLT/output) _(partiellement supporté)_ +- [xsl:param](fr/XSLT/param) _(supporté)_ +- [xsl:preserve-space](fr/XSLT/preserve-space) _(supporté)_ +- [xsl:processing-instruction](fr/XSLT/processing-instruction) +- [xsl:sort](fr/XSLT/sort) _(supporté)_ +- [xsl:strip-space](fr/XSLT/strip-space) _(supporté)_ +- [xsl:stylesheet](fr/XSLT/stylesheet) _(partiellement supporté)_ +- [xsl:template](fr/XSLT/template) _(supporté)_ +- [xsl:text](fr/XSLT/text) _(partially supported)_ +- [xsl:transform](fr/XSLT/transform) _(supporté)_ +- [xsl:value-of](fr/XSLT/value-of) _(partiellement supporté)_ +- [xsl:variable](fr/XSLT/variable) _(supporté)_ +- [xsl:when](fr/XSLT/when) _(supporté)_ +- [xsl:with-param](fr/XSLT/with-param) _(supporté)_ + +#### [Axes](fr/XPath/Axes) + +- [ancestor](fr/XPath/Axes/ancestor) +- [ancestor-or-self](fr/XPath/Axes/ancestor-or-self) +- [attribute](fr/XPath/Axes/attribute) +- [child](fr/XPath/Axes/child) +- [descendant](fr/XPath/Axes/descendant) +- [descendant-or-self](fr/XPath/Axes/descendant-or-self) +- [following](fr/XPath/Axes/following) +- [following-sibling](fr/XPath/Axes/following-sibling) +- [namespace](fr/XPath/Axes/namespace) _(non supporté)_ +- [parent](fr/XPath/Axes/parent) +- [preceding](fr/XPath/Axes/preceding) +- [preceding-sibling](fr/XPath/Axes/preceding-sibling) +- [self](fr/XPath/Axes/self) + +#### [Fonctions](fr/XPath/Fonctions) + +- [boolean()](fr/XPath/Fonctions/boolean) _(supporté)_ +- [ceiling()](fr/XPath/Fonctions/ceiling) _(supporté)_ +- [concat()](fr/XPath/Fonctions/concat) _(supporté)_ +- [contains()](fr/XPath/Fonctions/contains) _(supporté)_ +- [count()](fr/XPath/Fonctions/count) _(supporté)_ +- [current()](fr/XPath/Fonctions/current) _(supporté)_ +- [document()](fr/XPath/Fonctions/document) _(supporté)_ +- [element-available()](fr/XPath/Fonctions/element-available) _(supporté)_ +- [false()](fr/XPath/Fonctions/false) _(supporté)_ +- [floor()](fr/XPath/Fonctions/floor) _(supporté)_ +- [format-number()](fr/XPath/Fonctions/format-number) _(supporté)_ +- [function-available()](fr/XPath/Fonctions/function-available) _(supporté)_ +- [generate-id()](fr/XPath/Fonctions/generate-id) _(supporté)_ +- [id()](fr/XPath/Fonctions/id) _(partiellement supporté)_ +- [key()](fr/XPath/Fonctions/key) _(supporté)_ +- [lang()](fr/XPath/Fonctions/lang) _(supporté)_ +- [last()](fr/XPath/Fonctions/last) _(supporté)_ +- [local-name()](fr/XPath/Fonctions/local-name) _(supporté)_ +- [name()](fr/XPath/Fonctions/name) _(supporté)_ +- [namespace-uri()](fr/XPath/Fonctions/namespace-uri) _(supporté)_ +- [normalize-space()](fr/XPath/Fonctions/normalize-space) _(supporté)_ +- [not()](fr/XPath/Fonctions/not) _(supporté)_ +- [number()](fr/XPath/Fonctions/number) _(supporté)_ +- [position()](fr/XPath/Fonctions/position) _(supporté)_ +- [round()](fr/XPath/Fonctions/round) _(supporté)_ +- [starts-with()](fr/XPath/Fonctions/starts-with) _(supporté)_ +- [string()](fr/XPath/Fonctions/string) _(supporté)_ +- [string-length()](fr/XPath/Fonctions/string-length) _(supporté)_ +- [substring()](fr/XPath/Fonctions/substring) _(supporté)_ +- [substring-after()](fr/XPath/Fonctions/substring-after) _(supporté)_ +- [substring-before()](fr/XPath/Fonctions/substring-before) _(supporté)_ +- [sum()](fr/XPath/Fonctions/sum) _(supporté)_ +- [system-property()](fr/XPath/Fonctions/system-property) _(supporté)_ +- [translate()](fr/XPath/Fonctions/translate) _(supporté)_ +- [true()](fr/XPath/Fonctions/true) _(supporté)_ +- [unparsed-entity-url()](fr/XPath/Fonctions/unparsed-entity-url) _(non supporté)_ + +### [Autres ressources](fr/Transformations_XML_avec_XSLT/Autres_ressources) + +- [Livres](fr/Transformations_XML_avec_XSLT/Autres_ressources#Livres) +- [En ligne](fr/Transformations_XML_avec_XSLT/Autres_ressources#En_ligne) + + - [Le World Wide Web Consortium](fr/Transformations_XML_avec_XSLT/Autres_ressources#Le_World_Wide_Web_Consortium) + - [Portails](fr/Transformations_XML_avec_XSLT/Autres_ressources#Portails) + - [Articles](fr/Transformations_XML_avec_XSLT/Autres_ressources#Articles) + - [Tutoriels/Exemples](fr/Transformations_XML_avec_XSLT/Autres_ressources#Tutoriels.2FExemples) + - [Mailing Lists/Newsgroups](fr/Transformations_XML_avec_XSLT/Autres_ressources#Mailing_Lists.2FNewsgroups) + +- [Extensions](fr/Transformations_XML_avec_XSLT/Autres_ressources#Extensions) diff --git a/files/fr/web/xslt/transforming_xml_with_xslt/the_netscape_xslt_xpath_reference/index.md b/files/fr/web/xslt/transforming_xml_with_xslt/the_netscape_xslt_xpath_reference/index.md index 52f2e32b8b..987bd77ebc 100644 --- a/files/fr/web/xslt/transforming_xml_with_xslt/the_netscape_xslt_xpath_reference/index.md +++ b/files/fr/web/xslt/transforming_xml_with_xslt/the_netscape_xslt_xpath_reference/index.md @@ -4,235 +4,320 @@ slug: Web/XSLT/Transforming_XML_with_XSLT/The_Netscape_XSLT_XPath_Reference translation_of: Web/XSLT/Transforming_XML_with_XSLT/The_Netscape_XSLT_XPath_Reference original_slug: Web/XSLT/Transformations_XML_avec_XSLT/La_référence_XSLT_XPath_de_Netscape --- -<p> -</p><p>La liste ci-dessous, ordonnée alphabétiquement, présente les élémentes, les axes et les fonctions de la recommandation XSLT 1.0 du W3C, ainsi que les sections appropriées de la recommandation XPath. Le développement de XSLT est toujours en cours, et ce document sera mis à jours au fur et à mesure de l'extension des fonctionnalités. -</p> -<h3 id=".C3.89l.C3.A9ments"> <a href="fr/XSLT/%c3%89l%c3%a9ments">Éléments</a> </h3> -<h4 id="xsl:apply-imports"> <a href="fr/XSLT/apply-imports">xsl:apply-imports</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:apply-templates"> <a href="fr/XSLT/apply-templates">xsl:apply-templates</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:attribute"> <a href="fr/XSLT/attribute">xsl:attribute</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:attribute-set"> <a href="fr/XSLT/attribute-set">xsl:attribute-set</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:call-template"> <a href="fr/XSLT/call-template">xsl:call-template</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:choose"> <a href="fr/XSLT/choose">xsl:choose</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:comment"> <a href="fr/XSLT/comment">xsl:comment</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:copy"> <a href="fr/XSLT/copy">xsl:copy</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:copy-of"> <a href="fr/XSLT/copy-of">xsl:copy-of</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:decimal-format"> <a href="fr/XSLT/decimal-format">xsl:decimal-format</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:element"> <a href="fr/XSLT/element">xsl:element</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:fallback"> <a href="fr/XSLT/fallback">xsl:fallback</a> </h4> -<p><i>(non supporté)</i> -</p> -<h4 id="xsl:for-each"> <a href="fr/XSLT/for-each">xsl:for-each</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:if"> <a href="fr/XSLT/if">xsl:if</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:import"> <a href="fr/XSLT/import">xsl:import</a> </h4> -<p><i>(mostly supported)</i> -</p> -<h4 id="xsl:include"> <a href="fr/XSLT/include">xsl:include</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:key"> <a href="fr/XSLT/key">xsl:key</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:message"> <a href="fr/XSLT/message">xsl:message</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:namespace-alias"> <a href="fr/XSLT/namespace-alias">xsl:namespace-alias</a> </h4> -<p><i>(non supporté)</i> -</p> -<h4 id="xsl:number"> <a href="fr/XSLT/number">xsl:number</a> </h4> -<p><i>(partiellement supporté)</i> -</p> -<h4 id="xsl:otherwise"> <a href="fr/XSLT/otherwise">xsl:otherwise</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:output"> <a href="fr/XSLT/output">xsl:output</a> </h4> -<p><i>(partiellement supporté)</i> -</p> -<h4 id="xsl:param"> <a href="fr/XSLT/param">xsl:param</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:preserve-space"> <a href="fr/XSLT/preserve-space">xsl:preserve-space</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:processing-instruction"> <a href="fr/XSLT/processing-instruction">xsl:processing-instruction</a> </h4> -<h4 id="xsl:sort"> <a href="fr/XSLT/sort">xsl:sort</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:strip-space"> <a href="fr/XSLT/strip-space">xsl:strip-space</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:stylesheet"> <a href="fr/XSLT/stylesheet">xsl:stylesheet</a> </h4> -<p><i>(partiellement supporté)</i> -</p> -<h4 id="xsl:template"> <a href="fr/XSLT/template">xsl:template</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:text"> <a href="fr/XSLT/text">xsl:text</a> </h4> -<p><i>(partiellement supporté)</i> -</p> -<h4 id="xsl:transform"> <a href="fr/XSLT/transform">xsl:transform</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:value-of"> <a href="fr/XSLT/value-of">xsl:value-of</a> </h4> -<p><i>(partiellement supporté)</i> -</p> -<h4 id="xsl:variable"> <a href="fr/XSLT/variable">xsl:variable</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:when"> <a href="fr/XSLT/when">xsl:when</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="xsl:with-param"> <a href="fr/XSLT/with-param">xsl:with-param</a> </h4> -<p><i>(supporté)</i> -</p> -<h3 id="Axes"> <a href="fr/XPath/Axes">Axes</a> </h3> -<h4 id="ancestor"> <a href="fr/XPath/Axes/ancestor">ancestor</a> </h4> -<h4 id="ancestor-or-self"> <a href="fr/XPath/Axes/ancestor-or-self">ancestor-or-self</a> </h4> -<h4 id="attribute"> <a href="fr/XPath/Axes/attribute">attribute</a> </h4> -<h4 id="child"> <a href="fr/XPath/Axes/child">child</a> </h4> -<h4 id="descendant"> <a href="fr/XPath/Axes/descendant">descendant</a> </h4> -<h4 id="descendant-or-self"> <a href="fr/XPath/Axes/descendant-or-self">descendant-or-self</a> </h4> -<h4 id="following"> <a href="fr/XPath/Axes/following">following</a> </h4> -<h4 id="following-sibling"> <a href="fr/XPath/Axes/following-sibling">following-sibling</a> </h4> -<h4 id="namespace"> <a href="fr/XPath/Axes/namespace">namespace</a> </h4> -<p><i>(non supporté)</i> -</p> -<h4 id="parent"> <a href="fr/XPath/Axes/parent">parent</a> </h4> -<h4 id="preceding"> <a href="fr/XPath/Axes/preceding">preceding</a> </h4> -<h4 id="preceding-sibling"> <a href="fr/XPath/Axes/preceding-sibling">preceding-sibling</a> </h4> -<h4 id="self"> <a href="fr/XPath/Axes/self">self</a> </h4> -<h3 id="Fonctions"> <a href="fr/XPath/Fonctions">Fonctions</a> </h3> -<h4 id="boolean.28.29"> <a href="fr/XPath/Fonctions/boolean">boolean()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="ceiling.28.29"> <a href="fr/XPath/Fonctions/ceiling">ceiling()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="concat.28.29"> <a href="fr/XPath/Fonctions/concat">concat()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="contains.28.29"> <a href="fr/XPath/Fonctions/contains">contains()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="count.28.29"> <a href="fr/XPath/Fonctions/count">count()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="current.28.29"> <a href="fr/XPath/Fonctions/current">current()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="document.28.29"> <a href="fr/XPath/Fonctions/document">document()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="element-available.28.29"> <a href="fr/XPath/Fonctions/element-available">element-available()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="false.28.29"> <a href="fr/XPath/Fonctions/false">false()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="floor.28.29"> <a href="fr/XPath/Fonctions/floor">floor()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="format-number.28.29"> <a href="fr/XPath/Fonctions/format-number">format-number()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="function-available.28.29"> <a href="fr/XPath/Fonctions/function-available">function-available()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="generate-id.28.29"> <a href="fr/XPath/Fonctions/generate-id">generate-id()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="id.28.29"> <a href="fr/XPath/Fonctions/id">id()</a> </h4> -<p><i>(partiellement supporté)</i> -</p> -<h4 id="key.28.29"> <a href="fr/XPath/Fonctions/key">key()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="lang.28.29"> <a href="fr/XPath/Fonctions/lang">lang()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="last.28.29"> <a href="fr/XPath/Fonctions/last">last()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="local-name.28.29"> <a href="fr/XPath/Fonctions/local-name">local-name()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="name.28.29"> <a href="fr/XPath/Fonctions/name">name()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="namespace-uri.28.29"> <a href="fr/XPath/Fonctions/namespace-uri">namespace-uri()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="normalize-space.28.29"> <a href="fr/XPath/Fonctions/normalize-space">normalize-space()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="not.28.29"> <a href="fr/XPath/Fonctions/not">not()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="number.28.29"> <a href="fr/XPath/Fonctions/number">number()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="position.28.29"> <a href="fr/XPath/Fonctions/position">position()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="round.28.29"> <a href="fr/XPath/Fonctions/round">round()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="starts-with.28.29"> <a href="fr/XPath/Fonctions/starts-with">starts-with()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="string.28.29"> <a href="fr/XPath/Fonctions/string">string()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="string-length.28.29"> <a href="fr/XPath/Fonctions/string-length">string-length()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="substring.28.29"> <a href="fr/XPath/Fonctions/substring">substring()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="substring-after.28.29"> <a href="fr/XPath/Fonctions/substring-after">substring-after()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="substring-before.28.29"> <a href="fr/XPath/Fonctions/substring-before">substring-before()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="sum.28.29"> <a href="fr/XPath/Fonctions/sum">sum()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="system-property.28.29"> <a href="fr/XPath/Fonctions/system-property">system-property()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="translate.28.29"> <a href="fr/XPath/Fonctions/translate">translate()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="true.28.29"> <a href="fr/XPath/Fonctions/true">true()</a> </h4> -<p><i>(supporté)</i> -</p> -<h4 id="unparsed-entity-url.28.29"> <a href="fr/XPath/Fonctions/unparsed-entity-url">unparsed-entity-url()</a> </h4> -<p><i>(supporté)</i> -</p>
\ No newline at end of file +La liste ci-dessous, ordonnée alphabétiquement, présente les élémentes, les axes et les fonctions de la recommandation XSLT 1.0 du W3C, ainsi que les sections appropriées de la recommandation XPath. Le développement de XSLT est toujours en cours, et ce document sera mis à jours au fur et à mesure de l'extension des fonctionnalités. + +### [Éléments](fr/XSLT/%c3%89l%c3%a9ments) + +#### [xsl:apply-imports](fr/XSLT/apply-imports) + +_(supporté)_ + +#### [xsl:apply-templates](fr/XSLT/apply-templates) + +_(supporté)_ + +#### [xsl:attribute](fr/XSLT/attribute) + +_(supporté)_ + +#### [xsl:attribute-set](fr/XSLT/attribute-set) + +_(supporté)_ + +#### [xsl:call-template](fr/XSLT/call-template) + +_(supporté)_ + +#### [xsl:choose](fr/XSLT/choose) + +_(supporté)_ + +#### [xsl:comment](fr/XSLT/comment) + +_(supporté)_ + +#### [xsl:copy](fr/XSLT/copy) + +_(supporté)_ + +#### [xsl:copy-of](fr/XSLT/copy-of) + +_(supporté)_ + +#### [xsl:decimal-format](fr/XSLT/decimal-format) + +_(supporté)_ + +#### [xsl:element](fr/XSLT/element) + +_(supporté)_ + +#### [xsl:fallback](fr/XSLT/fallback) + +_(non supporté)_ + +#### [xsl:for-each](fr/XSLT/for-each) + +_(supporté)_ + +#### [xsl:if](fr/XSLT/if) + +_(supporté)_ + +#### [xsl:import](fr/XSLT/import) + +_(mostly supported)_ + +#### [xsl:include](fr/XSLT/include) + +_(supporté)_ + +#### [xsl:key](fr/XSLT/key) + +_(supporté)_ + +#### [xsl:message](fr/XSLT/message) + +_(supporté)_ + +#### [xsl:namespace-alias](fr/XSLT/namespace-alias) + +_(non supporté)_ + +#### [xsl:number](fr/XSLT/number) + +_(partiellement supporté)_ + +#### [xsl:otherwise](fr/XSLT/otherwise) + +_(supporté)_ + +#### [xsl:output](fr/XSLT/output) + +_(partiellement supporté)_ + +#### [xsl:param](fr/XSLT/param) + +_(supporté)_ + +#### [xsl:preserve-space](fr/XSLT/preserve-space) + +_(supporté)_ + +#### [xsl:processing-instruction](fr/XSLT/processing-instruction) + +#### [xsl:sort](fr/XSLT/sort) + +_(supporté)_ + +#### [xsl:strip-space](fr/XSLT/strip-space) + +_(supporté)_ + +#### [xsl:stylesheet](fr/XSLT/stylesheet) + +_(partiellement supporté)_ + +#### [xsl:template](fr/XSLT/template) + +_(supporté)_ + +#### [xsl:text](fr/XSLT/text) + +_(partiellement supporté)_ + +#### [xsl:transform](fr/XSLT/transform) + +_(supporté)_ + +#### [xsl:value-of](fr/XSLT/value-of) + +_(partiellement supporté)_ + +#### [xsl:variable](fr/XSLT/variable) + +_(supporté)_ + +#### [xsl:when](fr/XSLT/when) + +_(supporté)_ + +#### [xsl:with-param](fr/XSLT/with-param) + +_(supporté)_ + +### [Axes](fr/XPath/Axes) + +#### [ancestor](fr/XPath/Axes/ancestor) + +#### [ancestor-or-self](fr/XPath/Axes/ancestor-or-self) + +#### [attribute](fr/XPath/Axes/attribute) + +#### [child](fr/XPath/Axes/child) + +#### [descendant](fr/XPath/Axes/descendant) + +#### [descendant-or-self](fr/XPath/Axes/descendant-or-self) + +#### [following](fr/XPath/Axes/following) + +#### [following-sibling](fr/XPath/Axes/following-sibling) + +#### [namespace](fr/XPath/Axes/namespace) + +_(non supporté)_ + +#### [parent](fr/XPath/Axes/parent) + +#### [preceding](fr/XPath/Axes/preceding) + +#### [preceding-sibling](fr/XPath/Axes/preceding-sibling) + +#### [self](fr/XPath/Axes/self) + +### [Fonctions](fr/XPath/Fonctions) + +#### [boolean()](fr/XPath/Fonctions/boolean) + +_(supporté)_ + +#### [ceiling()](fr/XPath/Fonctions/ceiling) + +_(supporté)_ + +#### [concat()](fr/XPath/Fonctions/concat) + +_(supporté)_ + +#### [contains()](fr/XPath/Fonctions/contains) + +_(supporté)_ + +#### [count()](fr/XPath/Fonctions/count) + +_(supporté)_ + +#### [current()](fr/XPath/Fonctions/current) + +_(supporté)_ + +#### [document()](fr/XPath/Fonctions/document) + +_(supporté)_ + +#### [element-available()](fr/XPath/Fonctions/element-available) + +_(supporté)_ + +#### [false()](fr/XPath/Fonctions/false) + +_(supporté)_ + +#### [floor()](fr/XPath/Fonctions/floor) + +_(supporté)_ + +#### [format-number()](fr/XPath/Fonctions/format-number) + +_(supporté)_ + +#### [function-available()](fr/XPath/Fonctions/function-available) + +_(supporté)_ + +#### [generate-id()](fr/XPath/Fonctions/generate-id) + +_(supporté)_ + +#### [id()](fr/XPath/Fonctions/id) + +_(partiellement supporté)_ + +#### [key()](fr/XPath/Fonctions/key) + +_(supporté)_ + +#### [lang()](fr/XPath/Fonctions/lang) + +_(supporté)_ + +#### [last()](fr/XPath/Fonctions/last) + +_(supporté)_ + +#### [local-name()](fr/XPath/Fonctions/local-name) + +_(supporté)_ + +#### [name()](fr/XPath/Fonctions/name) + +_(supporté)_ + +#### [namespace-uri()](fr/XPath/Fonctions/namespace-uri) + +_(supporté)_ + +#### [normalize-space()](fr/XPath/Fonctions/normalize-space) + +_(supporté)_ + +#### [not()](fr/XPath/Fonctions/not) + +_(supporté)_ + +#### [number()](fr/XPath/Fonctions/number) + +_(supporté)_ + +#### [position()](fr/XPath/Fonctions/position) + +_(supporté)_ + +#### [round()](fr/XPath/Fonctions/round) + +_(supporté)_ + +#### [starts-with()](fr/XPath/Fonctions/starts-with) + +_(supporté)_ + +#### [string()](fr/XPath/Fonctions/string) + +_(supporté)_ + +#### [string-length()](fr/XPath/Fonctions/string-length) + +_(supporté)_ + +#### [substring()](fr/XPath/Fonctions/substring) + +_(supporté)_ + +#### [substring-after()](fr/XPath/Fonctions/substring-after) + +_(supporté)_ + +#### [substring-before()](fr/XPath/Fonctions/substring-before) + +_(supporté)_ + +#### [sum()](fr/XPath/Fonctions/sum) + +_(supporté)_ + +#### [system-property()](fr/XPath/Fonctions/system-property) + +_(supporté)_ + +#### [translate()](fr/XPath/Fonctions/translate) + +_(supporté)_ + +#### [true()](fr/XPath/Fonctions/true) + +_(supporté)_ + +#### [unparsed-entity-url()](fr/XPath/Fonctions/unparsed-entity-url) + +_(supporté)_ 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 b533a95a9d..75a50d2048 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 @@ -7,48 +7,65 @@ translation_of: Web/XSLT/Using_the_Mozilla_JavaScript_interface_to_XSL_Transform original_slug: >- Web/XSLT/Utilisation_de_l'interface_JavaScript_de_Mozilla_pour_les_transformations_XSL --- -<p>Ce document décrit l'interface JavaScript pour le moteur de traitement XSLT (TransforMiiX) de Mozilla 1.2 et supérieur.</p> -<h3 id="Cr.C3.A9ation_de_XSLTProcessor">Création de XSLTProcessor</h3> -<p>Pour commencer, nous avons besoin de créer un objet <a href="fr/XSLTProcessor">XSLTProcessor</a> :</p> -<pre class="eval">var processor = new XSLTProcessor(); -</pre> -<h3 id="Sp.C3.A9cification_de_la_feuille_de_style">Spécification de la feuille de style</h3> -<p>Avant d'utiliser cet objet, nous devons importer une feuille de style avec la fonction <code>importStylesheet()</code>. Elle a un unique paramètre, qui est le nœud DOM de la feuille de style XSLT à importer — remarquez que l'importation est directe, ce qui signifie que si nous modifions la feuille de style DOM après son importation, cela sera reflété lors du traitement. Il est cependant conseillé d'utiliser les paramètres de feuille de style plutôt que de modifier le DOM. C'est généralement plus facile et on obtient de meilleures performances.</p> -<pre class="eval">var testTransform = document.implementation.createDocument("", "test", null); -// juste un exemple pour obtenir une transformation dans un script étant donné que -// la fonction DOM XMLDocument.load est asynchrone, donc tout le traitement se fait -// dans le gestionnaire onload -testTransform.addEventListener("load", onload, false); -testTransform.load("test-transform.xml"); -function onload() { - processor.importStylesheet(testTransform); -} -</pre> -<p><code>importStylesheet</code> requiert un argument, un nœud DOM. Si ce nœud est un nœud de document, nous pouvons passer par une transformation XSL ou une <a href="http://www.w3.org/TR/xslt#result-element-stylesheet">transformation littérale d'élément résultant</a>, autrement il devra être un élément <tt>xsl:stylesheet</tt> ou <tt>xsl:transform</tt>.</p> -<h3 id="Transformation_du_document">Transformation du document</h3> -<p>Nous pouvons utiliser les méthodes <a href="#transformToDocument"><code>transformToDocument()</code></a> ou <a href="#transformToFragment"><code>transformToFragment()</code></a> pour transformer un document à l'aide de la feuille de style spécifiée.</p> -<h4 id="transformToDocument">transformToDocument</h4> -<p><code>transformToDocument()</code> prend un argument, le nœud source à transformer, et retourne un nouveau <code>Document</code> DOM avec les résultats de la transformation :</p> -<pre class="eval">var newDocument = processor.transformToDocument(domToBeTransformed); -</pre> -<p>L'objet résultant est un <code>HTMLDocument</code> si la <a href="http://www.w3.org/TR/xslt#output">méthode de sortie</a> de la feuille de style est <tt>html</tt>, un <code>XMLDocument</code> pour <tt>xml</tt>, et pour la méthode de sortie <tt>text</tt> un <code>XMLDocument</code> avec uniquement un élément racine <code><transformiix:result></code> avec le texte comme descendant.</p> -<h4 id="transformToFragment">transformToFragment</h4> -<p>Nous pouvons également utiliser <code>transformToFragment()</code> qui retournera un nœud <code>DocumentFragment</code> 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.</p> -<p><code>transformToFragment</code> prend deux arguments : le document source à transformer (comme ci-dessus) et un objet <code>Document</code> qui possèdera le fragment (tous les fragments doivent être possédés par un document).</p> -<pre class="eval">var ownerDocument = document.implementation.createDocument("", "test", null); -var newFragment = processor.transformToFragment(domToBeTransformed, ownerDocument); -</pre> -<p><code>transformToFragment</code> ne produira que des objets HTML DOM que si le propriétaire du document est lui-même un <code>HTMLDocument</code>, ou si la méthode de sortie de la feuille de style est <tt>HTML</tt>. Il <b>ne produira pas</b> un objet HTML DOM si seul l'élément de haut niveau du résultat est <code><html></code> car <code>transformToFragment</code> est rarement utilisé pour créer cet élément. Si nous voulons annuler cela, nous pouvons définir la méthode de sortie normale par le moyen standard.</p> -<h3 id="D.C3.A9finition_des_param.C3.A8tres">Définition des paramètres</h3> -<p>Nous pouvons contrôler les <a href="http://www.w3.org/TR/xslt#variables">paramètres de la feuille de style</a> à l'aide des méthodes <code>setParameter</code>, <code>getParameter</code> et <code>removeParameter</code>. Elles nécessitent une URI d'espace de nommage et un nom local qui seront les deux premiers paramètres, <code>setParameter</code> sera un troisième paramètres — la valeur de ce dernier paramètre étant à définir.</p> -<h3 id="R.C3.A9initialisation">Réinitialisation</h3> -<p>L'objet <code>XSLTProcessor</code> implémente également une méthode <code>reset()</code> qui peut être utilisée pour supprimer toutes les feuilles de style et tous les paramètres puis ramener le processeur dans son état initial. Cette méthode est implémentée dans <a href="fr/Gecko">Mozilla</a> 1.3 et supérieurs.</p> -<h3 id="Ressources">Ressources</h3> -<ul> - <li><a href="https://dxr.mozilla.org/mozilla-central/source/content/xslt/public/nsIXSLTProcessor.idl">nsIXSLTProcessor.idl</a> reflètera toujours l'interface réelle de l'objet <code>XSLTProcessor</code>. - <ul> - <li><a href="http://xulplanet.com/references/objref/XSLTProcessor.html">A XULPlanet reference page (en)</a>.</li> - </ul> - </li> - <li><a href="http://lxr.mozilla.org/seamonkey/source/content/xslt/public/nsIXSLTProcessorObsolete.idl">The nsIXMLProcessorObsolete IDL file (en)</a> : l'interface JS dans les versions de Mozilla antérieures à la 1.2.</li> -</ul>
\ No newline at end of file +Ce document décrit l'interface JavaScript pour le moteur de traitement XSLT (TransforMiiX) de Mozilla 1.2 et supérieur. + +### Création de XSLTProcessor + +Pour commencer, nous avons besoin de créer un objet [XSLTProcessor](fr/XSLTProcessor) : + + var processor = new XSLTProcessor(); + +### Spécification de la feuille de style + +Avant d'utiliser cet objet, nous devons importer une feuille de style avec la fonction `importStylesheet()`. Elle a un unique paramètre, qui est le nœud DOM de la feuille de style XSLT à importer — remarquez que l'importation est directe, ce qui signifie que si nous modifions la feuille de style DOM après son importation, cela sera reflété lors du traitement. Il est cependant conseillé d'utiliser les paramètres de feuille de style plutôt que de modifier le DOM. C'est généralement plus facile et on obtient de meilleures performances. + + var testTransform = document.implementation.createDocument("", "test", null); + // juste un exemple pour obtenir une transformation dans un script étant donné que + // la fonction DOM XMLDocument.load est asynchrone, donc tout le traitement se fait + // dans le gestionnaire onload + testTransform.addEventListener("load", onload, false); + testTransform.load("test-transform.xml"); + function onload() { + processor.importStylesheet(testTransform); + } + +`importStylesheet` requiert un argument, un nœud DOM. Si ce nœud est un nœud de document, nous pouvons passer par une transformation XSL ou une [transformation littérale d'élément résultant](http://www.w3.org/TR/xslt#result-element-stylesheet), autrement il devra être un élément \<tt>xsl:stylesheet\</tt> ou \<tt>xsl:transform\</tt>. + +### Transformation du document + +Nous pouvons utiliser les méthodes [`transformToDocument()`](#transformToDocument) ou [`transformToFragment()`](#transformToFragment) pour transformer un document à l'aide de la feuille de style spécifiée. + +#### transformToDocument + +`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); + +L'objet résultant est un `HTMLDocument` si la [méthode de sortie](http://www.w3.org/TR/xslt#output) de la feuille de style est \<tt>html\</tt>, un `XMLDocument` pour \<tt>xml\</tt>, et pour la méthode de sortie \<tt>text\</tt> un `XMLDocument` avec uniquement un élément racine `<transformiix:result>` avec le texte comme descendant. + +#### transformToFragment + +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). + + var ownerDocument = document.implementation.createDocument("", "test", null); + var newFragment = processor.transformToFragment(domToBeTransformed, ownerDocument); + +`transformToFragment` ne produira que des objets HTML DOM que si le propriétaire du document est lui-même un `HTMLDocument`, ou si la méthode de sortie de la feuille de style est \<tt>HTML\</tt>. Il **ne produira pas** un objet HTML DOM si seul l'élément de haut niveau du résultat est `<html>` car `transformToFragment` est rarement utilisé pour créer cet élément. Si nous voulons annuler cela, nous pouvons définir la méthode de sortie normale par le moyen standard. + +### Définition des paramètres + +Nous pouvons contrôler les [paramètres de la feuille de style](http://www.w3.org/TR/xslt#variables) à l'aide des méthodes `setParameter`, `getParameter` et `removeParameter`. Elles nécessitent une URI d'espace de nommage et un nom local qui seront les deux premiers paramètres, `setParameter` sera un troisième paramètres — la valeur de ce dernier paramètre étant à définir. + +### Réinitialisation + +L'objet `XSLTProcessor` implémente également une méthode `reset()` qui peut être utilisée pour supprimer toutes les feuilles de style et tous les paramètres puis ramener le processeur dans son état initial. Cette méthode est implémentée dans [Mozilla](fr/Gecko) 1.3 et supérieurs. + +### Ressources + +- [nsIXSLTProcessor.idl](https://dxr.mozilla.org/mozilla-central/source/content/xslt/public/nsIXSLTProcessor.idl) reflètera toujours l'interface réelle de l'objet `XSLTProcessor`. + + - [A XULPlanet reference page (en)](http://xulplanet.com/references/objref/XSLTProcessor.html). + +- [The nsIXMLProcessorObsolete IDL file (en)](http://lxr.mozilla.org/seamonkey/source/content/xslt/public/nsIXSLTProcessorObsolete.idl) : l'interface JS dans les versions de Mozilla antérieures à la 1.2. 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 53cdc3e2d2..72c3c1d793 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 @@ -6,102 +6,98 @@ tags: translation_of: Web/XSLT/XSLT_JS_interface_in_Gecko/Advanced_Example original_slug: Web/XSLT/Interface_XSLT_JS_dans_Gecko/Exemple_avancé --- -<h2 id="Exemple_avanc.C3.A9">Exemple avancé</h2> +## Exemple avancé -<p>Dans l'exemple avancé, nous allons trier plusieurs <code>div</code> selon leur contenu. L'exemple permet de trier le contenu plusieurs fois, en alternant entre le tri ascendant et le tri descendant. Le JavaScript ne charge que le fichier .xsl la première fois, et définit la variable <code>xslloaded</code> à <code>true</code> une fois que le fichier est fini de chargé. En utilisant la méthode <code>getParameter</code> sur l'objet <code>XSLTProcessor</code> , le code peut estimer s'il faut trier de façon ascendante ou descendante. Il trie par défaut de manière ascendante si le paramètre est vide (lors du premier tri, car sa valeur n'est pas définie dans le fichier XSLT). La valeur du tri est définie à l'aide de <code>setParameter</code>.</p> +Dans l'exemple avancé, nous allons trier plusieurs `div` selon leur contenu. L'exemple permet de trier le contenu plusieurs fois, en alternant entre le tri ascendant et le tri descendant. Le JavaScript ne charge que le fichier .xsl la première fois, et définit la variable `xslloaded` à `true` une fois que le fichier est fini de chargé. En utilisant la méthode `getParameter` sur l'objet `XSLTProcessor` , le code peut estimer s'il faut trier de façon ascendante ou descendante. Il trie par défaut de manière ascendante si le paramètre est vide (lors du premier tri, car sa valeur n'est pas définie dans le fichier XSLT). La valeur du tri est définie à l'aide de `setParameter`. -<p>La fichier XSLT a un paramètre appelé <code>myOrder</code> que le JavaScript définit pour changer la méthode de tri. L'attribut <code>xsl:sort</code> d'ordre des éléments peut accéder à la valeur du paramètre en utilisant <code>$myOrder</code>. Cependant, la valeur a besoin d'être une expression XPath et non pas une chaîne, ainsi on utilise <code>{$myOrder}</code>. L'utilisation de <code>{}</code> évalue le contenu comme une expression XPath.</p> +La fichier XSLT a un paramètre appelé `myOrder` que le JavaScript définit pour changer la méthode de tri. L'attribut `xsl:sort` d'ordre des éléments peut accéder à la valeur du paramètre en utilisant `$myOrder`. Cependant, la valeur a besoin d'être une expression XPath et non pas une chaîne, ainsi on utilise `{$myOrder}`. L'utilisation de `{}` évalue le contenu comme une expression XPath. -<p>Une fois la transformation complétée, le résultat est ajouté au document, comme indiqué dans l'exemple.</p> +Une fois la transformation complétée, le résultat est ajouté au document, comme indiqué dans l'exemple. -<p><small><strong>Figure 7 : Tri selon le contenu des divvoir l'exemple</strong></small></p> +**Figure 7 : Tri selon le contenu des divvoir l'exemple** +_Fragment XHTML :_ -<p><em>Fragment XHTML :</em></p> + <div id="example"> + <div>1</div> + <div>2</div> + <div>3</div> + <div>4</div> + <div>5</div> + <div>6</div> + <div>7</div> + <div>8</div> + <div>9</div> + <div>10</div> + </div> -<pre><div id="example"> - <div>1</div> - <div>2</div> - <div>3</div> - <div>4</div> - <div>5</div> - <div>6</div> - <div>7</div> - <div>8</div> - <div>9</div> - <div>10</div> -</div> -</pre> +_JavaScript_ -<p><em>JavaScript</em></p> + var xslRef; + var xslloaded = false; + var xsltProcessor = new XSLTProcessor(); + var myDOM; -<pre>var xslRef; -var xslloaded = false; -var xsltProcessor = new XSLTProcessor(); -var myDOM; + var xmlRef = document.implementation.createDocument("", "", null); -var xmlRef = document.implementation.createDocument("", "", null); + function sort() { + if (!xslloaded){ + p = new XMLHttpRequest(); + p.open("GET", "example2.xsl", false); + p.send(null); -function sort() { - if (!xslloaded){ - p = new XMLHttpRequest(); - p.open("GET", "example2.xsl", false); - p.send(null); + xslRef = p.responseXML; + xsltProcessor.importStylesheet(xslRef) + xslloaded = true; + } - xslRef = p.responseXML; - xsltProcessor.importStylesheet(xslRef) - xslloaded = true; - } + // création d'un nouveau document XML en mémoire + xmlRef = document.implementation.createDocument("", "", null); - // création d'un nouveau document XML en mémoire - xmlRef = document.implementation.createDocument("", "", null); + // nos voulons déplacer une partie du DOM depuis le document HTML vers le document XML. + // importNode est utilisé pour cloner les nœuds que nous voulons traiter via XSLT + // true permet une copie profonde + var myNode = document.getElementById("example"); + var clonedNode = xmlRef.importNode(myNode, true); - // nos voulons déplacer une partie du DOM depuis le document HTML vers le document XML. - // importNode est utilisé pour cloner les nœuds que nous voulons traiter via XSLT - // true permet une copie profonde - var myNode = document.getElementById("example"); - var clonedNode = xmlRef.importNode(myNode, true); + // après le clonage, nous ajoutons + xmlRef.appendChild(clonedNode); - // après le clonage, nous ajoutons - xmlRef.appendChild(clonedNode); + // définition du paramètre de tri dans le fichier XSL + var sortVal = xsltProcessor.getParameter(null, "myOrder"); - // définition du paramètre de tri dans le fichier XSL - var sortVal = xsltProcessor.getParameter(null, "myOrder"); + if (sortVal == "" || sortVal == "descending") + xsltProcessor.setParameter(null, "myOrder", "ascending"); + else + xsltProcessor.setParameter(null, "myOrder", "descending"); - if (sortVal == "" || sortVal == "descending") - xsltProcessor.setParameter(null, "myOrder", "ascending"); - else - xsltProcessor.setParameter(null, "myOrder", "descending"); + // initialisation de la transformation + var fragment = xsltProcessor.transformToFragment(xmlRef, document); - // initialisation de la transformation - var fragment = xsltProcessor.transformToFragment(xmlRef, document); + // effacement des contenus + document.getElementById("example").innerHTML = ""; - // effacement des contenus - document.getElementById("example").innerHTML = ""; + myDOM = fragment; + // ajout du nouveau contenu depuis la transformation + document.getElementById("example").appendChild(fragment) + } - myDOM = fragment; - // ajout du nouveau contenu depuis la transformation - document.getElementById("example").appendChild(fragment) -} -</pre> +_Feuille de style XSL :_ -<p><em>Feuille de style XSL :</em></p> + <?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"> + <xsl:output method="html" indent="yes" /> -<pre><?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"> - <xsl:output method="html" indent="yes" /> + <xsl:param name="myOrder" /> - <xsl:param name="myOrder" /> + <xsl:template match="/"> - <xsl:template match="/"> + <xsl:apply-templates select="/div//div"> + <xsl:sort select="." data-type="number" order="{$myOrder}" /> + </xsl:apply-templates> + </xsl:template> - <xsl:apply-templates select="/div//div"> - <xsl:sort select="." data-type="number" order="{$myOrder}" /> - </xsl:apply-templates> - </xsl:template> - - <xsl:template match="div"> - <xsl:copy-of select="." /> - </xsl:template> -</xsl:stylesheet> -</pre>
\ No newline at end of file + <xsl:template match="div"> + <xsl:copy-of select="." /> + </xsl:template> + </xsl:stylesheet> 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 cc8a0b54ed..f1519ecde1 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 @@ -6,130 +6,127 @@ tags: translation_of: Web/XSLT/XSLT_JS_interface_in_Gecko/Basic_Example original_slug: Web/XSLT/Interface_XSLT_JS_dans_Gecko/Exemple_basique --- -<h2 id="Exemple_basique">Exemple basique</h2> +## Exemple basique -<p>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 <a href="fr/XSLT_dans_Gecko/G%c3%a9n%c3%a9ration_de_HTML">Génération de HTML</a> de l'article <a href="fr/XSLT_dans_Gecko">XSLT dans Gecko</a>. Le fichier XML décrit un article et le fichier XSL formate les informations pour l'affichage.</p> +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. -<p><small><strong>Figure 4 : fichier XML</strong></small></p> +**Figure 4 : fichier XML** -<p>Document XML (example1.xml):</p> +Document XML (example1.xml): -<pre> <?xml version="1.0"?> - <myNS:Article - xmlns:myNS="http://devedge.netscape.com/2002/de"> - <myNS:Title>Mon article</myNS:Title> - <myNS:Authors> - <myNS:Author company="Foopy Corp.">M. Foo</myNS:Author> - <myNS:Author>M. Bar</myNS:Author> - </myNS:Authors> - <myNS:Body> - En <em>Espagne</em>, les <strong>pluies</strong> se concentrent - principalement dans les plaines. - </myNS:Body> - </myNS:Article> -</pre> + <?xml version="1.0"?> + <myNS:Article + xmlns:myNS="http://devedge.netscape.com/2002/de"> + <myNS:Title>Mon article</myNS:Title> + <myNS:Authors> + <myNS:Author company="Foopy Corp.">M. Foo</myNS:Author> + <myNS:Author>M. Bar</myNS:Author> + </myNS:Authors> + <myNS:Body> + En <em>Espagne</em>, les <strong>pluies</strong> se concentrent + principalement dans les plaines. + </myNS:Body> + </myNS:Article> -<p><small><strong>Figure 5 : feuille de style XSLT</strong></small></p> +**Figure 5 : feuille de style XSLT** -<p>feuille de style XSL (example1.xsl):</p> +feuille de style XSL (example1.xsl): -<pre> <?xml version="1.0"?> - <xsl:stylesheet version="1.0" - xmlns:xsl="http://www.w3.org/1999/XSL/Transform" - xmlns:myNS="http://devedge.netscape.com/2002/de"> + <?xml version="1.0"?> + <xsl:stylesheet version="1.0" + xmlns:xsl="http://www.w3.org/1999/XSL/Transform" + xmlns:myNS="http://devedge.netscape.com/2002/de"> - <xsl:output method="html" /> + <xsl:output method="html" /> - <xsl:template match="/"> - <html> + <xsl:template match="/"> + <html> - <head> + <head> - <title> - <xsl:value-of select="/myNS:Article/myNS:Title"/> - </title> + <title> + <xsl:value-of select="/myNS:Article/myNS:Title"/> + </title> - <style type="text/css"> - .myBox {margin:10px 155px 0 50px; border: 1px dotted #639ACE; padding:0 5px 0 5px;} - </style> + <style type="text/css"> + .myBox {margin:10px 155px 0 50px; border: 1px dotted #639ACE; padding:0 5px 0 5px;} + </style> - </head> + </head> - <body> - <p class="myBox"> - <span class="title"> - <xsl:value-of select="/myNS:Article/myNS:Title"/> - </span> <br /> + <body> + <p class="myBox"> + <span class="title"> + <xsl:value-of select="/myNS:Article/myNS:Title"/> + </span> <br /> - Auteurs : <br /> - <xsl:apply-templates select="/myNS:Article/myNS:Authors/myNS:Author"/> - </p> + Auteurs : <br /> + <xsl:apply-templates select="/myNS:Article/myNS:Authors/myNS:Author"/> + </p> - <p class="myBox"> - <xsl:apply-templates select="//myNS:Body"/> - </p> + <p class="myBox"> + <xsl:apply-templates select="//myNS:Body"/> + </p> - </body> + </body> - </html> - </xsl:template> + </html> + </xsl:template> - <xsl:template match="myNS:Author"> - -- <xsl:value-of select="." /> + <xsl:template match="myNS:Author"> + -- <xsl:value-of select="." /> - <xsl:if test="@company"> - :: <strong> <xsl:value-of select="@company" /> </strong> - </xsl:if> + <xsl:if test="@company"> + :: <strong> <xsl:value-of select="@company" /> </strong> + </xsl:if> - <br /> - </xsl:template> + <br /> + </xsl:template> - <xsl:template match="myNS:Body"> - <xsl:copy> - <xsl:apply-templates select="@*|node()"/> - </xsl:copy> - </xsl:template> + <xsl:template match="myNS:Body"> + <xsl:copy> + <xsl:apply-templates select="@*|node()"/> + </xsl:copy> + </xsl:template> - <xsl:template match="@*|node()"> - <xsl:copy> - <xsl:apply-templates select="@*|node()"/> - </xsl:copy> - </xsl:template> - </xsl:stylesheet> -</pre> + <xsl:template match="@*|node()"> + <xsl:copy> + <xsl:apply-templates select="@*|node()"/> + </xsl:copy> + </xsl:template> + </xsl:stylesheet> -<p>L'exemple charge en mémoire les deux fichiers .xsl (<code>xslStylesheet</code>) et .xml (<code>xmlDoc</code>) à l'aide de <code>XMLHTTPRequest</code> synchrone. Le fichier .xsl est alors importé (<code>xsltProcessor.importStylesheet(xslStylesheet)</code>) et la transformation exécutée (<code>xsltProcessor.transformToFragment(xmlDoc, document)</code>). Cela permet d'extraire des données après le chargement de la page, sans avoir à la rafraîchir.</p> +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. -<p><small><strong>Figure 6 : Exemple voir l'exemple</strong></small></p> +**Figure 6 : Exemple voir l'exemple** -<pre>var xslStylesheet; -var xsltProcessor = new XSLTProcessor(); -var myDOM; + var xslStylesheet; + var xsltProcessor = new XSLTProcessor(); + var myDOM; -var xmlDoc; + var xmlDoc; -function Init(){ + function Init(){ - // chargement du fichier xslt, example1.xsl - var myXMLHTTPRequest = new XMLHttpRequest(); - myXMLHTTPRequest.open("GET", "example1.xsl", false); - myXMLHTTPRequest.send(null); + // chargement du fichier xslt, example1.xsl + var myXMLHTTPRequest = new XMLHttpRequest(); + myXMLHTTPRequest.open("GET", "example1.xsl", false); + myXMLHTTPRequest.send(null); - xslStylesheet = myXMLHTTPRequest.responseXML; - xsltProcessor.importStylesheet(xslStylesheet); + xslStylesheet = myXMLHTTPRequest.responseXML; + xsltProcessor.importStylesheet(xslStylesheet); - // chargement du fichier xml, example1.xml - myXMLHTTPRequest = new XMLHttpRequest(); - myXMLHTTPRequest.open("GET", "example1.xml", false); - myXMLHTTPRequest.send(null); + // chargement du fichier xml, example1.xml + myXMLHTTPRequest = new XMLHttpRequest(); + myXMLHTTPRequest.open("GET", "example1.xml", false); + myXMLHTTPRequest.send(null); - xmlDoc = myXMLHTTPRequest.responseXML; + xmlDoc = myXMLHTTPRequest.responseXML; - var fragment = xsltProcessor.transformToFragment(xmlDoc, document); + var fragment = xsltProcessor.transformToFragment(xmlDoc, document); - document.getElementById("example").innerHTML = ""; + document.getElementById("example").innerHTML = ""; - myDOM = fragment; - document.getElementById("example").appendChild(fragment); -} -</pre> + myDOM = fragment; + document.getElementById("example").appendChild(fragment); + } diff --git a/files/fr/web/xslt/xslt_js_interface_in_gecko/index.md b/files/fr/web/xslt/xslt_js_interface_in_gecko/index.md index 31661c80aa..8224702af5 100644 --- a/files/fr/web/xslt/xslt_js_interface_in_gecko/index.md +++ b/files/fr/web/xslt/xslt_js_interface_in_gecko/index.md @@ -8,12 +8,10 @@ tags: translation_of: Web/XSLT/XSLT_JS_interface_in_Gecko original_slug: Web/XSLT/Interface_XSLT_JS_dans_Gecko --- -<ol> - <li><a href="/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/Introduction">Introduction</a></li> - <li><a href="/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/JavaScript_XSLT_Bindings">JavaScript/XSLT Bindings</a></li> - <li><a href="/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/Basic_Example">Basic Example</a></li> - <li><a href="/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/Setting_Parameters">Setting Parameters</a></li> - <li><a href="/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/Advanced_Example">Advanced Example</a></li> - <li><a href="/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/Interface_List">Interface List</a></li> - <li><a href="/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/Resources">Resources</a></li> -</ol> +1. [Introduction](/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/Introduction) +2. [JavaScript/XSLT Bindings](/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/JavaScript_XSLT_Bindings) +3. [Basic Example](/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/Basic_Example) +4. [Setting Parameters](/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/Setting_Parameters) +5. [Advanced Example](/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/Advanced_Example) +6. [Interface List](/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/Interface_List) +7. [Resources](/fr/docs/XSLT/XSLT_JS_Interface_in_Gecko/Resources) 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 5e8f3914b5..6ba6e8e47a 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 @@ -6,54 +6,50 @@ tags: translation_of: Web/XSLT/XSLT_JS_interface_in_Gecko/JavaScript_XSLT_Bindings original_slug: Web/XSLT/Interface_XSLT_JS_dans_Gecko/Les_liaisons_JavaScript_XSLT --- -<h2 id="Les_liaisons_JavaScript.2FXSLT">Les liaisons JavaScript/XSLT</h2> +## Les liaisons JavaScript/XSLT -<p>JavaScript peut exécuter des transformations XSLT à travers l'objet <code>XSLTProcessor</code>. Un fois instancié, un <code>XSLTProcessor</code> a une méthode <code>importStylesheet</code> 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 <code>importStylesheet</code>. Cela peut être fait par <code>XMLHttpRequest</code> ou par <code>XMLDocument.load</code>.</p> +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`. -<p><small><strong>Figure 1 : Instanciation d'un XSLTProcessor</strong></small></p> +**Figure 1 : Instanciation d'un XSLTProcessor** -<pre> var xsltProcessor = new XSLTProcessor(); + var xsltProcessor = new XSLTProcessor(); - // Chargement du fichier xsl à l'aide de XMLHttpRequest synchrone - (le 3° paramètre est défini à false - var myXMLHTTPRequest = new XMLHttpRequest(); - myXMLHTTPRequest.open("GET", "example.xsl", false); - myXMLHTTPRequest.send(null); + // Chargement du fichier xsl à l'aide de XMLHttpRequest synchrone + (le 3° paramètre est défini à false + var myXMLHTTPRequest = new XMLHttpRequest(); + myXMLHTTPRequest.open("GET", "example.xsl", false); + myXMLHTTPRequest.send(null); - var xslRef = myXMLHTTPRequest.responseXML; + var xslRef = myXMLHTTPRequest.responseXML; - // Importation du .xsl - xsltProcessor.importStylesheet(xslRef); -</pre> + // Importation du .xsl + xsltProcessor.importStylesheet(xslRef); -<p>Pour la transformation réelle, <code>XSLTProcessor</code> 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 <code>example</code>, que le DOM peut être « cloné » (ou dupliqué) à l'aide de ma méthode <code>importNode</code> du document XML en mémoire. <code>importNode</code> 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 à <code>true</code>, 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 <code>appendChild</code>, comme indiqué sur la figure 2.</p> +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. -<p><small><strong>Figure 2 : Création d'un document XML à partir d'un DOM document</strong></small></p> +**Figure 2 : Création d'un document XML à partir d'un DOM document** -<pre> // création d'u nouveau document XML en mémoire - var xmlRef = document.implementation.createDocument("", "", null); + // création d'u nouveau document XML en mémoire + var xmlRef = document.implementation.createDocument("", "", null); - // nous voulons déplacer une partie du DOM depuis un document HTML vers un document XML. - // importNode est utilisée pour cloner les nœuds que nous voulons traiter via XSLT - // true permet une copie conforme - var myNode = document.getElementById("example"); - var clonedNode = xmlRef.importNode(myNode, true); + // nous voulons déplacer une partie du DOM depuis un document HTML vers un document XML. + // importNode est utilisée pour cloner les nœuds que nous voulons traiter via XSLT + // true permet une copie conforme + var myNode = document.getElementById("example"); + var clonedNode = xmlRef.importNode(myNode, true); - // Ajout du DOM cloné dans le document XML - xmlRef.appendChild(clonedNode); -</pre> + // Ajout du DOM cloné dans le document XML + xmlRef.appendChild(clonedNode); -<p>Une fois la feuille de style importée, <code>XSLTProcessor</code> doit exécuter deux méthodes pour la transformations réelle, à savoir <code>transformToDocument()</code> et <code>transformToFragment()</code>. <code>transformToDocument()</code> retourne un document XML entier alors que <code>transformToFragment()</code> 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. <code> transformToFragment()</code> 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.</p> +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. -<p><small><strong>Figure 2.1 : Création d'un document XML à partir d'une chaîne 'soupe XML'</strong></small></p> +**Figure 2.1 : Création d'un document XML à partir d'une chaîne 'soupe XML'** -<p>Alors que nous pouvons utiliser la méthode <code>loadXML</code> 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<em>DomParser</em> .</p> +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* . -<pre class="eval">var parser = new DOMParser(); -var doc = parser.parseFromString(aStr, "text/xml"); -</pre> + var parser = new DOMParser(); + var doc = parser.parseFromString(aStr, "text/xml"); -<p><small><strong>Figure 3 : Exécution de la transformation</strong></small></p> +**Figure 3 : Exécution de la transformation** -<pre class="eval"> var fragment = xsltProcessor.transformToFragment(xmlRef, document); -</pre> + var fragment = xsltProcessor.transformToFragment(xmlRef, document); diff --git a/files/fr/web/xslt/xslt_js_interface_in_gecko/resources/index.md b/files/fr/web/xslt/xslt_js_interface_in_gecko/resources/index.md index 55374adcd1..b0ef35fa82 100644 --- a/files/fr/web/xslt/xslt_js_interface_in_gecko/resources/index.md +++ b/files/fr/web/xslt/xslt_js_interface_in_gecko/resources/index.md @@ -4,23 +4,19 @@ slug: Web/XSLT/XSLT_JS_interface_in_Gecko/Resources translation_of: Web/XSLT/XSLT_JS_interface_in_Gecko/Resources original_slug: Web/XSLT/Interface_XSLT_JS_dans_Gecko/Ressources --- -<p></p><ol> - <li><a href="/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko">Introduction</a></li> - <li><a href="/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko/Les_liaisons_JavaScript%2f%2fXSLT">Les liaisons JavaScript/XSLT</a></li> - <li><a href="/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko/Exemple_basique">Exemple basique</a></li> - <li><a href="/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko/D%c3%a9finition_de_param%c3%a8tres">Définition de paramètres</a></li> - <li><a href="/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko/Exemple_avanc%c3%a9">Exemple avancé</a></li> - <li><a href="/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko/Liste_des_interfaces">Liste des interfaces</a></li> - <li><a href="/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko/Ressources">Ressources</a></li> -</ol><p></p> +1. [Introduction](/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko) +2. [Les liaisons JavaScript/XSLT](/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko/Les_liaisons_JavaScript%2f%2fXSLT) +3. [Exemple basique](/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko/Exemple_basique) +4. [Définition de paramètres](/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko/D%c3%a9finition_de_param%c3%a8tres) +5. [Exemple avancé](/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko/Exemple_avanc%c3%a9) +6. [Liste des interfaces](/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko/Liste_des_interfaces) +7. [Ressources](/fr/docs/L'interface_XSLT%2f%2fJavaScript_dans_Gecko/Ressources) -<h2 id="Ressources">Ressources</h2> +## Ressources -<ul> - <li><a href="/fr/docs/L'interface_XSLT_JavaScript_dans_Gecko/fr/XSLT_dans_Gecko">XSLT dans Gecko</a></li> - <li><a href="/fr/docs/L'interface_XSLT_JavaScript_dans_Gecko/fr/Utilisation_de_l'interface_JavaScript_de_Mozilla_pour_les_transformations_XSL">Utilisation de l'interface JavaScript de Mozilla pour les transformations XSL</a></li> - <li><a href="/en-US/docs/Web/XSLT">Page du projet XSLT sur Mozilla.org (en)</a>, qui contient une section concernant les problèmes fréquemment rencontrés.</li> - <li><a href="https://msdn.microsoft.com/library/default.asp?url=/library/en-us/xmlsdk30/htm/xmconusingthexslprocessor.asp">MSDN documentation on IE/XSLT bindings (en)</a></li> -</ul> +- [XSLT dans Gecko](/fr/docs/L'interface_XSLT_JavaScript_dans_Gecko/fr/XSLT_dans_Gecko) +- [Utilisation de l'interface JavaScript de Mozilla pour les transformations XSL](/fr/docs/L'interface_XSLT_JavaScript_dans_Gecko/fr/Utilisation_de_l'interface_JavaScript_de_Mozilla_pour_les_transformations_XSL) +- [Page du projet XSLT sur Mozilla.org (en)](/en-US/docs/Web/XSLT), qui contient une section concernant les problèmes fréquemment rencontrés. +- [MSDN documentation on IE/XSLT bindings (en)](https://msdn.microsoft.com/library/default.asp?url=/library/en-us/xmlsdk30/htm/xmconusingthexslprocessor.asp) -<p>{{Previous("L\'interface XSLT/JavaScript dans Gecko:Liste des interfaces")}}</p> +{{Previous("L\'interface XSLT/JavaScript dans Gecko:Liste des interfaces")}} 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 64ccbacedf..d7f841f350 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 @@ -6,25 +6,23 @@ tags: translation_of: Web/XSLT/XSLT_JS_interface_in_Gecko/Setting_Parameters original_slug: Web/XSLT/Interface_XSLT_JS_dans_Gecko/Définition_de_paramètres --- -<h2 id="D.C3.A9finition_de_param.C3.A8tres">Définition de paramètres</h2> +## Définition de paramètres -<p>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.</p> +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. -<p>XSLT fournit l'élément <code>xsl:param</code>, qui est un descendant de l'élément <code>xsl:stylesheet</code>. <code>XSLTProcessor()</code> fournit trois méthodes JavaScript pour interagir avec ces paramètres : <code>setParameter</code>, <code>getParameter</code> et <code>removeParameter</code>. Elles prennent toutes comme premier argument l'URI de l'espace de nommage de <code>xsl:param</code> (normalement, <code>param</code> tombera dans l'espace de nommage par défaut, ainsi le passer à <code>null</code> suffira). Le nom local de <code>xsl:param</code> est le second argument. <code>setParameter</code> requiert un troisième argument, à savoir la valeur à laquelle le paramètre sera défini.</p> +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. -<p><small><strong>Figure 7 : Paramètres</strong></small></p> +**Figure 7 : Paramètres** -<p><em>XSLT :</em></p> +_XSLT :_ -<pre><xsl:param name="myOrder" /> -</pre> + <xsl:param name="myOrder" /> -<p><em>JavaScript :</em></p> +_JavaScript :_ -<pre>var sortVal = xsltProcessor.getParameter(null, "monOrdre"); + var sortVal = xsltProcessor.getParameter(null, "monOrdre"); -if (sortVal == "" || sortVal == "descendant") - xsltProcessor.setParameter(null, "monOrdre", "ascendant"); -else - xsltProcessor.setParameter(null, "monOrdre", "descendant"); -</pre> + if (sortVal == "" || sortVal == "descendant") + xsltProcessor.setParameter(null, "monOrdre", "ascendant"); + else + xsltProcessor.setParameter(null, "monOrdre", "descendant"); |