if

Syntaxe

Paramètres

Description

Cette balise permet d'exécuter un bloc d'instructions si une condition donnée est vraie.

Remarques

• Permet l'exécution conditionnelle de contenu : La balise {% if %} sert à exécuter un bloc de code uniquement lorsque la condition spécifiée est vraie. Elle est idéale pour personnaliser dynamiquement le contenu affiché selon le contexte, par exemple en fonction de l'état d'un utilisateur ou de la présence de données.
• Supporte une grande variété d'expressions logiques : La condition peut comparer des valeurs (==, !=, >, <,...), tester la présence ou non d'une variable, ou vérifier des états comme la nullité (nil). Cela permet de mettre en place des logiques souples et puissantes sans avoir besoin de JavaScript côté client.
• Peut être combinée avec les balises elsif et else : Bien que seule, la balise if permet déjà une logique binaire, elle prend tout son sens combinée avec elsif et else. On peut ainsi gérer plusieurs cas successifs ou fournir un comportement par défaut si aucune condition n'est remplie.
• Particulièrement utile avec les objets dynamiques : Dans un portail Power Pages, on peut tester des propriétés d'objets comme user, page, ou des résultats FetchXML. Par exemple, if user.authenticated permet d'afficher un bloc uniquement si l'utilisateur est connecté.
• Favorise la lisibilité et la modularité du code : En séparant les blocs logiques du contenu affiché, l'utilisation de if améliore la lisibilité des gabarits. Cela permet aussi de mieux organiser les cas spécifiques ou les exceptions sans dupliquer inutilement des structures HTML.
• Peut être utilisée pour filtrer des boucles ou afficher des messages : Elle est très pratique à l'intérieur d'une boucle {% for %} pour afficher un contenu seulement si certains critères sont remplis. Par exemple, n'afficher qu'un contact s'il a un courriel défini : {% if contact.emailaddress1 %}.
• Évite des erreurs d'affichage ou des contenus vides : Utiliser if permet de tester la présence de données avant de les afficher, ce qui évite de montrer des valeurs nulles, vides ou incorrectes à l'utilisateur final. Cela est essentiel pour garantir une bonne expérience utilisateur.
• Requiert toujours une fermeture explicite avec endif : Comme toutes les balises de contrôle en Liquid, if doit être suivie d'une balise {% endif %} pour marquer la fin du bloc. Oublier cette fermeture entraîne une erreur de rendu ou une page ne se chargeant pas correctement.