Le XML est un langage de mise en forme de données utilisant des balises.
Il existe plusieurs moyens pour mettre en forme du XML, mais le plus puissant est le XSLT (le CSS est aussi utilisable, mais limité). Comme vous vous en doutez, il s'agit du langage que nous allons étudier.
Lors d'exemples, je vais utiliser ce petit fichier XML tout simple :
<?xml version="1.0" encoding="utf-8"?>
<test>
<jeu id="1">
<nom>Guild Wars</nom>
<type>Jeu de rôle en ligne</type>
<prix>Environ 20 € l'épisode</prix>
</jeu>
<jeu id="2">
<nom>Super Mario Galaxy</nom>
<type>Jeu de plate-forme</type>
<prix>30-50 €</prix>
</jeu>
<jeu id="3">
<nom>Mario Sokoban</nom>
<type>Jeu de réflexion</type>
<prix>Gratuit</prix>
</jeu>
</test>
Créez un fichier que vous enregistrerez sous le nom « le_nom_que_vous_voulez.xml » et placez-y donc ce code. Allez, passons à présent aux choses sérieuses ! ;)
Commencez par créer un nouveau fichier que vous enregistrerez sous le nom « le_nom_de_votre_choix.xsl ». Comme vous le constatez, l'extension d'un fichier XSLT est .xsl, ce qui n'est pas étonnant.
Vous avez donc une page vierge devant vous, mais qu'à cela ne tienne ! Mettons tout d'abord le code par défaut.
Il faut indiquer en premier la même version XML et le même encodage que la page XML. Pour cela, recopiez la première ligne du document XML, qui est dans mon cas :
<?xml version="1.0" encoding="utf-8"?>
Ensuite, si vous utilisez des entités dans la page XML (c'est-à-dire des choses telles que « é »), il vous faut les déclarer. Pour cela, écrivez à la suite :
Je vous ai joint quelques entités par défaut, utiles en particulier si vous utilisez l'ISO pour l'encodage des caractères.
Pour ajouter une entité, vous devez récupérer son nom (en principe, vous le possédez déjà) et son code. Pour cela, rendez-vous sur cette page. Trouvez la ligne de l'entité recherchée, copiez le code (par exemple «   ») et écrivez ceci à la suite des entités déjà déclarées :
<!ENTITY le_nom "le_code">
Ensuite, nous allons ouvrir les premières balises XSLT en donnant aussi quelques informations. Tapez donc ceci à la suite du code présent :
La première ligne renseigne la version de XSLT et désigne le namespace (xmlns:xsl) des balises XSLT, c'est-à-dire leur « préfixe ». La valeur par défaut est xsl, et je la conserverai tout au long du tutoriel. La deuxième ligne donne des informations sur le format de la page après transformation. Dans le cas où vous en utilisez un autre, changez l'encodage. La troisième ligne indique quelles balises seront concernées par le code qui s'y trouve. Vous pouvez en mettre plusieurs, comme une qui ne concernerait qu'un type d'élément si le fichier XML contenait plus d'un type de données.
Ensuite, c'est simple, vous placez le code de base d'un document XHTML :
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>Mise en forme avec XSLT</title>
</head>
<body>
</body>
</html>
Vous pouvez utiliser tout code qu'une page HTML peut gérer (balises HTML classiques, CSS et même JavaScript).
Après le code de base, il faut refermer les balises xsl :
</xsl:template>
</xsl:stylesheet>
Et voilà ! La page XSLT est terminée ! Du moins, la base. Il faut maintenant rajouter le contenu XML.
Maintenant, on souhaite afficher des données XML à la place des . Une balise XSL se présente sous cette forme :
<xsl:nom_de_la_balise attributs="valeurs" />
Comme je vous l'ai dit à propos des namespaces, le préfixe de la balise est xsl. La balise permettant d'afficher du contenu est celle-ci :
<xsl:value-of select="test/jeu/@id"/>
Dans cet exemple, l'id de la première balise jeu dans la balise test sera sélectionné. Lorsque l'on cible l'un des attributs d'une balise, on indique @ devant le nom de l'attribut. Pour cibler le contenu d'une balise, on s'arrête à son nom.
Pour afficher toutes les informations de notre première balise jeu, on doit écrire :
Comme je vous l'ai dit plus haut, il est inutile de visualiser la page XSLT. Il va falloir l'attacher à la page XML comme on attache un document CSS à une page HTML. Pour cela, rien de plus simple !
Au début du fichier XML et après la première ligne, ajoutez la ligne suivante :
Généralement, vous ne souhaiterez pas afficher tout un document XML d'un coup : pour cela, il faudra utiliser les filtres.
Vous devez les mettre dans l'attribut select. Admettons que vous voulez afficher tous les jeux dont le nom est « Super Mario Galaxy ».
Vous devrez donc indiquer le filtre entre crochets, à côté de la balise que vous voulez filtrer. Pour illustrer mon exemple, voici le script qui affiche tous les jeux dont le nom est « Super Mario Galaxy » :
ouvre le switch. Chaque <xsl:when test=""> indique une condition telle que <xsl:if test=""> . <xsl:otherwise> est l'équivalent du default, c'est-à-dire ce qui est effectué si aucune des conditions n'est vérifiée.
En fait, <xsl:choose> est le mélange d'un switch et d'une cascade de if, elseif, etc. Les conditions peuvent donc porter sur n'importe quel élément.
Elles offrent beaucoup de possibilités, et les utiliser ne peut être qu'utile.
Il est tout à fait possible d'afficher une page XML mise en forme avec XSLT dans une page PHP.
Pour cela, vous devez d'abord vérifier si l'extension XSL de PHP est activée. Par exemple, avec WAMP, cliquez sur l'icône de WAMP, choisissez « PHP » puis « Extensions PHP », et cochez l'option « php_xsl » si ce n'est pas déjà fait.
Ensuite, créez donc une page XML, une page XSLT (sans les balises de base d'un document HTML) et une page PHP.
Dans la page PHP, placez le code suivant :
<?php
$xslDoc = new DOMDocument();
$xslDoc->load("sommaire.xsl");
$xmlDoc = new DOMDocument();
$xmlDoc->load("chapitre.xml");
$proc = new XSLTProcessor();
$proc->importStylesheet($xslDoc);
echo $proc->transformToXML($xmlDoc);
?>
Explications : au départ, il faut charger la page XML (dans $xmlDoc) et la feuille de style XSLT (dans $xslDoc). Ensuite, on crée un nouveau container ($proc) qui doit contenir le résultat final. On applique avant tout la feuille de style XSL (importStylesheet), puis on effectue la transformation de la page XML à l'aide de la feuille de style et on affiche le résultat.
Changez bien évidemment sommaire.xsl et chapitre.xml par les chemins d'accès réels.
Si vous lancez ce code, la page s'affichera normalement et, si vous regardez dans le code source, tout le code XSL traité est affiché (non présentable, mais peu importe).
Et voilà !
Nous voici arrivés à la fin de ce tutoriel traitant des bases. En réalité, le XSLT est bien plus puissant que vous ne pouvez l'imaginer. Par exemple, il existe beaucoup plus de balises XSL. Il existe aussi des fonctions utiles comme current() et last() qui, avec une condition, pourraient effectuer des actions si l'élément sélectionné est le dernier.
Je ne vous ai appris que la mise en forme. En réalité, on peut aussi transformer une page XML avec XSLT.
Mais compte tenu que ce tutoriel ne parle que des bases, vous allez devoir apprendre le reste par vous-mêmes. C'est en forgeant que l'on devient forgeron ! :)
Vous pouvez trouver ici une assez bonne documentation sur le XSLT, en français. Pour les anglophones, une documentation en anglais est disponible sur le site même de la W3C : cliquez ici.