Formations — 1 037 leçons en français

Accueil › Angular › Le composant

Le composant

Démarrer avec Angulardebutant

Un composant Angular est une classe TypeScript décorée par @Component. Il combine un sélecteur (le nom de balise à utiliser dans un template), un template (le HTML) et éventuellement des styles.

import { Component } from '@angular/core';
import { ProduitCard } from './produit-card/produit-card';

@Component({
  selector: 'app-liste-produits',
  imports: [ProduitCard],
  templateUrl: './liste-produits.html',
  styleUrl: './liste-produits.css',
})
export class ListeProduits {
  produits = [
    { id: 1, nom: 'Casque audio', prix: 79 },
    { id: 2, nom: 'Clavier mécanique', prix: 129 },
  ];
}

Depuis Angular 19, un composant est standalone par défaut : pas besoin d'écrire standalone: true. Il déclare directement, dans imports, les autres composants, directives et pipes qu'il utilise dans son template — plus de NgModule à faire intervenir.

La classe elle-même est un objet TypeScript ordinaire : ses propriétés (produits ci-dessus) sont lues par le template, et ses méthodes peuvent réagir à des événements ou au cycle de vie du composant (ngOnInit à l'initialisation, ngOnDestroy à la destruction). La logique métier lourde (appels réseau, calculs partagés) se place plutôt dans un service injecté, pour garder le composant concentré sur l'affichage.

Le CLI génère la structure de base : ng generate component produits/produit-card crée la classe, son template, ses styles et son fichier de test.

Les termes à connaître

@Component

Décorateur qui transforme une classe TypeScript en composant Angular. Ses métadonnées décrivent le sélecteur, le template, les styles et les dépendances du composant.

selector

Nom de balise (ou attribut) utilisé pour insérer le composant dans un template, ex. app-produit-card. Par convention, un préfixe applicatif (app-) distingue les composants « maison » des éléments HTML natifs.

Composant standalone

Composant qui déclare directement ses dépendances (autres composants, directives, pipes) dans sa propriété imports, sans passer par un NgModule. Comportement par défaut depuis Angular 19 : pas besoin d'écrire standalone: true.

template / templateUrl

template définit le HTML du composant en ligne, sous forme de chaîne. templateUrl référence un fichier .html séparé. Un composant utilise l'un ou l'autre, jamais les deux.

styles / styleUrl

styles définit du CSS en ligne (tableau de chaînes). styleUrl référence un fichier de styles (chaîne unique) : c'est la syntaxe recommandée pour une seule feuille de style, styleUrls (tableau) restant utilisable pour plusieurs fichiers.

Crochets de cycle de vie

Méthodes que le composant peut implémenter pour réagir à des moments précis de sa vie : ngOnInit (initialisation, une fois les @Input() posés), ngOnDestroy (juste avant destruction, pour nettoyer abonnements et minuteurs).

afterNextRender

Fonction qui exécute un callback une seule fois, juste après le prochain rendu du composant dans le DOM. Utile pour une manipulation ponctuelle du DOM ou l'appel d'une librairie tierce qui a besoin des éléments déjà rendus.

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.