times |
Fois |
| Liquid (Microsoft) |
Syntaxe
|
{{ nombre | times: multiplicateur }}
|
Paramètres
| Nom |
Description |
| nombre |
Ce paramètre permet d'indiquer la valeur initiale, qui peut être un nombre (pour multiplication) ou une chaîne de caractères (pour répétition). |
| multiplicateur |
Ce paramètre permet de spécifier le facteur de multiplication si nombre est un nombre, ou le nombre de répétitions si nombre est une chaîne de caractères. |
Description
Ce filtre permet de répéter une chaîne un nombre spécifié de fois ou de multiplier des nombres.
Remarques
- Polyvalence selon le type de la valeur d'entrée : Le filtre times est contextuellement intelligent : s'il reçoit un nombre, il effectue une
multiplication arithmétique classique. S'il reçoit une chaîne de caractères, il en effectue une répétition. Cette double fonctionnalité en fait un filtre très flexible
dans des scénarios variés.
- Utile pour les calculs dynamiques dans les modèles : Lorsqu'un nombre est passé en paramètre, times permet d'effectuer des multiplications directement
dans un gabarit Liquid, sans devoir recourir à une logique côté serveur ou JavaScript. Cela permet, par exemple, de calculer des totaux ou des prix ajustés à la
volée.
- Pratique pour générer du texte répétitif en sortie : Avec une chaîne de caractères comme entrée, times peut servir à répéter un motif ou un symbole,
par exemple pour afficher visuellement une notation par étoiles ou des séparateurs. Cette fonctionnalité est souvent exploitée dans des interfaces utilisateur
personnalisées.
- Comportement dépendant du type impose de la prudence : Comme le résultat change selon que l'on fournit une chaîne ou un nombre, il est essentiel de
connaître le type de la variable passée. Une confusion entre chaîne numérique et nombre réel pourrait conduire à des résultats inattendus ou incohérents.
- Peut être combiné à d'autres filtres mathématiques : Le filtre times peut être utilisé enchaîné avec plus, minus, divided_by,...,
pour former des expressions plus complexes. Cela rend possible la création de calculs conditionnels ou cumulatifs directement dans le rendu
HTML de Power Pages ou d'autres portails
Dynamics 365.
- Limité par les performances dans les répétitions textuelles massives : Lorsqu'il est utilisé pour répéter une chaîne un grand nombre de fois, le filtre peut
impacter la lisibilité du gabarit ou la performance de rendu, surtout si la répétition est mal contrôlée ou dépend d'une variable non limitée.
- Permet un prototypage rapide de comportements logiques simples : En phase de développement ou de test, times peut être utilisé pour simuler des boucles
ou des affichages dynamiques sans écrire de script complexe. Par exemple, on peut simuler un lot d'éléments visuellement sans intégrer une boucle for.
- Doit être utilisé avec des valeurs numériques valides : Si le multiplicateur ou la valeur d'origine n'est pas convertible en nombre (dans le cas d'une
multiplication), le filtre renverra un résultat vide ou inattendu. Il est donc prudent de valider ou forcer le type avec un filtre comme plus: 0 pour forcer la
conversion en nombre.
Dernière mise à jour : Jeudi, le 24 Juillet 2025