ThisItem

Syntaxe

Paramètres

Description

Cette fonction permet de retourner une référence à l'élément actuel dans une galerie ou un formulaire.

Remarques

• ThisItem est fondamental dans les galeries et formulaires répétés : La fonction ThisItem permet de faire référence à l'enregistrement actuellement traité dans un contrôle répéteur. Cela signifie que chaque carte ou élément d'une galerie peut accéder aux données spécifiques de sa propre ligne sans qu'il soit nécessaire de filtrer manuellement la source.
• Elle permet un affichage dynamique et contextuel des données : En utilisant ThisItem, on peut lier chaque contrôle à des champs précis de l'élément actuel, comme ThisItem.Nom ou ThisItem.Prix. Cela rend l'interface très réactive, car chaque contrôle affiche automatiquement les valeurs correspondant à son enregistrement.
• Son utilisation améliore la lisibilité du code Power Fx : Plutôt que de réécrire une formule complexe pour cibler un enregistrement, ThisItem agit comme un raccourci clair et contextuel. Cela simplifie la maintenance du code, surtout dans des galeries avec plusieurs champs affichés simultanément.
• ThisItem peut être combiné avec d'autres fonctions pour des logiques complexes : On peut, par exemple, écrire If(ThisItem.Stock < 10, "Stock faible", "Stock suffisant") dans un champ de texte. Cela permet d'adapter dynamiquement les messages ou les styles selon les données spécifiques de chaque ligne.
• Essentiel pour personnaliser l'apparence des éléments dans une galerie : Grâce à ThisItem, on peut appliquer des styles conditionnels en fonction des valeurs de l'enregistrement en cours. Par exemple, changer la couleur d'un fond ou d'un texte si une condition est remplie : If(ThisItem.Status = "Urgent", Red, Black).
• Indispensable pour les actions ciblées sur un enregistrement précis : Lorsqu'on associe un bouton à une action (comme modifier ou supprimer), ThisItem permet de s'assurer que l'action affecte uniquement l'enregistrement de la ligne concernée, et non toute la galerie.
• Ne doit pas être confondu avec ThisRecord dans les contextes récursifs : Bien que similaire, ThisRecord est davantage utilisé dans les fonctions de table comme ForAll ou AddColumns. ThisItem est réservé aux éléments visuels et controls de type galerie, formulaire, etc., ce qui évite toute confusion sur la portée.
• Utile aussi dans les composants réutilisables avec des entrées dynamiques : Lorsque l'on crée un composant personnalisé utilisé dans plusieurs contextes, ThisItem permet de rendre ce composant adaptable à chaque enregistrement qu'il reçoit, améliorant la modularité et la réutilisation du code Power Fx.