size

Syntaxe

Paramètres

Description

Ce filtre permet de compter le nombre d'éléments dans une collection ou de caractères dans une chaîne.

Remarques

• Mesure la longueur des chaînes et collections : Le filtre size est conçu pour retourner le nombre de caractères dans une chaîne ou le nombre d'éléments dans une collection (comme un tableau ou une liste). Il fournit donc une méthode simple pour quantifier dynamiquement une variable textuelle ou structurée dans l'interface utilisateur.
• Outil de contrôle conditionnel d'affichage : Grâce à size, on peut masquer ou afficher certaines sections de page en fonction du contenu réel d'une variable. Par exemple, il devient facile de ne pas afficher une liste vide ou d'afficher un message personnalisé lorsque la taille est égale à zéro.
• Utilisable avec les filtres numériques : Le résultat retourné par size est un entier pouvant être enchaîné avec d'autres filtres numériques comme plus, minus ou times. Cela permet des manipulations arithmétiques simples pour ajuster la valeur avant affichage, comme dans : {{ myArray | size | plus: 1 }}.
• Indispensable pour les messages dynamiques : Le filtre est très pratique pour formuler des messages dynamiques basés sur la quantité, comme "Il y a 3 éléments trouvés" ou "Votre message contient 120 caractères". Ce type d'indication améliore la lisibilité et la personnalisation des pages web.
• Comportement prédictible sur types simples : Sur une chaîne, size retourne exactement le nombre de caractères, espaces compris, ce qui permet une évaluation précise dans des formulaires ou des validations de texte. Cette propriété est utile pour des interfaces contrôlant la saisie utilisateur.
• Fonctionne bien en combinaison avec for : Lorsqu'il est utilisé avec une boucle for, size permet d'afficher la longueur totale de la collection ou d'afficher un compteur, voire de limiter le nombre d'itérations. Cela peut servir à créer des composantes interactifs ou paginés.
• Comportement neutre sur valeurs non prises en charge : Si size est appliqué à une variable qui n'est ni une chaîne ni une collection, le comportement est généralement neutre, retournant 0 ou provoquant une absence d'affichage. Il est donc recommandé de vérifier le type de la variable avant usage.
• Aucune distinction entre types de collections : Le filtre size traite de manière uniforme tous les types de collections : que la liste soit issue d'une requête FetchXML, d'une variable assignée ou d'un tableau d'objets, la méthode de comptage reste identique, ce qui simplifie la logique Liquid.