Formations — 1 037 leçons en français

Accueil › TypeScript › Typer un composant et ses props

Typer un composant et ses props

TypeScript avec React et Nodeavance

Un composant est une fonction. Ses props sont son paramètre. On les type comme n'importe quel paramètre.

type ProduitProps = {
  nom: string;
  prix: number;
  enPromotion?: boolean;
};

function Produit({ nom, prix, enPromotion = false }: ProduitProps) {
  return <article>{nom} — {prix} €{enPromotion && " (promo)"}</article>;
}

Rien d'autre n'est nécessaire. Le type de retour est inféré, et il est juste.

React.FC : ne plus l'écrire

// ❌ hérité
const Produit: React.FC<ProduitProps> = ({ nom }) => …

// ✅
function Produit({ nom }: ProduitProps) { … }

Son seul apport était d'ajouter children implicitement. Cet ajout a été retiré, parce qu'il donnait children à des composants qui n'en acceptaient pas. Il ne reste donc qu'un inconvénient : la signature est figée, ce qui interdit un composant générique.

children se déclare

import type { ReactNode } from "react";

type PanneauProps = {
  titre: string;
  children?: ReactNode;
};

ReactNode couvre tout ce qui peut être rendu : élément, chaîne, nombre, tableau, null. C'est le bon type dans la quasi-totalité des cas.

ref est une prop ordinaire

type SaisieProps = {
  ref?: React.Ref<HTMLInputElement>;
  valeur: string;
};

function Saisie({ ref, valeur }: SaisieProps) {
  return <input ref={ref} value={valeur} />;
}

Depuis React 19, forwardRef n'est plus nécessaire pour transmettre une ref à travers un composant fonction.

Les termes à connaître

Props

L'unique paramètre d'un composant. On le type comme n'importe quel paramètre de fonction : un type ou une interface, annoté directement sur le paramètre.

React.FC

Un type de fonction fourni par les typages React. Il n'apporte plus rien depuis que children n'y est plus implicite, et il gêne les composants génériques. La documentation React ne l'utilise pas.

ReactNode

Le type de tout ce qu'un composant peut rendre : élément, chaîne, nombre, tableau, null, undefined, booléen. C'est le type à donner à children.

ReactElement

Le type du seul résultat d'un createElement — plus étroit que ReactNode, qui accepte aussi les chaînes et les tableaux. Utile quand on veut exiger un élément et rien d'autre.

ComponentProps

ComponentProps<"button"> donne les props d'une balise HTML, ComponentProps<typeof Bouton> celles d'un composant. On évite ainsi de recopier une liste d'attributs.

ref comme prop ordinaire

Depuis React 19, un composant fonction reçoit ref dans ses props comme les autres. forwardRef n'est plus nécessaire.

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.