boolean

Syntaxe

Paramètres

Description

Ce filtre permet de convertir une valeur en booléen (true/false).

Remarques

• Permet de normaliser les valeurs en expressions logiques fiables : Le filtre boolean convertit différentes formes de données (texte, nombres, objets,...) en une valeur booléenne (true ou false). Cela est utile pour garantir des comparaisons cohérentes dans les structures conditionnelles, en évitant les ambigüités typiques des types dynamiques.
• Facilite l'évaluation des chaînes vides ou nulles : Une chaîne vide (""), la valeur nil ou un tableau vide seront toutes interprétées comme false par ce filtre. Cela permet de vérifier très simplement si une variable contient une "vraie" valeur, sans devoir tester manuellement chaque cas.
• Offre un gain de lisibilité dans les instructions if, unless ou case : Au lieu d'écrire des conditions complexes, on peut simplement filtrer une valeur avec boolean et se baser sur le résultat dans une condition. Par exemple : {% if valeur | boolean %} est bien plus clair qu'une suite de tests combinés.
• Utile dans les affichages conditionnels liés aux états ou aux drapeaux : Ce filtre est particulièrement pratique pour traiter les champs comme "actif", "visible", "coché",... Il permet de transformer des valeurs brutes (comme "yes", "0", ou "false") en une expression logique exploitable dans le rendu HTML.
• Compatible avec les types numériques et interprète 0 comme false : Les valeurs numériques sont converties en booléen selon une logique simple : 0 est interprété comme false, tandis que n'importe quelle autre valeur est true. Cela permet de simplifier la validation de champs numériques dans les modèles de données.
• Peut être utilisé pour sécuriser l'exécution de blocs conditionnels : Lorsque l'on ne peut garantir le type ou le contenu d'une variable, appliquer boolean garantit qu'une logique conditionnelle ne générera pas d'erreur inattendue. Cela ajoute une couche de sécurité au code Liquid.
• Prend en compte l'absence d'une variable comme une valeur fausse : Si une variable n'est pas définie dans le contexte courant, l'application de boolean retournera false. Cela permet de détecter proprement des cas où des données attendues n'ont pas été injectées dans le rendu.
• Fonctionne comme un filtre de validation de présence ou d'existence : En plus de sa fonction logique, ce filtre agit comme un test de "présence" générale : il aide à vérifier si une variable est significative (non vide, non nulle, non égale à 0), ce qui est fondamental dans les environnements dynamiques où les données peuvent varier d'une page à l'autre.