Formations — 1 037 leçons en français

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 id pour 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.

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.