split |
Découper |
| Liquid (Microsoft) |
Syntaxe
|
{{ string | split: "séparateur" }}
|
Paramètres
| Nom |
Description |
| string |
Ce paramètre permet d'indiquer la chaîne de caractères à découper en plusieurs parties. |
| "séparateur" |
Ce paramètre permet de spécifier le délimiteur utilisé pour diviser la chaîne. Chaque occurrence de ce séparateur détermine un point de découpe. |
Description
Ce filtre permet de découper une chaîne en tableau selon un délimiteur.
Remarques
- Transforme une chaîne en tableau structuré : Le filtre split convertit une chaîne unique en une collection de sous-chaînes, ce qui est très utile
pour manipuler des données entreposées sous forme de liste séparée (exemple : CSV, balises, IDs,...). Une fois transformée, la chaîne devient exploitable avec les
filtres comme for, first, last,....
- Le séparateur peut être un caractère ou une chaîne : Le paramètre de délimitation dans split peut être un simple caractère comme une virgule, mais
aussi une chaîne complète comme ", " ou " | ". Cela offre une grande souplesse dans le découpage de formats textuels complexes ou mal standardisés.
- Idéal pour traiter des champs texte multivalués : Dans Dynamics 365 ou
Power Pages, certains champs peuvent contenir plusieurs valeurs séparées (par exemple : des rôles, des balises,
des catégories). Le filtre split permet alors de convertir ce champ en tableau, facilitant la présentation ou la vérification d'éléments individuels.
- Requiert une attention particulière sur les espaces : Lorsqu'on utilise split avec un séparateur comme ",", tout espace non inclus dans le séparateur
sera conservé dans les sous-chaînes. Ainsi, "un, deux, trois" avec split: "," retournera ["un", " deux", " trois"] avec des espaces en trop, ce qui peut gêner les
comparaisons.
- Fonctionne bien avec les boucles for : Une fois la chaîne découpée en tableau, on peut facilement parcourir les éléments avec une boucle
for. Cela est pratique pour afficher dynamiquement une liste de valeurs, comme des catégories, des éléments de menu ou des mots-clefs.
- Ne supprime pas les doublons ni les valeurs vides : Si la chaîne contient deux séparateurs successifs (exemple : "a,,b"), le filtre split
générera une valeur vide dans le tableau résultant. Il peut donc être utile de comparer ou filtrer le tableau après division si l'on souhaite éviter ces entrées vides.
- Utile dans des conditions ou filtres personnalisés : Une fois la chaîne transformée en tableau, on peut combiner split avec d'autres filtres comme
contains, where, size,..., pour filtrer ou tester la présence d'un élément spécifique. Cela donne de la puissance aux logiques conditionnelles.
- Comportement déterministe sur les chaînes vides : Si la chaîne initiale est vide (""), split retournera un tableau contenant une seule chaîne
vide ([""]) plutôt qu'un tableau vide. Ce comportement peut prêter à confusion et nécessiter une vérification conditionnelle avant de boucler sur le résultat.
Dernière mise à jour : Jeudi, le 24 Juillet 2025