Formations — 1 037 leçons en français

Accueil › React › Documenter ce qu'un composant attend

Documenter ce qu'un composant attend

Composants et propsdebutant

Un composant est une interface. Ce qu'il attend doit être lisible sans ouvrir son corps.

function Bouton({ libelle, onClic, variante = "primaire", actif = true }) {
  return (
    <button className={variante} disabled={!actif} onClick={onClic}>
      {libelle}
    </button>
  );
}

Deux props obligatoires, deux facultatives avec leur défaut. La signature dit tout.

Obligatoire ou facultative

// ✅ pas de défaut : le composant n'a pas de sens sans libellé
function Bouton({ libelle, variante = "primaire" }) { … }

// ❌ un défaut qui masque un oubli
function Bouton({ libelle = "Bouton", variante = "primaire" }) { … }

Une valeur par défaut est une décision : « quand cette prop est absente, voici ce que je fais ». Mettre un défaut sur une prop essentielle transforme un oubli en bouton muet qu'on cherchera longtemps.

Déclarer le contrat en TypeScript

type BoutonProps = {
  libelle: string;
  onClic: () => void;
  variante?: "primaire" | "danger";
  actif?: boolean;
};

function Bouton({ libelle, onClic, variante = "primaire", actif = true }: BoutonProps) { … }

Le ? marque le facultatif, l'union limite les valeurs permises. L'erreur apparaît dans l'éditeur, avant d'exécuter quoi que ce soit.

Nommer pour l'appel

<Panneau visible />          // ✅ se lit
<Panneau cache={false} />    // ❌ double négation en vue

Une prop se lit d'abord à l'appel. Nommez-la d'après ce que true signifie, et dans la forme positive.

Les termes à connaître

Contrat d'un composant

L'ensemble de ce qu'il attend : noms des props, types, lesquelles sont obligatoires, et ce qu'il fait des absentes.

Prop obligatoire

Une prop sans laquelle le composant n'a pas de sens. Elle n'a pas de valeur par défaut : un défaut masquerait l'oubli.

Prop facultative

Une prop dont l'absence a un comportement défini. Elle porte une valeur par défaut, écrite dans la déstructuration.

PropTypes

L'ancien mécanisme de validation des props, vérifié à l'exécution et en développement seulement. React 19 ignore les propTypes déclarés.

defaultProps

L'ancienne façon de déclarer des défauts, sur le composant lui-même. Supprimée pour les composants fonctions en React 19 : la déstructuration la remplace.

Type d'union

En TypeScript, variante: "primaire" | "danger". L'éditeur propose les valeurs permises et refuse les autres avant l'exécution.

Prop booléenne positive

Une prop dont true décrit la présence : visible, actif, obligatoire. Son contraire se lit sans double négation.

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.