order_by

Syntaxe

Paramètres

Description

Ce filtre permet de trier une collection d'objets selon une clef précise.

Remarques

• Permet un tri dynamique des collections selon une propriété spécifique : Le filtre order_by est très pratique pour organiser des données complexes en fonction d'un attribut commun. Il classe automatiquement les éléments d'une collection d'objets selon la valeur d'une propriété spécifiée, facilitant ainsi la visualisation et la navigation dans les listes.
• Améliore l'expérience utilisateur en présentant les données dans un ordre logique : Lorsqu'on affiche une liste d'éléments (comme des produits, des utilisateurs ou des événements), les trier avec order_by permet de donner du sens à la présentation, en les classant par date, nom, prix, ou tout autre critère pertinent.
• Fonctionne aussi bien avec des chaînes de caractères qu'avec des nombres : Le tri peut être appliqué sur une propriété contenant du texte (ordre alphabétique) ou des valeurs numériques (ordre croissant). Cela le rend polyvalent dans de nombreux cas d'usage, que ce soit pour trier des noms, des prix, ou des pointages.
• Ne permet que le tri croissant par défaut (ordre ascendant) : Le filtre order_by trie les éléments du plus petit au plus grand ou dans l'ordre alphabétique croissant. Il ne supporte pas nativement l'ordre décroissant (descendant), sauf si la collection est retravaillée manuellement après le tri.
• N'a pas d'effet si la collection est vide ou si la propriété est absente : Si la collection passée en paramètre est vide, ou si l'attribut donné n'existe pas dans les objets, aucun tri ne sera effectué. Cela n'entraînera pas d'erreur, mais le résultat restera inchangé, ce qui peut passer inaperçu si on ne vérifie pas les noms de propriétés.
• Peut être combiné avec where ou group_by pour filtrer puis trier : Il est souvent utile de filtrer une collection avant de la trier. Par exemple, on peut utiliser where pour sélectionner un sous-ensemble, puis order_by pour en organiser les éléments. Cela permet de structurer les données de manière précise et ciblée.
• Le tri se base sur des comparaisons simples sans traitement avancé : Ce filtre applique un tri sans tenir compte de la casse (majuscules/minuscules) ou de particularités linguistiques (accents, langues). Pour un tri plus évolué ou localisé, il faudrait un traitement complémentaire côté backend ou via JavaScript.
• Facile à utiliser dans des boucles for pour afficher des données triées : Le filtre order_by s'intègre naturellement dans une instruction for Liquid. Il suffit d'appliquer le filtre directement dans la boucle :
1. {% for produit in produits | order_by: "prix" %} 

Cela rend le code à la fois lisible, concis et fonctionnel pour générer des tableaux ou listes triées.