join

Syntaxe

Paramètres

Description

Ce filtre permet de combiner les éléments d'un tableau en une chaîne, séparés par un délimiteur.

Remarques

• Fusionne les éléments d'un tableau en une seule chaîne lisible : Le filtre join est utile lorsqu'on veut afficher une liste d'éléments en texte clair. Par exemple, un tableau de noms comme ["Alice", "Bob", "Charlie"] peut être transformé en chaîne "Alice, Bob, Charlie" grâce à join: ", ".
• Le séparateur est entièrement personnalisable : Le paramètre "séparateur" peut contenir n'importe quelle chaîne de caractères, y compris des symboles (-, |,...), des sauts de ligne (<br>), ou des mots (" et "). Cela permet une mise en forme souple et adaptée au contexte d'affichage.
• Pratique pour afficher des balises ou du contenu HTML : join peut aussi être utilisé pour insérer des balises HTML entre les éléments, comme join: "<li>", ce qui est pratique pour générer des listes dynamiques sans écrire une boucle for.
• Transforme une collection en simple texte : En sortie, le filtre retourne une chaîne de caractères unique, ce qui le rend compatible avec d'autres filtres de manipulation de texte, comme upcase, escape ou replace. Cela permet de chaîner plusieurs transformations sur une liste.
• Ne modifie pas les éléments eux-mêmes : Ce filtre ne modifie pas les éléments du tableau, il ne fait que les concaténer. Si les objets de la collection sont complexes (par exemple des objets avec des propriétés), il faut extraire une propriété précise avant d'utiliser join.
• Utile dans les pages de portail Dynamics 365 : Dans le contexte des portails Power Pages, join permet de rassembler dynamiquement des données récupérées depuis des entités dans une présentation compacte. C'est très utile pour générer un résumé ou une ligne descriptive à partir d'une liste.
• Fonctionne uniquement avec des tableaux ou collections : Si la valeur passée n'est pas une collection, join ne produira pas de résultat utile. Il est donc recommandé de toujours vérifier que la variable est bien un tableau avant d'utiliser ce filtre pour éviter un affichage vide ou incorrect.
• Peut être combiné avec map pour une extraction ciblée : On peut utiliser join après un filtre map, pour extraire une propriété précise de chaque élément avant de les joindre. Par exemple : {{ users | map: "email" | join: ", " }} produit une chaîne contenant tous les courriels séparés par des virgules.