Maîtriser l’instruction <xsl:if> en XSLT pour des transformations XML intelligentes #

Filtrer, conditionner, alléger : derrière chaque feuille de style XSL bien écrite se cache souvent une poignée de tests <xsl:if> placés au bon endroit. Voici comment cette instruction structure la transformation XML et s’articule avec le reste du langage XSLT.

Réponse directe

<xsl:if> est l’instruction conditionnelle de XSLT : elle insère le fragment XML qu’elle encadre uniquement si l’expression XPath de son attribut test s’évalue à true. Contrairement aux autres langages, elle n’a pas de branche else : la gestion des alternatives multiples revient à <xsl:choose>.

Une seule condition

Pas de else : le contenu est traité ou ignoré, sans alternative implicite.

Attribut test

Une expression XPath booléenne décide de l’exécution du fragment.

∑

Au cœur du flux

S’imbrique dans for-each, template et value-of pour filtrer la sortie.

Comprendre le rôle de <xsl:if> dans XSLT : bien plus qu’un simple test #

L’instruction <xsl:if> occupe une place stratégique dans le processus de transformation XSLT. Elle offre la possibilité d’inclure ou d’exclure dynamiquement des fragments XML, en fonction de critères définis via son attribut test. Contrairement aux structures conditionnelles d’autres langages — souvent associées à une branche else —, <xsl:if> n’exécute du contenu que si la condition est remplie, sans alternative pour le cas contraire. Ce refus volontaire de toute clause alternative structure les transformations de manière explicite, laissant la gestion des scénarios multiples à des instructions comme <xsl:choose>.

Une feuille de style XSL repose sur un élément racine <xsl:stylesheet> qui contient des règles <xsl:template>. C’est à l’intérieur de ces templates, déclenchés par le moteur via <xsl:apply-templates>, que <xsl:if> prend tout son sens : le flux d’exécution se module selon des règles précises, ce qui permet de répondre à des exigences métier pointues tout en conservant une logique de transformation lisible. Son usage dans des contextes variés, tel que la génération conditionnelle de balises ou d’attributs, s’avère incontournable pour garantir la pertinence des résultats produits.

Squelette d’une feuille de style XSLT

<xsl:stylesheet version="1.0"
  xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <xsl:template match="/catalogue">
    <!-- on délègue le traitement aux templates des enfants -->
    <xsl:apply-templates select="livre"/>
  </xsl:template>
</xsl:stylesheet>

Élimination des données inutiles grâce à des filtres précis
Gestion d’exceptions métiers complexes sans alourdir la feuille de style
Respect des contraintes de format sans multiplier le code

Syntaxe détaillée et subtilités de l’attribut test #

La syntaxe de <xsl:if> repose sur l’utilisation obligatoire de l’attribut test, qui exprime la condition déterminant l’exécution du fragment XML concerné. Cette condition doit être une expression XPath s’évaluant en booléen. Si le test retourne true, le contenu de l’instruction est traité et inséré dans le résultat, sinon il est ignoré.

L’attribut test se prête à l’utilisation d’opérateurs logiques tels que and et or, permettant ainsi d’exprimer des règles complexes. Pour les transformations avancées, le recours à des fonctions XPath (comme not(), contains(), starts-with()) affine encore la portée des conditions. L’architecture de l’élément <xsl:if> favorise une structuration claire du flux, chaque condition jouant le rôle de garde-fou sur la pertinence du contenu généré.

xsl:if avec un test XPath et xsl:value-of

<xsl:template match="livre">
  <xsl:if test="prix > 10">
    Titre : <xsl:value-of select="titre"/>
    — <xsl:value-of select="prix"/> €
  </xsl:if>
</xsl:template>

test= »price > 10″ — limite l’affichage aux prix supérieurs à 10
test= »not(empty(name)) » — vérifie la présence d’un nom
test= »@type=’premium’ and amount > 1000″ — combine plusieurs critères de filtrage

💡 Bon à savoir L’attribut select de <xsl:value-of> et l’attribut test de <xsl:if> attendent tous deux du XPath : maîtriser XPath, c’est maîtriser la moitié de XSLT.

Exploiter les expressions XPath pour des conditions puissantes #

L’atout majeur de <xsl:if> réside dans sa capacité à utiliser des expressions XPath sophistiquées pour ses tests. Cela permet d’évaluer la présence d’un élément, la concordance d’un contenu, la comparaison de valeurs numériques ou textuelles, ou encore l’application de conditions imbriquées. Les exemples issus de projets récents illustrent la richesse de ces usages.

En 2024, l’équipe de développement de la plateforme documentaire du ministère de la Culture a optimisé ses feuilles XSLT en exploitant des tests sur la longueur de chaînes (string-length()), la détection d’attributs (@status=’valide’), ou l’utilisation de fonctions booléennes pour filtrer les documents pertinents. Ces pratiques rationnalisent le traitement, rendent les transformations plus robustes et réduisent le code redondant.

[ ]

Présence d’un nœud

test="auteur" : vrai si l’élément auteur existe et n’est pas vide.

Comparaison numérique

test="annee > 2010" : filtre les livres postérieurs à 2010.

Fonction de chaîne

string-length(commentaire) > 200 : alerte sur les textes longs.

Filtrage des livres dont l’auteur est renseigné et la date de publication postérieure à 2010
Exclusion conditionnelle des factures dont le montant est nul
Affichage d’une alerte uniquement si le champ ‘commentaire’ dépasse 200 caractères

Combiner <xsl:if> avec d’autres instructions XSLT pour gagner en flexibilité #

