assign

Syntaxe

Paramètres

Description

Cette balise permet de créer une variable et de lui assigner une valeur dans le contexte Liquid.

Remarques

• Création de variable simple : La balise assign permet de créer une variable au sein du gabarit Liquid. Cette variable peut ensuite être réutilisée plusieurs fois dans le code, ce qui facilite la gestion des données sans répétition.
• Entreposage de différentes valeurs : La valeur assignée à une variable peut être de plusieurs types : une chaîne de caractères, un nombre, un objet ou même le résultat d'une expression ou d'un filtre. Cela rend assign très flexible pour manipuler divers types de données.
• Étendue limité au gabarit : La variable créée avec assign existe uniquement dans le contexte d'exécution du gabarit actuel. Elle n'a pas de portée globale et ne persiste pas entre plusieurs requêtes ou pages.
• Réaffectation possible : Il est possible de réutiliser la balise assign pour modifier la valeur d'une variable déjà définie. Ainsi, la variable peut évoluer au cours du traitement, ce qui est utile pour des calculs ou conditions successives.
• Syntaxe simple et intuitive : La syntaxe {% assign nom_variable = valeur %} est facile à comprendre et à utiliser, ce qui facilite l'apprentissage du langage Liquid, même pour les débutants.
• Ne produit pas de sortie directe : L'utilisation de assign ne génère pas d'affichage dans le rendu HTML final. Elle sert uniquement à stocker des données pour un usage ultérieur dans le gabarit.
• Utilisation combinée avec des filtres : On peut assigner à une variable le résultat d'une transformation en utilisant un filtre Liquid, par exemple {% assign titre = page.title | upcase %}, ce qui permet de préparer des valeurs déjà formatées.
• Gestion des erreurs : Si la valeur assignée n'est pas définie ou incorrecte, la variable sera créée avec une valeur nulle ou vide, ce qui peut nécessiter une gestion spécifique pour éviter des comportements inattendus.