Accueil › Angular › Réutiliser sans se piéger
Réutiliser sans se piéger
Architecture et bonnes pratiquesintermediaire
Avant d'extraire quoi que ce soit, se demander ce qu'on réutilise vraiment :
- Une fonction simple, si c'est un calcul pur sans état ni template (ex.
calculerRemise(prix, taux)). - Un pipe, si c'est une transformation d'affichage utilisée dans plusieurs templates (
| devise,| dureeRelative). - Une directive (éventuellement via
hostDirectives), si c'est un comportement à appliquer sur des éléments ou composants au template différent, sans template propre à imposer. - Un composant, si c'est un morceau d'interface avec sa propre structure HTML et son propre état d'affichage.
Une API de composant réutilisable reste petite : des entrées qui décrivent clairement un état possible, et de la projection de contenu (<ng-content>) plutôt qu'une entrée pour chaque variante imaginable.
// Préférable : projection de contenu
@Component({
selector: 'app-carte',
template: `
<div class="carte">
<ng-content select="[carte-entete]" />
<ng-content />
</div>
`,
})
export class Carte {}
<app-carte>
<h3 carte-entete>Clavier mécanique</h3>
<p>Description libre, mise en page libre.</p>
</app-carte>
Le piège classique est le composant « à tout faire » : une entrée booléenne par variante rencontrée au fil du temps (primaire, arrondi, pleineLargeur, avecIcone…), jusqu'à une API illisible qui autorise des combinaisons qui n'ont pas de sens. Mieux vaut une entrée qui exprime un choix fermé (variante = input<'primaire' | 'secondaire'>('primaire')) ou, si les usages divergent vraiment, plusieurs composants ciblés plutôt qu'un seul composant universel.
Les termes à connaître
- hostDirectives
Métadonnée de
@Componentou@Directivequi applique une ou plusieurs directives directement sur l'hôte du composant, en exposant (ou non) leurs entrées et sorties. Permet de composer un comportement sans héritage ni duplication.- API d'un composant réutilisable
Ensemble des entrées, sorties et emplacements de projection (
ng-content) qu'un composant expose. Une bonne API reste petite et explicite ; elle privilégie la projection de contenu à la multiplication d'options.- Composant « à tout faire »
Anti-pattern où un composant unique accumule des entrées (souvent booléennes) pour couvrir toutes les variantes imaginables, au lieu de rester simple et de laisser la composition (projection, plusieurs petits composants) gérer la diversité des cas.
- Règle de trois
Convention répandue (pas une règle Angular) : attendre une troisième utilisation d'un même bout de code avant de l'extraire en composant, directive ou fonction réutilisable, pour éviter d'abstraire une similarité qui n'était en réalité pas durable.
- Angular CDK
Component Dev Kit : ensemble de briques comportementales non stylées (positionnement d'overlay, gestion du focus clavier, glisser-déposer, détection de breakpoints…) utilisées à la fois en interne par Angular Material et directement dans des composants maison.
- Abstraction prématurée
Créer un composant, une directive ou une option générique avant d'avoir un second cas d'usage réel. Le résultat colle rarement au vrai second besoin quand il arrive, et complique l'API pour rien dans l'intervalle.
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.