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
propTypesdé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
truedécrit la présence :visible,actif,obligatoire. Son contraire se lit sans double négation.
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.