Formations — 1 037 leçons en français

Accueil › React › Passer des données à un composant

Passer des données à un composant

Composants et propsdebutant

Les props sont les arguments d'un composant. Le parent les écrit comme des attributs ; React les rassemble dans un objet unique.

function Carte({ titre, prix }) {
  return (
    <article>
      <h2>{titre}</h2>
      <p>{prix} €</p>
    </article>
  );
}

<Carte titre="Clavier" prix={49} />;

Les accolades distinguent une valeur JavaScript d'une chaîne : prix={49} passe le nombre 49, prix="49" passe la chaîne "49".

Un composant ne reçoit qu'un objet

function Carte(props) {
  return <h2>{props.titre}</h2>;
}

Équivalent à la version déstructurée. La déstructuration dans la signature est préférée parce qu'elle documente ce que le composant attend.

Les props sont en lecture seule

// ❌ le tableau appartient au parent
function Liste({ produits }) {
  produits.sort((a, b) => a.prix - b.prix);
  return <ul>…</ul>;
}

// ✅ on trie une copie
function Liste({ produits }) {
  const tries = [...produits].sort((a, b) => a.prix - b.prix);
  return <ul>…</ul>;
}

Une prop n'est pas une copie : c'est la même référence que chez le parent. Muter l'objet reçu modifie la donnée du parent, sans que React en soit averti.

Valeurs par défaut

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

C'est de la déstructuration JavaScript ordinaire : le défaut s'applique quand la prop vaut undefined, donc quand elle est absente. Pas quand elle vaut null, 0 ou "".

Les termes à connaître

Prop

Une donnée que le parent confie à l'enfant, écrite comme un attribut dans le JSX. C'est l'unique entrée d'un composant.

Objet props

React rassemble tous les attributs du JSX dans un seul objet, passé en premier argument. Un composant n'a jamais deux paramètres.

Lecture seule

Les props appartiennent au parent. Un composant les lit, ne les réassigne pas, et ne mute pas les objets reçus.

Déstructuration

Nommer les props attendues directement dans la signature : function Carte({ titre, prix }). La signature devient la documentation.

Valeur par défaut

Une valeur utilisée quand la prop vaut undefined : { taille = "moyen" }. C'est un mécanisme du langage, pas de React.

Flux descendant

Les données descendent du parent vers l'enfant, jamais l'inverse. Un enfant qui veut influencer le parent reçoit une fonction.

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.