Apprendre XSLT cours
Règles XSLT
Règles XSLT
XSLT = production d’un document résultat à partir d’un document source.
Exemple de référence
Publication XSLT
Amann
Rigaux
Documents XML
Programmation XSLT
2003
Le document source
Structure d’un programme XSLT
Programme XSLT = document XML
Fiche du cours
L’élément xsl:stylesheet
Élement racine d’un programme:
xmlns:xsl="
tous les éléments XSLT doivent être qualifiés par l’espace de nom xsl:
Deux types d’éléments
On distingue :
Les éléments de premier niveau, fils de
.
Il s’agit essentiellement des règles
(template)
L’ordre des éléments n’a pas d’importance
Les instructions : on les trouve dans le corps des règles.
Type d’élément | Description |
xsl:import | Import d’un programme XSLT |
xsl:include | Inclusion d’un programme XSLT |
xsl:output | Indique le format de sortie |
xsl:param | Définit un paramètre |
xsl:template | Définit une règle XSLT |
xsl:variable | Définit une variable XSLT |
Principaux éléments de premier niveau
TAB. 1 –
xsl:import et xsl:include
Pour inclure des règles d’un programme dans un autre.
Différence: la gestion des conflits avec xsl:import les règles importées ont une préséance moindre que celles du programme importateur
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 à importer
Programme principal
On reprend la règle pour la racine du document, et on « surcharge » les autres.
Les règles XSLT
Exécution d’un programme XSLT
L’exécution d’un programme XSLT consiste à instancier des règles le corps de la règle est inséré dans le document résultat les instructions XSLT contenues dans le corps de la règle sont exécutées à leur tour le résultat d’une instruction vient remplacer cette instruction dans le résultat
Corps de règle: exemple
Des éléments littéraux, du texte et des éléments
XSLT
Voici le titre :
la règle s’instancie dans le contexte d’un nœud particulier (de type FILM)
Déclenchement de règles
On prend un nœud du document comme nœud contexte au départ c’est la racine du document
On cherche la règle qui s’applique à ce nœud
On insère le corps de la règle dans le document résultat
l’instruction xsl:apply-templates permet de sélectionner de nouveaux nœuds contexte
Exemple typique
Combinaison d’un xsl:template et de un ou plusieurs xsl:apply-templates
Règles: définition et déclenchement
Une règle est définie par l’élément xsl:template. Deux possibilités :
L’attribut match est un pattern XPath définissant les « cibles » de la règle
Ex : xsl:template match=’FILM’ déclenchement par xsl:apply-templates
L’attribut name donne un nom à la règle Ex : xsl:template name=’TDM’ déclenchement par xsl:call-template
Les patterns
On ne peut pas mettre n’importe quelle expression XPath dans l’attribut match.
L’expression doit toujours désigner un ensemble de nœuds
Pas bon :
De plus certaines expressions seraient trop complexes à évaluer. Interdit :
Exemple: des appels de règles
Trois appels xsl:apply-templates: on sélectionne des nœuds, en demandant l’application de règles.
Exemple: des patterns
Sélection des règles
Problème : étant donné un nœud, comment trouver la règle qui s’applique ?
Soit le nœud
Soit le pattern de la règle
S’il existe quelque part un nœud tel que l’évaluation de à partir de contient :
la règle s’applique
Exemple simple: la première règle
Au départ du processus :
Le nœud-contexte est la racine du document
Il existe une règle dont le pattern est « / » en prenant n’importe quel nœud,
l’évaluation de « / » est , donc la règle s’applique.
Il est donc bon (mais pas indispensable) d’avoir une règle avec pattern « / ».
Avec select=’//NOM’
Les nœuds sont ceux de type NOM. La règle suivante s’applique :
Car : en prenant pour nœud ENSEIGNANTS, et en évaluant l’expression NOM, on obtient le nœud contexte.
NB : la règle est déclenchée pour tous les nœuds de type NOM, quel que soit le père.
Avec select=’//SEANCE/@ID’
Les nœuds sont des attributs de nom ID. La règle suivante s’applique :
Car : en prenant pour nœud le père et en évaluant l’expression, on obtient le nœud contexte.
Même remarque : cette règle est déclenchée pour tous les attributs ID, quel que soit leur élémentpère.
Avec select=’//SEANCE’
Les nœuds sont les éléments SEANCE. La règle suivante s’applique :
Car : en prenant pour nœud l’élément COURS et en évaluant l’expression, on obtient le nœud contexte.
Cette fois la règle ne s’applique qu’aux élémentsSEANCEfils d’un élémentPROGRAMME
Patterns: ce qui est autorisé
Seulement les axes suivants :
Les fils d’un élément : child
Les attributs d’un élément : attribute
L’abréviation // de descendant-or-self::node()/
Pourquoi ? Parce qu’on peut savoir si une règle doit être déclenchée uniquement en regardant les ancêtres du nœud contexte
Autres exemples de patterns
/COURS/ENSEIGNANTS: nœuds
ENSEIGNANTS fils d’un élément racine COURS
//SEANCE[@ID=2] tout nœud de type SEANCE ayant un attribut ID valant 2
NOM[position()=2] tout nœud qui est le deuxième fils NOM de son père
/COURS/@CODE[.="TC234"] l’attribut de nom CODE, fils de l’élément racine
COURS , et de valeur TC234
Règles par défaut
Quand aucune règle n’est sélectionnée, XSLT applique des règles par défaut
Première règle pour les éléments et la racine du document.
on demande l’application de règles pour les fils du nœud courant.
Conséquence
On peut se contenter de définir une règle pour l’élément racine, et ignorer la racine du document.
corps de la règle
le processeur traite la racine du document
avec la règle par défaut.
l’instruction xsl:apply-templates de la règle par défaut déclenche la règle sur COURS.
Pour le texte et les attributs
Par défaut, on insère dans le document résultat la valeur du nœud Text, ou de l’attribut.
Cela suppose (surtout pour les attributs) d’avoir utilisé un xsl:apply-templates sélectionnant ces nœuds.
Conséquence
Si on se contente des règles par défaut, on obtient la concaténation de nœuds de type Text. Programme minimal :
Publication XSLT
Amann
Rigaux
Introduction
Documents XML
Programmation XSLT
Pour les autres nœuds
Pour les instructions de traitement et les commentaires : on ne fait rien.
si on ne les sélectionne pas explicitement, en définissant une règle pour les traiter, il ne se passe rien.
L’instruction xsl:apply-template
Attributs : select, mode et priority.
select doit sélectionner un ensemble de nœuds. Ils constituent le contexte
d’évaluation
pour chaque nœud on va chercher la règle à instancier.
mode permet de choisir explicitement une des règles parmi celles qui sont candidates priority permet de définir une priorité pour que le processeur choisisse.
xsl:apply-templates
Appliqué à notre document : un déclenchement de règle sur le nœud ENSEIGNANTS
Application de la règle ENSEIGNANTS
NB : la valeur par défaut de select est child::node().
Les règles
: Noeud NOM
: Noeud de texte
: Noeud de commentaire
Le résultat
1 : Noeud de texte
2 : Noeud de commentaire
3 : Noeud de texte 4 : Noeud NOM
5 : Noeud de texte 6 : Noeud NOM
7 : Noeud de texte
On voit que les nœuds sont de types différents, mais sont issus du même contexte (attribut select du xsl:apply-templates)