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 unSignal<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 exempletransform: booleanAttributepour accepter un attribut HTML sans valeur (<app-carte figee>).- alias
Option de
input()(etoutput()) 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.
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.