current_sort

Syntaxe

Paramètres

Description

Ce filtre permet de récupérer l'état de tri actuel dans une collection triable.

Remarques

• Permet de détecter dynamiquement la colonne triée : Le filtre current_sort est très utile pour vérifier, dans une liste d'entités, si une colonne spécifique est celle actuellement utilisée pour trier les résultats. Cela permet de conditionner l'affichage d'icônes de tri ou d'indiquer visuellement quelle colonne est active.
• S'intègre étroitement avec les listes d'entités dans Power Pages : Ce filtre est particulièrement pertinent lorsqu'il est utilisé avec une balise entitylist. Il permet de lire l'état du tri appliqué par l'utilisateur sur une colonne, ce qui améliore l'interactivité et la clarté de l'interface des tableaux dynamiques.
• Retourne un booléen (true ou false) : Le filtre renvoie true si la propriété passée en paramètre correspond à la colonne actuellement triée, sinon false. Cela permet d'effectuer des tests simples dans une condition Liquid, comme {% if entitylist | current_sort: "nom" %}.
• Utile pour l'ajout conditionnel d'icônes de tri ascendant/descendant : En combinaison avec d'autres balises, ce filtre permet d'ajouter une flèche montante ou descendante à côté du nom d'une colonne, en fonction du tri actif. Il joue donc un rôle essentiel dans l'ergonomie des interfaces de consultation.
• Ne modifie pas le tri, il l'interroge uniquement : Contrairement à d'autres mécanismes, current_sort ne déclenche aucun tri : il se limite à lire l'état du tri actuel déjà appliqué par l'utilisateur sur une entitylist. Il est donc sûr à utiliser même sans interaction.
• Fonctionne même en cas de tri implicite : Si une liste d'entités est pré-triée par défaut dans sa configuration, current_sort peut toujours détecter cette configuration, ce qui permet d'anticiper les cas où aucun tri manuel n'a encore été effectué par l'utilisateur.
• Permet de personnaliser le comportement d'affichage des entêtes : En utilisant current_sort, on peut décider de modifier dynamiquement le style CSS, la couleur ou l'icône associée à un en-tête de tableau, renforçant ainsi l'intuition visuelle de l'utilisateur sur le tri en cours.
• Compatible avec des colonnes simples uniquement : Le paramètre 'propriété' doit correspondre exactement au nom d'un champ de la liste d'entités. Il ne prend pas en charge des expressions complexes ou des sous-propriétés. Il est donc essentiel de s'assurer que le nom transmis est exact.