first

Syntaxe

Paramètres

Description

Ce filtre permet de récupérer le premier élément d'un tableau ou la première lettre d'une chaîne de caractères.

Remarques

• Accès direct au premier élément d'une collection : Le filtre first permet de récupérer immédiatement le premier élément d'un tableau, sans avoir à recourir à une boucle. Cela est utile lorsque l'on souhaite, par exemple, afficher uniquement la première valeur d'un jeu de résultats, comme le premier contact, la première activité ou la première pièce jointe.
• Fonctionne aussi avec les chaînes de caractères : Ce filtre ne se limite pas aux collections. Lorsqu'il est appliqué à une chaîne de caractères, il retourne la première lettre de cette chaîne. Cela peut être utile pour créer des en-têtes, des icônes initiales ou des étiquettes abrégées basées sur les noms des utilisateurs ou des objets.
• Utile dans des tests conditionnels ou des affichages rapides : Dans certains cas, on peut vouloir tester une valeur unique ou l'afficher sans traitement complexe. Par exemple : {{ liste_contacts | first | attribute }} permet d'accéder à une propriété (email, fullname,...) du premier élément de la liste sans avoir à écrire une boucle.
• Permet d'optimiser les performances dans certains scénarios : Lorsqu'on travaille avec de grandes collections, il peut être plus efficace d'utiliser first pour obtenir un aperçu ou une donnée critique (exemple : la date de la première activité), plutôt que d'itérer sur toute la collection, ce qui améliore les temps de chargement des pages.
• Comportement prévisible même sur une collection vide : Si la collection est vide, le filtre first retourne nil (valeur nulle), ce qui permet de construire des conditions de sécurité autour de son usage ({% if collection | first %}), évitant les erreurs d'affichage ou les appels à des données inexistantes.
• Particulièrement utile avec les jeux de données Dataverse : Dans les portails Power Pages connectés à Dataverse, on peut récupérer une liste d'enregistrements (exemple : entityview.items) et utiliser first pour cibler le premier enregistrement retourné par une vue personnalisée, permettant des affichages compacts ou résumés.
• Ne permet pas de supprimer l'élément extrait : Le filtre first ne modifie pas la collection d'origine. Il retourne une nouvelle valeur correspondant au premier élément, sans enlever cet élément du tableau initial. Ainsi, la collection reste intacte pour d'autres usages dans le même contexte.
• Complémentaire du filtre last pour la symétrie logique : first est souvent utilisé en tandem avec last pour obtenir les bornes d'une collection. Cette symétrie logique est pratique, par exemple, pour afficher les dates de début et de fin, les premières et dernières étapes d'un processus ou les premières/dernières entrées d'un flux.