La véritable puissance de <xsl:if> s’exprime lorsqu’il est intégré à d’autres structures XSLT. En l’associant à <xsl:for-each>, il devient possible de filtrer dynamiquement des listes d’éléments. Les équipes de la société DataBridge, lors de la refonte de leur gestion documentaire en 2023, ont combiné <xsl:if> à des templates personnalisés pour générer des rapports enrichis par des alertes contextuelles.

L’utilisation de <xsl:text> au sein d’une instruction conditionnelle évite l’apparition de contenu superflu, tout en préservant la propreté du résultat final. Enfin, dans des traitements plus avancés, <xsl:if> encadre la création conditionnelle d’attributs XML ou la structuration imbriquée de données, ce qui s’avère indispensable pour des formats comme UBL ou TEI.

xsl:for-each + xsl:if : filtrage d’une liste itérée

<xsl:template match="/catalogue">
  <ul>
    <xsl:for-each select="livre">
      <xsl:if test="@disponible='oui'">
        <li><xsl:value-of select="titre"/></li>
      </xsl:if>
    </xsl:for-each>
  </ul>
</xsl:template>

Insertion conditionnelle de balises <span class= »highlight »></span> suivant la présence d’un mot-clé
Ajout d’un message d’avertissement uniquement lors d’anomalies détectées dans les données
Filtrage des composants d’un catalogue selon leur disponibilité et leur catégorie

Structure XSLT	Effet avec <xsl:if>
`<xsl:for-each>` + `<xsl:if>`	Filtrage conditionnel d’éléments dans une séquence itérée
`<xsl:template>` + `<xsl:if>`	Insertion sélective de fragments selon des critères métier
`<xsl:text>` + `<xsl:if>`	Affichage conditionnel de texte ou de messages d’information

Bonnes pratiques et pièges à éviter lors de l’utilisation de <xsl:if> #

L’utilisation de <xsl:if> requiert une structuration rigoureuse des feuilles de style. Certains écueils apparaissent fréquemment : expressions de test surchargées, conditions imbriquées qui nuisent à la lisibilité, ou utilisation inappropriée de <xsl:if> là où <xsl:choose> permettrait une gestion centralisée des alternatives.

✓ À faire

✓Limiter la complexité des tests à une ou deux conditions clairement identifiées
✓Préférer <xsl:choose> pour les logiques à plusieurs branches
✓Commenter les intentions métier derrière chaque condition
✓Isoler les blocs conditionnels pour améliorer la maintenabilité

✕ À éviter

✕Empiler des expressions de test surchargées et illisibles
✕Multiplier les <xsl:if> imbriqués là où un choose suffirait
✕Dupliquer la même condition dans plusieurs templates
✕Tester la logique métier globale sans validation isolée des conditions

Lors du projet de digitalisation des archives du CNRS en 2023, les équipes ont mis en place une revue de code systématique des feuilles XSLT, privilégiant la lisibilité des instructions conditionnelles. Nous recommandons de tester chaque condition de façon isolée, puis d’intégrer progressivement la logique business globale, afin d’éviter les effets de bord.

À notre avis, choisir judicieusement entre <xsl:if> et <xsl:choose>, structurer le code par fonctionnalités, et éviter les imbrications inutiles constituent des garanties essentielles pour maintenir des transformations performantes et évolutives.

À retenir

01<xsl:if> n’insère son contenu que si son attribut test (XPath) est vrai — pas de else.
02Pour plusieurs branches alternatives, on passe à <xsl:choose>.
03Combiné à <xsl:for-each>, il filtre dynamiquement les listes d’éléments.
04Les fonctions XPath (not, contains, string-length) affinent les conditions.
05Un test simple et commenté vaut mieux qu’une condition imbriquée illisible.

Questions fréquentes

À quoi sert XSLT ?+

XSLT (eXtensible Stylesheet Language Transformations) sert à transformer un document XML en un autre format : HTML, texte, ou un autre dialecte XML. On écrit une feuille de style XSL composée de règles <xsl:template> qu’un processeur applique au document source pour produire la sortie voulue.

Quelle est la différence entre XSL et XSLT ?+

XSL est la famille de technologies de style pour XML, qui regroupe trois composants : XSLT (la transformation), XPath (le langage de navigation dans l’arbre XML) et XSL-FO (la mise en page imprimable). En pratique, quand on parle de « feuille de style XSL » pour transformer du XML, on désigne presque toujours XSLT.

Comment fonctionne xsl:apply-templates ?+

<xsl:apply-templates> demande au processeur de chercher, pour les nœuds désignés par son attribut select (ou les enfants du nœud courant par défaut), la règle <xsl:template> dont le match correspond, puis de l’appliquer. C’est le mécanisme qui permet un traitement récursif et déclaratif de l’arbre XML, par opposition à l’itération explicite de <xsl:for-each>.

Qu’est-ce que xsl:template match ?+

Une règle <xsl:template match="…"> associe un motif XPath à un fragment de sortie. Par exemple match="livre" définit ce qui doit être produit chaque fois qu’un élément livre est traité. Le processeur sélectionne automatiquement le template dont le motif correspond au nœud courant.

XSLT est-il encore utilisé aujourd’hui ?+

Oui. XSLT reste largement employé dès qu’il faut échanger ou publier des données XML : facturation électronique (UBL), édition documentaire (TEI), flux bancaires, transformation de catalogues ou génération de rapports. Les projets cités plus haut (ministère de la Culture en 2024, CNRS en 2023) illustrent sa pertinence pour le traitement documentaire structuré.