Tutoriel Transformation et Formatage de documents XML
Les technologies XML
Cours 2 : Transformation et Formatage de documents XML : Cours 2.2 : XSLT
Novembre 2010
- Version 3.2 -
SOMMAIRE DU COURS
TRANSFORMATIONS DE DOCUMENTS XML
Introduction à XSL
Noeuds et arbre XML
XSLT en bref
Objectifs
Principes
Exemple XML + XSL ? XHTML
XSL en résumé
Structure d'un document XML
Règles de transformation
Variables et paramètres
Fonctions
Conclusion
Les outils destinés à transformer les documents XML représentent ceux-ci comme un arbre de nœuds XML.
XSL est le langage qui permet d’écrire des feuilles de style. Une feuille de style est constituée d’un ensemble de règles de transformations, s’appliquant chacune à un ou plusieurs nœuds de l’arbre et permettant de transformer ce nœud en un nouveau nœud de l’arbre résultat.
XSL est plus riche que CSS :
XSL supporte toutes les fonctionnalités de la norme CSS1 et a été conçu dans la perspective de pouvoir facilement "traduire" une feuille de style CSS en feuille de style XSL (et vice-versa pour des feuilles XSL simples).
XSL apporte des mécanisme de sélection des cibles stylistiques plus performant que celui de CSS ainsi que des mécanismes de ré-organisation des données.
Il existe décomposé en trois parties :
XSL Transform (XSLT)
XSL Formatting Object (XSL-FO) XML Path Language (XPATH)
XSL : eXtensible Stylesheet Language.
Objectifs : Ce langage déclaratif permet de transformer un document XML en :
un autre document texte ou XML (XHTML, ) via XSLT
audio, etc. via XSL-FO
RAPPEL : LES DIFFERENTS
TYPES DE NOEUDS 1/2
Exemple de fichiers XML :
RAPPEL : LES DIFFERENTS
TYPES DE NOEUDS 2/2
Arbre correspondant :
Principes :
Le langage XSLT décrit des règles pour transformer un document XML.
Ces règles de transformations s’appliquent chacune à un ou plusieurs nœuds de l’arbre et spécifient la transformation à effectuer sur un nœud pour le transformer en un nouveau nœud de l’arbre résultat.
Un processeur XSLT lit d’une part un document XML et d’autre part un document XSLT et génère un nouveau document en appliquant les règles de transformation.
Fonctions de base (transformations) offertes par une feuille de style XSLT : extraction de données génération de texte suppression de contenu (noeuds) déplacement de contenu (noeuds) duplication de contenu (noeuds) tri de données
Site de référence :
Dans l’exemple qui suit, on souhaite transformer un document XML en document HTML :
Document XML source:
<personne id="0001">
<nom>Durand</nom>
<prénom>Martine</prénom>
</personne>
Document HTML cible :
<html>
<body>
<p><b>Durand</b> Martine</p>
</body>
</html>
Document XSLT correspondant :
<xsl:stylesheet xmlns:xsl="">
<xsl:output method="html" indent="yes"/> <xsl:template match="personne">
<html>
<body>
<p>
<b>
<xsl:value-of select="nom"/>
</b>
<xsl:value-of select="prenom"/>
</p>
</body>
</html>
</xsl:template>
</xsl:stylesheet>
Un exemple complet: XML & XSL
Le fichier (eXtensible Markup Language) :
<?xml version="1.0" encoding="iso88591" ?>
<!DOCTYPE stock SYSTEM "">
<stock>
<produit>
<nom> Livre </nom>
<prix monnaie="Francs"> 50 </prix>
<comment> Un article très recherché </comment>
</produit>
<produit>
<nom> CD </nom><prix monnaie="Euros"> 23 </prix>
</produit>
</stock>
Un exemple complet: production HTML
le traitement des fichiers , , donne le fichier suivant:
<html>
<body>
<h1>Stock de la société</h1>
<h2>Produit Livre </h2>
<p>Prix : 50 en Francs</p>
<p> Un article très recherché </p>
<h2>Produit CD </h2>
<p>Prix : 23 en Euros</p>
</body>
</html>
Un exemple complet: XSL
Le fichier (eXtensible Style Language) :
<?xml version="1.0" encoding="iso88591" ?>
<xsl:stylesheet
xmlns:xsl="; version="1.0">
<xsl:output method="html"/>
<xsl:template match="/">
<html><body>
<xsl:applytemplates/>
</body></html>
</xsl:template>
<xsl:template match="stock">
<h1>Stock de la société</h1>
<xsl:applytemplates/>
</xsl:template>
<xsl:template match="produit">
<h2>Produit <xsl:valueof select="nom"/></h2>
<p>Prix : <xsl:valueof select="prix"/>
en <xsl:valueof select="prix/@monnaie"/></p>
<xsl:if test="comment">
<p><xsl:valueof select="comment"/></p>
</xsl:if>
</xsl:template>
</xsl:stylesheet>
STRUCTURE D’UN DOCUMENT XSLT
1/6
Structure d’un document XSLT :
<xsl:stylesheet version="1.0"
xmlns:xsl=";>
<xsl:import href=" "/>
<xsl:include href=" "/>
<xsl:stripspace elements=" "/>
<xsl:preservespace elements=" "/>
<xsl:output method=" "/>
<xsl:key name=" " match=" " use=" "/>
<xsl:decimalformat name=" "/>
<xsl:attributeset name=" "> </xsl:attributeset>
<xsl:variable name=" "> </xsl:variable>
<xsl:param name=" "> </xsl:param>
<xsl:template match=" "> </xsl:template>
<xsl:template name=" "> </xsl:template> </xsl:stylesheet>
STRUCTURE D’UN DOCUMENT XSLT
2/6
L’élément racine : <xsl:stylesheet>
L’attribut version indique la version de XSLT exigées par la feuille de styles
L’attribut xmlns:xsl indique l’URI de l’espace de nom xsl (il est nécessaire pour indiquer à un éventuel processeur XSL que notre fichier est du XSL valide).
Les éléments fils de <xsl:stylesheet> sont appelés éléments de premier niveau
DOCUMENT XSLT 3/6
<xsl:import> et <xsl:include> permettent d’inclure des règles d’un document XSLT dans un autre.
La différence entre ces 2 instructions résident dans la gestion des conflits en terme d’application des règles :
? avec xsl:import les règles importées ont une préséance moindre que celles du programme importateur (l’ordre d’importation est important)
? avec xsl:include il n’y a pas de notion de préséance xsl:import doit être le premier élément de premier niveau du programme.
DOCUMENT XSLT 4/6
<xsl:output> permet de définir le format de sortie.
Exemple :
<xsl:output method=“html” indent=“yes” encoding=“iso-8859-1”>
Cette déclaration précise que : ?le document cible est le format HTML,
? le fichier cible sera indenté,
? les caractères du fichier XML d’entrée sont encodé selon la norme iso-8859-1.
XHTML est du xml, donc method=“xml” !!
DOCUMENT XSLT 5/6
<xsl:output> (suite) :
La notion d’encoding a son importance si le fichier XML contient des caractères
accentués et est déclaré avec l’entête <?xml version=1.0 encoding=iso-8859-1 ?>.
En effet le fichier XML sera correctementtransformé si l’on déclare le même encodageau niveau du XML et du XSLT.
DOCUMENT XSLT 6/6
<xsl:strip-space> et <xsl:preserve-space> :
<xsl:strip-space elements="liste_éléments"/> permet la suppression des espaces blancs superflus pour les éléments énumérés dans la liste.
? Exemple :
<xsl:strip-space elements="nom prenom"/>
<xsl:preserve-spaceelements="liste_éléments"/> permet de préserver les espaces blancs tels quels pour des éléments énumérés dans une liste.
? Exemple :
<xsl:preserve-space elements="adresse"/>
TRANSFORMATION 1/11
<xsl:template> définit une règle XSLT :
Un document XSLT se compose d’un ensemble de règles (template) permettant de construire le résultat.
L’application d’une règle produit un fragment du document résultat.
L’ordre des règles n’a pas d’importance.
Une règle s’applique dans le contexte d’un nœud de l’arbre.
Le corps d’une règle se compose d’un ensemble d’instructions.
TRANSFORMATION 2/11
<xsl:templatematch="pattern" name= "qname"> :
L'attribut match est un motif (XPath) qui identifie le ou les nœud(s) source pour lesquels la règle s'applique. Cet attribut est exigé à moins que l'élément <xsl:template> ait un attribut name.
Exemple :
<xsl:template match="personne">
<B><xsl:valueof select="nom"/></B>
<xsl:valueof select="prenom"/>
</xsl:template>
Si un template contient du texte ou des éléments XML (autres que des instructions XSL), ces éléments seront écrits sur la sortie.
TRANSFORMATION 3/11
Les fonctions de création de noeuds:
Création d’un élément :
<xsl:element name=qname> Création d’un attribut :
<xsl:attribute name=qname> valeur Création de texte :
<xsl:text> texte
Création d’instructions de traitement :
<xsl:processing-instruction name=qname> Création de commentaires :
<xsl-comment> text
TRANSFORMATION 4/11
<xsl:value-of> et <xsl:copy-of>
<xsl:value-of> crée un nœud de type texte correspondant au résultat de l’évaluation de l’expression.
?Syntaxe :<xsl:value-of select="expr"/> ? Exemples :
<xsl:value-of select="nom"/>
<xsl:value-of select="montant@devise"/> <xsl:copy-of> fournit un moyen simple pour copier le nœud courant.
?Syntaxe :<xsl:copy select="pattern"/> ? Exemple :
<xsl:copy-of select="personne"/>
TRANSFORMATION 5/11
Les instructions <xsl:if> et <xsl-choose>:
L’attribut test spécifie une expression. Après évaluation de cette expression, le résultat est converti en booléen. Si le résultat est vrai alors le contenu du modèle est appliqué, sinon rien. Exemples :
<xsl:if test="@devise=‘EURO‘">
<img src="">
</xsl:if>
<xsl:choose>
<xsl:when test="@devise=‘EURO‘"> <img src="">
</xsl:when>
<xsl:otherwise>
<img src="">
</xsl:otherwise>
</xsl:choose>
TRANSFORMATION 6/11
L’instruction de répétition <xsl:for-each> :
Cet élément permet d'appliquer des règles de style sur chaque nœud identique d'un template. Le contenu de cette instruction est un modèle.
Exemple :
<xsl:for-each select="personne">
<tr>
<td><xsl:value-of select="nom"/></td> <td><xsl:value-of select="prenom"/></td>
</tr>
</xsl:for-each>
TRANSFORMATION 7/11
<xsl:sort> permet d'effectuer un tri sur des données selon des critères spécifiés:
Lorsqu'un élément <xsl:apply-templates> ou
<xsl:for-each> a un ou plusieurs fils <xsl:sort>, les nœuds sélectionnés sont triés et traités en fonction des clés de tri spécifiés. Lorsque des éléments xsl:sort sont utilisés dans xsl:for-each, ils doivent apparaître en premier.
Exemple :
<xsl:for-each select="personne">
<xsl:sort select="nom" order="ascending" data-type="text" case-order="lower-first"/>
</xsl:for-each>
TRANSFORMATION 8/11
<xsl:apply-templates> permet d’appliquer un modèle de manière récursive aux fils du nœud courant:
En l'absence de l'attribut select, l'instruction <xsl:apply-templates> traite tous les fils du nœud courant, y compris les nœuds textuels. Exemple :
<xsl:template match="personne">
<table>
<xsl:apply-templates select="nom">
<xsl:sort select="nom" order="ascending"/> </xsl:apply-templates>
</table>
</xsl:template>
<xsl:template match="nom">
<tr>…</tr>
</xsl:template>
TRANSFORMATION 9/11
Il existe trois façons d’appeler un template :
Sélectionner les nœuds à traiter à l’aide d’une requête XPath et leur appliquer les templates correspondants :
<xsl:apply-templates select="nom">
Appliquer les templates correspondants à tous les fils du nœud courant :
<xsl:apply-templates/>
Appeler un template grâce à son nom (à la manière d’un sous-programme). Contrairement aux deux méthodes précédentes, on ne l’applique pas à un ensemble de sous-éléments du nœud courant mais à ce même nœud (pas de changement de contexte).
<xsl:call-template name="nom">
TRANSFORMATION 10/11
Sélection d’une règle parmi plusieurs règles candidates:
Il existe des priorités implicites qui permettent au processeur de choisir
On peut aussi donner explicitement une priorité
Lorsque le choix est impossible, le processeur s’arrête.
Priorités implicite : plus c’est spécifique, plus c’est prioritaire
Priorité - 0.5 : Les motifs simples (autres qu’un nom d’élément ou d’attribut) tels que * par exemple.
Priorité 0 : Les motifsconstitués d’une seule étape XPath, avec un nom d’élément ou d’attribut et sans prédicat. Priorité 0.5 : Tous les autres (prédicats, plusieurs étapes)
TRANSFORMATION 11/11
Les modes:
Leur raison d’être réside dans le fait qu’un même nœud peut être traité par plusieurs règles (un chapitre par exemple peut être traité une fois pour construire l’index et une autre fois pour publier le contenu). Pour distinguer les deux règles, on les distinguera par mode.
<xsl:template match=“CHAPITRE"mode="INDEX">
<a href="#{TITRE}"><xsl:value-of select="TITRE"/></a>
</xsl:template>
<xsl:template match="CHAPITRE">
<a name="{TITRE}"/>
<h1><xsl:value-of select="TITRE"/></h1>
<p><xsl:value-of select=“TEXTE"/></p>
<br/>
</xsl:template>
VARIABLES ET PARAMETRES 1/2
<xsl:variable> définit une variable XSLT :
Syntaxe de la déclaration :
<xsl:variable name="MIN">0</xsl:variable>
<xsl:variable name="MAX" select="99"/> Syntaxe de l’invocation :
<xsl:apply-templates select="personne[$MIN]">
<xsl:text name="MAX">Max :{$MAX}</xsl:text> La portée d’une variable est limitée à l’élément dans lequel elle a été définie.
Une fois déclarée, la valeur d’une variable ne peut être modifiée par la suite.
VARIABLES ET
PARAMETRES 2/2
<xsl:param> définit un paramètre XSLT:
Syntaxe de la déclaration :
<xsl:param name="MIN">0</xsl:variable> <xsl:param name="MAX" select="99"/>
La principale différence entre une variable et un paramètre est qu’un paramètre peut être passé comme argument à un template. Cela se fait de la manière suivante :
<xsl:param name="MIN">0</xsl:param>
<xsl:call-template name="annee">
<xsl:with-param name="MIN" select="$MIN+1"/>
</xsl:call-template>
FONCTIONS XSLT 1/2
XSLT fournit un certain nombre de fonctions :
La fonction format-number convertit son premier argument en une chaîne utilisant le motif de formatage spécifié par le second argument.
Ce motif de formatage est composée d’un préfixe optionnel, d’un motif de formatage et d’un suffixe optionnel. Le motif de formatage est une séquence de caractères spéciaux définis dans le tableau ci-dessous :
Exemples :
<xsl:value-of select="format-number($REMISE,’ ##% ’)"/>
<xsl:value-of select="format-number(PRIX,’##,##0.00 FF ’)"/>
FONCTIONS XSLT 2/2
Caractères de formattage de la fonction format-number :
CONCLUSION SUR XSLT
Avantages d’XSLT :
A partir d’un même document XML, on peut générer plusieurs formats en sortie (HTML, WML…)
Inconvénients d’XSLT :
Bien que la version 1.0 ait été stabilisée, les outils implémentant XSLT ne respectent pas tous la recommandation (fonctionnalités manquantes, ajout de fonctionnalités et d’éléments propriétaires).
XSLT versus CSS :
XSLT peut tout à fait être utilisé de manière combinée avec les CSS, en particulier quand la cible est du HTML4 ou du XHTML1.