Lorsque vous générez un document Slides, certaines variables peuvent ne pas avoir de valeur pour tous les projets. Cela peut laisser apparaître des libellés, des lignes vides ou des lignes de tableau qui n’ont plus de sens.
Les modificateurs vous permettent de contrôler ce qui arrive à ces éléments lorsque les informations associées à une variable sont manquantes.
Slides prend en charge trois modificateurs :
Modificateur | Fonction |
| Masque le texte statique associé à une variable vide |
| Ajoute un saut de ligne uniquement lorsque la variable suivante contient une valeur |
| Supprime une ligne entière d’un tableau lorsqu’une variable n’a pas de valeur |
⚠️ Ces modificateurs sont spécifiques aux modèles Slides. Ne les utilisez pas dans les modèles HTML.
1. Masquer du texte statique avec && ... &&
Utilisez && ... && lorsqu’une variable est accompagnée de texte statique qui ne doit apparaître que lorsque la variable contient une valeur.
Par exemple, imaginons que votre modèle contienne :
Day 6: $$days.6.title$$
Si le projet ne comporte que cinq jours, $$days.6.title$$ n’a aucune valeur. Cependant, le texte statique « Day 6: » pourrait rester visible.
Pour éviter cela, placez l’ensemble du contenu entre && :
&&Day 6: $$days.6.title$$&&
Si le Jour 6 existe, le document généré affiche, par exemple :
Day 6: Departure
Si le Jour 6 n’existe pas, le contenu situé entre && est masqué. Ainsi, s’il s’agit de la seule variable de la diapositive, comme dans cet exemple, la diapositive ne sera pas générée.
⚠️ Tout le contenu situé entre && ... && doit utiliser la même police, la même taille de police et la même couleur de police que la variable pour que le modificateur fonctionne correctement.
💡 Utilisez && ... && pour les libellés, préfixes, signes de ponctuation ou autres textes fixes qui n’ont de sens que lorsque la variable associée contient des informations.
2. Éviter les sauts de ligne inutiles avec @@
Utilisez @@ lorsque vous souhaitez qu’un saut de ligne soit ajouté uniquement si la variable suivante contient des informations.
Placez @@ immédiatement avant la variable.
Par exemple :
@@$$steps.1.description$$
⚠️ Le @@ doit utiliser la même police, la même taille de police et la même couleur de police que la variable sur laquelle il doit agir.
Si $$steps.1.description$$ contient une valeur, Ezus ajoute le saut de ligne et affiche la description.
Si la variable n’a pas de valeur, le saut de ligne inutile n’est pas ajouté.
Cela est utile lorsque plusieurs informations facultatives sont affichées dans la même zone de texte et que vous souhaitez éviter les lignes vides dans le document généré.
💡 Utilisez @@ lorsque des informations facultatives apparaissent sur des lignes séparées, comme des descriptions ou des détails supplémentaires qui ne sont pas nécessairement renseignés pour chaque projet.
3. Supprimer une ligne de tableau vide avec #--#
Utilisez #--# lorsqu’une variable est placée dans un tableau et que vous souhaitez que la ligne entière disparaisse si cette variable n’a pas de valeur.
Placez #--# avant la variable qui détermine si la ligne doit être affichée.
Par exemple :
#--#$$days.6.title$$
Si $$days.6.title$$ contient une valeur, la ligne reste dans le document généré.
Si la variable n’a pas de valeur, Ezus supprime la ligne entière du tableau.
Cela permet d’éviter que les tableaux contiennent des lignes vides lorsque des informations facultatives ne sont pas disponibles.
💡 Utilisez #--# lorsque la ligne entière dépend d’une information. Choisissez la variable qui détermine le mieux si cette ligne doit exister.
4. Quel modificateur utiliser ?
Choisissez le modificateur en fonction de l’élément que vous souhaitez contrôler :
Si vous souhaitez... | Utilisez |
Masquer un libellé ou un autre texte statique lorsque sa variable est vide |
|
Éviter un saut de ligne inutile lorsqu’une information facultative est vide |
|
Supprimer une ligne entière d’un tableau lorsqu’une information est vide |
|
5. Tester vos modificateurs
Après avoir ajouté un modificateur, générez le document pour vérifier son comportement.
Pour effectuer le test le plus fiable, utilisez :
Un projet dans lequel la variable contient une valeur.
Un projet dans lequel cette même variable n’a pas de valeur.
Vérifiez que le contenu apparaît correctement lorsque l’information existe et disparaît proprement lorsqu’elle est absente.
⚠️ Effectuer le test uniquement avec un projet dans lequel tous les champs sont renseignés ne permet pas de confirmer qu’un modificateur fonctionne correctement. Vous devez également tester ce qui se passe lorsque l’information concernée est manquante.
💡 Si un modificateur ne se comporte pas comme prévu, commencez par vérifier si la variable associée contient réellement une valeur dans le projet. Pour && ... && et @@, vérifiez également que le contenu et la variable utilisent la même mise en forme.