Les pipes
Composer des composantsdebutant
Un pipe transforme une valeur directement dans le template, avec la syntaxe valeur | nomDuPipe.
<p>{{ produit.prix | currency: 'EUR' }}</p>
<p>{{ produit.dateAjout | date: 'longDate' }}</p>
<p>{{ tauxRemise | percent }}</p>
Pipes intégrés les plus courants : date, currency, number, percent, json (débogage), slice (extrait d'une liste ou d'une chaîne), keyvalue (itérer sur les propriétés d'un objet), async (résout un Observable/Promise). Un pipe peut prendre des paramètres après : et plusieurs pipes peuvent s'enchaîner.
@for (p of produits | slice: 0 : 3; track p.id) {
<li>{{ p.nom }}</li>
}
On peut créer son propre pipe avec @Pipe et une méthode transform() :
@Pipe({ name: 'remise' })
export class RemisePipe implements PipeTransform {
transform(prix: number, taux: number): number {
return prix * (1 - taux);
}
}
Par défaut, un pipe est pur : il ne se réexécute que si la référence de son entrée change, ce qui est performant. Un pipe impur (pure: false) se réexécute à chaque cycle de détection de changements. Quand la transformation ne dépend que de signaux déjà présents dans le composant, un computed() fait souvent aussi bien qu'un pipe personnalisé, sans déclaration séparée.
Les termes à connaître
- Pipe
Fonction de transformation utilisable directement dans un template avec la syntaxe
valeur | nomDuPipe. Reçoit une valeur en entrée et retourne la valeur transformée, sans modifier la donnée d'origine.- @Pipe
Décorateur qui définit un pipe personnalisé. La classe doit implémenter l'interface
PipeTransformavec une méthodetransform(valeur, ...parametres). Standalone par défaut, comme un composant ou une directive.- Pipe pur (pure)
Comportement par défaut d'un pipe : Angular ne réexécute
transform()que si la référence de l'entrée change (nouvelle valeur, nouveau tableau...), pas si le contenu d'un objet ou tableau existant est muté en place. Le plus performant.- Pipe impur (impure)
Pipe déclaré avec
pure: false, réexécuté à chaque cycle de détection de changements, que l'entrée ait changé ou non. Nécessaire pour observer une mutation interne (ex. un tableau modifié parpush), mais coûteux en performance sur une grande vue.- AsyncPipe
Pipe intégré (
| async) qui s'abonne automatiquement à unObservableou unePromise, affiche la dernière valeur émise, et se désabonne automatiquement quand le composant est détruit — évite les fuites de mémoire d'un abonnement manuel oublié.- Chaînage de pipes
Plusieurs pipes peuvent s'enchaîner avec
|successifs (valeur | pipe1 | pipe2) : chaque pipe reçoit le résultat du précédent. L'ordre a une importance.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.