default

Syntaxe

Paramètres

Description

Ce filtre permet de retourner une valeur de secours si l'originale est vide ou nulle.

Remarques

• Permet de garantir un affichage même en l'absence de données : Le filtre default est particulièrement utile pour éviter les champs vides dans l'interface utilisateur. Il fournit une valeur de remplacement lorsque la variable est nil, vide (""), ou un tableau vide, assurant ainsi un rendu plus robuste.
• Réduit les risques d'erreurs d'affichage ou de logique conditionnelle : Plutôt que d'entourer chaque variable d'un bloc if ou unless, le filtre default permet de gérer proprement les cas où une donnée n'existe pas encore. Cela simplifie grandement les modèles (gabarits) tout en maintenant la fiabilité.
• Idéal pour les formulaires et profils utilisateurs incomplets : Quand certaines informations de l'utilisateur sont manquantes (comme un nom ou un avatar), le filtre default permet d'afficher une mention générique telle que «Non spécifié» ou une image par défaut, ce qui améliore l'expérience utilisateur.
• Utile dans les itérations pour les tableaux potentiellement vides : Lors de boucles sur des collections (exemple : listes d'éléments), default permet d'afficher un message du type «Aucun élément trouvé» si la liste est vide, évitant ainsi un rendu vide ou incohérent sans devoir tester la liste séparément.
• Améliore la robustesse des applications multilingues : Dans une interface multilingue, il est possible qu'une traduction soit absente pour une clef donnée. En combinant default avec des chaînes localisées, on peut afficher une valeur neutre ou une version anglaise en cas de manque de traduction.
• Fonctionne aussi bien avec des types primitifs que complexes : Le filtre default ne se limite pas aux chaînes : il fonctionne aussi avec les tableaux, objets et booléens. Cela permet de créer des comportements de secours pour toutes sortes de structures de données dans les applications Liquid.
• Évite les «trous» dans des compositions dynamiques de texte : Lors de la génération de phrases ou de blocs de contenu conditionnels, certaines parties peuvent manquer. Grâce au filtre default, on peut insérer automatiquement une valeur neutre ou informative, maintenant ainsi une structure grammaticale fluide.
• Participe à la conception défensive dans les modèles Liquid : En utilisant systématiquement default, on anticipe les cas où des valeurs ne seraient pas encore définies ou supprimées, ce qui améliore la résilience du code, notamment lors d'intégrations de contenu via des CMS ou des connecteurs de données.