string |
Chaîne de caractères |
| Liquid (Microsoft) |
Syntaxe
Paramètres
| Nom |
Description |
| valeur |
Ce paramètre permet d'indiquer la valeur à convertir en chaîne de caractères. Il peut s'agir d'un nombre, d'un booléen, d'un objet ou de toute autre donnée. |
Description
Ce filtre permet de convertir une valeur (nombre, booléen,...) en chaîne de caractères.
Remarques
- Facilite l'affichage de données non textuelles : Le filtre string est essentiel pour convertir des types non textuels (comme les nombres, les booléens, ou
même les dates) en chaînes de caractères afin de les afficher correctement dans l'interface utilisateur. Cela évite des erreurs d'affichage ou de concaténation.
- Indispensable pour la concaténation dynamique : Lorsque l'on souhaite combiner plusieurs éléments dans une seule ligne de texte (exemple :
« Total : {{ montant }} CAD »), il est recommandé de s'assurer que les valeurs numériques sont converties en chaînes avec string, surtout dans des expressions
complexes ou conditionnelles.
- Utile dans les comparaisons textuelles : Certains scénarios exigent des comparaisons strictement textuelles. En convertissant une valeur numérique ou
booléenne avec string, on peut ensuite appliquer des filtres comme contains, starts_with ou ends_with, qui ne fonctionneraient pas autrement.
- Transforme les booléens en "true"/"false" : Une valeur booléenne true ou false deviendra respectivement la chaîne de caractères "true" ou "false" après
transformation. Cela peut être utile pour l'affichage brut d'états logiques ou pour créer des chaînes de diagnostic, mais attention aux comparaisons sensibles à la
casse.
- Peut révéler des objets complexes : Lorsque string est appliqué à un objet complet (comme un enregistrement ou une entité), le résultat peut être
une chaîne générique ou difficile à lire (exemple : [object Object]). Il est donc recommandé de convertir uniquement des types simples ou d'accéder à une propriété
spécifique avant conversion.
- Nécessaire pour certaines opérations de filtrage : Dans certains cas, un tableau ou une liste doit être filtré selon une valeur textuelle. Le fait de
convertir les éléments avec string peut standardiser les formats de comparaison et éviter des résultats inattendus liés aux types de données sous-jacents.
- Particulièrement utile dans les champs dynamiques : Lorsqu'une valeur est récupérée dynamiquement d'une table ou d'un formulaire (par exemple, un champ
numérique ou booléen saisi par un utilisateur), on peut s'assurer que le contenu sera correctement affiché ou entreposé en le forçant en chaîne via string.
- Préserve la lisibilité et l'uniformité : Le filtre string garantit que toutes les valeurs sont rendues dans un format lisible, ce qui évite d'avoir à
gérer manuellement les types lors de la création de modèles ou de gabarits d'affichage. Il contribue à rendre le code plus robuste et homogène.
Dernière mise à jour : Jeudi, le 24 Juillet 2025