Formations — 1 037 leçons en français

Accueil › Angular › Les pipes

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 PipeTransform avec une méthode transform(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é par push), mais coûteux en performance sur une grande vue.

AsyncPipe

Pipe intégré (| async) qui s'abonne automatiquement à un Observable ou une Promise, 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.

Lire l'explication détaillée et faire le quiz →

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.