Accueil › CSS & mise en page › Un composant de champ réutilisable en Angular
Un composant de champ réutilisable en Angular
Formulaires et champsintermediaire
Un champ réutilisable évite de réécrire label, aide, erreur et espacement à chaque formulaire. Deux conceptions possibles.
Par projection — le composant fournit la structure, l'appelant fournit le contrôle :
@Component({
selector: 'app-champ',
template: `
<div class="champ">
<label class="champ__label" [for]="id">{{ label() }}</label>
<ng-content></ng-content>
<p class="champ__message" [class.champ__message--erreur]="erreur()">
{{ erreur() ?? aide() }}
</p>
</div>
`,
styles: [`:host { display: block; }`],
})
export class ChampComponent {
label = input.required<string>();
aide = input<string>('');
erreur = input<string | null>(null);
protected readonly id = `champ-${ChampComponent.compteur++}`;
private static compteur = 0;
}
<app-champ label="Adresse e-mail" [erreur]="erreurEmail()">
<input class="controle" type="email" formControlName="email" [id]="…">
</app-champ>
Avantage décisif : formControlName reste sur le contrôle natif, donc aucun ControlValueAccessor à écrire.
Par encapsulation — le composant contient le contrôle et devient lui-même un contrôle de formulaire. Il faut alors implémenter ControlValueAccessor : plus d'API, plus de code, plus de cas limites.
La règle : commencez par la projection. Ne passez à l'encapsulation que si vous avez besoin d'une API fermée (un sélecteur de date maison, par exemple).
Les termes à connaître
- Composant de présentation
Un composant qui reçoit des données et émet des événements, sans logique métier. Le champ de formulaire en est l'archétype : il affiche, il ne décide pas.
- Projection de contenu
<ng-content>laisse l'appelant fournir le contrôle (input, select, textarea) tandis que le composant fournit la structure : label, aide, erreur, espacement.- ControlValueAccessor
L'interface qui permet à un composant personnalisé de se comporter comme un contrôle natif vis-à-vis des formulaires réactifs. Nécessaire seulement si le composant contient le contrôle.
- Identifiant unique
Chaque champ a besoin d'un
idpour lier son label. Le générer dans le composant évite les collisions quand il est utilisé plusieurs fois sur une page.- @Input requis
input.required<string>()rend le label obligatoire à la compilation : impossible d'oublier un libellé, donc impossible de produire un champ inaccessible.- Styles hérités par le contenu projeté
Le contenu projeté garde l'encapsulation de son composant d'origine. Styliser un
<input>projeté depuis le composant de champ demande donc une approche particulière.
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.