6. Exécution de templates et appels

6.1 Le template (règle modèle)

Les templates forment le coeur d'un programme XSLT
Un template produit normalement un output et/ou fait appel à d'autres templates.

Syntaxe:

<xsl:template

match = "expression XPath"

name = "Nom"

priority = "nombre"

mode = "nom">

</xsl:template>

Attribut match

Cet attribut déjà introduit définit un chemin de location et permet un déclenchement du template par "node matching".

Attribut name

Cet attribut permet de donner un nom au template. Par la suite une expression xsl:call-template peut explicitement appeler ce template comme fonction.

Attribut priority

Permet d'indiquer une priorité de traitement. Lorsque 2 templates correspondent à un noeud, le template qui a la priorité la plus haute sera choisi.
Lorsque la prioté n'est pas décidé, les plus simples ont priorité. Voir la spécification pour plus de détails !

Attribut mode

Si un élément xsl:apply-templates a un attribut mode, alors il s'applique uniquement aux templates des éléments xsl:template ayant un attribut mode avec la même valeur.
On utilise cette technique par exemple pour traiter 2 fois un noeud, la première fois par exemple pour créer une table des matières.
Voir 5.2 "Fabrication de références (liens)" [19]

Les paramètres xsl:param

Lorsqu'on appelle un template, on peut lui passer des paramètres
Un paramètre peut avoir une valeur par défaut

Le template

Le corps: Actions déclenchées par le template lorsqu'il est instancié (exécuté)

6.2 Variables et paramètres

XSLT ne connait pas de variables au sens des langages procéduraux

Les paramètres

Syntaxe

<xsl:param

name = qname

select = expression>

</xsl:param>

Un paramètre lie un nom à une valeur. La valeur est définie soit dans l'attribut select, soit par son contenu (mais pas les deux !)
Lorsqu'on définit un paramètre à la racine, il s'applique à tous les templates qui font appel à ce paramètre et qui ne reçoivent pas sa valeur. Cela ressemble à une constante globale.

Exemple

<xsl:param name="space" select="10"/>

<xsl:template name="render-course">

<xsl:param name="position-y"/>

<text x="{$space}" y="{$position-y * $increase-y - $space }"

style="stroke:#000099;fill:#000099;font-size:12;">

<xsl:value-of select="title"/>

</text>

Les variables

Le nom "variable" n'est pas clair. Il s'agit en fait de constantes.
En règle générale, c'est utile pour faire des calculs "intermédiaires"

Syntaxe

<xsl:variable

name = qname

select = expression>

</xsl:variable>

Utilisation de paramètres et variables

$XYZ

<xsl:param name="initial_size" select="5"/>

<xsl:param name="multiplier" select="3"/>

<xsl:variable name="fonte" select="$initial_size + $position * $multiplier"/>

<p style="font-size: {$fonte}pt ;"> blabla </p>

Cf. Exemple 6-2: "XSLT avec des fonctions 2" [30] !

6.3 Appel d'un template (règle modèle)

Syntaxe

<xsl:call-template

name = qname>

</xsl:call-template>

Exemple 6-1: XSLT avec des fonctions

http://tecfa.unige.ch/guides/xml/examples/xsl-call-template/ (répertoire)
http://tecfa.unige.ch/guides/xml/examples/xsl-call-template/news.xml
http://tecfa.unige.ch/guides/xml/examples/xsl-call-template/news-call-template.xsl
But: Afficher les title des item d'un contenu de type RSS de plus en grand

Un fragment du XML

<news>

 <item>

   <title>Home Page de Daniel Schneider</title>

   <link>http://tecfa.unige.ch/tecfa-people/schneider.html</link>

    <description>Cette page renvoie à mes publications, ....</description>

  </item>

  <item>

   <title>Matériaux de cours de Daniel Schneider</title>

   <link>http://tecfa.unige.ch/guides/tie/tie.html</link>

   <description>Il s'agit de plusieurs centaines de transparents ... </description>

  </item>

  ....  </news>

La feuille de style

<xsl:output method="html"

encoding="ISO-8859-1"

doctype-public="-//W3C//DTD HTML 4.01 Transitional//EN"/>

<xsl:template match="/">

<html>

<head><title>Demo call-templates</title></head>

<h1>Demo call-templates</h1>

<xsl:apply-templates/>

</body>

</html>

</xsl:template>

Ce template appelé par le mécanisme d'application de règles contient une boucle qui, pour chaque enfant "item", fait explicitement appel au template "display_item"
Lors de cet appel on transmet

le contexte (donc "item" courant)
plus un paramètre "position" qui prend la valeur de la position du "item" en question

<xsl:template match="news">

< xsl:for-each select="item" >

<xsl:call-template name="display_item">

<xsl:with-param name="position" select="position()"/>

</xsl:call-template>

</xsl:for-each>

</xsl:template>

Ce template appelé (par call-template) reçoit un paramètre "position".
On utilisera ce paramètre pour définir la taille de la police (font) pour le titre
Donc:

<xsl:param name="position"/> définit un paramètre que ce template peut recevoir lorsqu'on l'appelle
$position utilise ce paramètre

<xsl:template name="display_item">

<xsl:param name="position"/>

</xsl:template>

</xsl:stylesheet>

Exemple 6-2: XSLT avec des fonctions 2

http://tecfa.unige.ch/guides/xml/examples/xsl-call-template/ (répertoire)
http://tecfa.unige.ch/guides/xml/examples/xsl-call-template/news2.xml
http://tecfa.unige.ch/guides/xml/examples/xsl-call-template/news-call-template2.xsl
Cet exemple ressemble au précédant
On ajoute:

Deux paramètres globaux qui règlent l'incrémentation de la police (font)
une variable fonte pour un calcul intermédiaire

<!-- you can change the value of these 2 parameters -->

 <xsl:param name="initial_size" select="5"/>

 <xsl:param name="multiplier" select="3"/>

 <xsl:template name="display_item">

  <xsl:param name="position"/>

  <xsl:variable name="fonte
" select="$initial_size + $position * $multiplier
"/>

  <p style="font-size: {$fonte
}pt ;"><a href="{link}"><xsl:value-of select="title"/></a><br />

   [Pos = <xsl:value-of select="$position"/>, Multip. = <xsl:value-of select="$multiplier"/>,

   Taille init. = <xsl:value-of select="$initial_size"/>, Taille fonte = <xsl:value-of select="$fonte"/>]

  </p>

  <p><xsl:value-of select="description"/></p>

 </xsl:template>