Formations — 1 037 leçons en français

Accueil › Angular › Entrées et sorties d'un composant

Entrées et sorties d'un composant

Les signauxdebutant

input() déclare une entrée de composant sous forme de signal en lecture seule. La valeur vient du parent, le composant la lit avec des parenthèses :

import { Component, input } from '@angular/core';

@Component({
  selector: 'app-carte-produit',
  template: `<h3>{{ nom() }}</h3><p>{{ prix() }} €</p>`,
})
export class CarteProduit {
  nom = input.required<string>();  // obligatoire, pas de valeur par défaut
  prix = input(0);                 // optionnelle, valeur par défaut 0
}

Côté parent : <app-carte-produit [nom]="produit.nom" [prix]="produit.prix" />. Si nom (obligatoire) n'est pas fourni, le compilateur de templates signale l'erreur — pas de surprise au runtime.

output() déclare un événement que le composant émet avec .emit(...) :

ajouterAuPanier = output<Produit>();

// dans le template : (click)="ajouterAuPanier.emit(produit())"

Le parent écoute avec (ajouterAuPanier)="onAjout($event)", exactement comme avec l'ancien @Output.

model() combine les deux pour une liaison bidirectionnelle :

quantite = model(1); // input + output combinés
// quantite() pour lire, quantite.set(n) pour écrire ET notifier le parent

Le parent peut alors écrire <app-selecteur-quantite [(quantite)]="quantiteCommande" />.

Les décorateurs @Input() et @Output() fonctionnent toujours en Angular 21 et ne sont pas dépréciés, mais l'approche signaux est recommandée pour les nouveaux composants : elle s'intègre naturellement avec computed() et effect().

Les termes à connaître

input()

Déclare une entrée (input) sous forme de signal en lecture seule (InputSignal<T>). Le composant parent fournit la valeur par liaison de template ; le composant reçoit un Signal<T> qu'il lit avec des parenthèses (valeur()).

input.required()

Variante de input() pour une entrée obligatoire, sans valeur par défaut. Si le composant parent oublie de la fournir, le compilateur de templates signale une erreur à la compilation.

output()

Déclare une sortie (output) : un événement que le composant peut émettre avec .emit(valeur). Le composant parent l'écoute avec la syntaxe (evenement)="...", exactement comme avec l'ancien @Output.

model()

Combine une entrée et une sortie pour la liaison bidirectionnelle (« two-way binding ») : [(propriete)]="variable" côté parent. Le composant peut à la fois lire la valeur et la modifier avec .set()/.update(), ce qui émet automatiquement le changement vers le parent.

transform

Option de input() : une fonction qui convertit la valeur reçue avant de l'exposer dans le signal, par exemple transform: booleanAttribute pour accepter un attribut HTML sans valeur (<app-carte figee>).

alias

Option de input() (et output()) qui donne un nom différent à la propriété côté template, tout en gardant un nom de champ différent côté TypeScript : input(0, { alias: 'valeurInitiale' }).

@Input / @Output

Décorateurs historiques pour déclarer entrées et sorties. Toujours pleinement supportés en Angular 21 (pas dépréciés), mais l'équipe Angular recommande désormais les fonctions input() / output() / model() pour les nouveaux projets.

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.