Syntaxe
Paramètres
| Nom |
Description |
| string |
Ce paramètre permet d'indiquer la chaîne de caractères dont toutes les lettres doivent être converties en majuscules. |
Description
Ce filtre permet de mettre en majuscules toutes les lettres d'une chaîne.
Remarques
- Conversion intégrale en majuscules : Le filtre upcase transforme toutes les lettres minuscules d'une chaîne en majuscules. Cela concerne uniquement
les lettres alphabétiques, et les autres caractères comme les chiffres, ponctuations ou symboles ne sont pas affectés.
- Utile pour l'uniformisation visuelle : Il est souvent utilisé pour uniformiser l'affichage de titres, de noms ou d'étiquettes dans une interface. Cela
permet de renforcer l'impact visuel ou d'assurer une cohérence typographique dans les blocs d'informations.
- Respecte les règles de casse ASCII : Le filtre upcase fonctionne principalement sur des caractères de l'alphabet latin de base. Les caractères
accentués et certaines lettres non latines peuvent ne pas être correctement transformés, selon le moteur Liquid utilisé.
- N'altère pas le contenu original : Comme tous les filtres Liquid, upcase ne modifie pas la donnée source, mais uniquement sa représentation. La
variable originale reste intacte, ce qui permet de l'utiliser sous plusieurs formats dans la même page.
- Peut être combiné avec d'autres filtres : upcase est fréquemment utilisé avec strip, truncate, ou replace pour préparer une chaîne avant
son affichage. Par exemple, on peut d'abord retirer des espaces superflus, puis mettre le résultat en majuscules.
- Non sensible à la casse existante : Ce filtre agit de manière absolue : toutes les lettres, même déjà en majuscules, sont conservées telles quelles, tandis
que toutes les minuscules sont converties. Il n'y a donc aucune distinction entre lettres déjà capitalisées et autres.
- Peut servir à encoder des constantes ou des codes : Dans certaines interfaces, on veut afficher des codes de référence, abréviations ou sigles (comme
«PDF», «ID» ou «VIP») en majuscules. upcase garantit que ces éléments soient affichés de façon standardisée.
- Ne doit pas être utilisé pour des noms propres dans des phrases : L'usage de upcase dans du texte courant doit être limité, car mettre tout un nom
ou une phrase en majuscules peut nuire à la lisibilité. Ce filtre est donc préférable dans des contextes spécifiques comme les entêtes, boutons ou balises visuelles.
Dernière mise à jour : Jeudi, le 24 Juillet 2025