Formations — 1 037 leçons en français

Accueil › React › La prop children

La prop children

Composants et propsdebutant

Ce qui est écrit entre les balises d'un composant lui arrive dans la prop children.

function Cadre({ children }) {
  return <div className="cadre">{children}</div>;
}

<Cadre>
  <h2>Clavier</h2>
  <p>49 €</p>
</Cadre>;

children est une prop ordinaire. React la remplit à partir du contenu imbriqué, c'est la seule différence.

Composer plutôt que paramétrer

// ❌ une prop par détail : la liste ne s'arrête jamais
<Carte titre="Clavier" texte="49 €" lien="/clavier" badge="Promo" gras />

// ✅ la carte apporte le cadre, l'appelant apporte le contenu
<Carte>
  <h2><a href="/clavier">Clavier</a></h2>
  <p>49 € <span className="promo">Promo</span></p>
</Carte>

Dans la première version, chaque nouveau besoin ajoute une prop à Carte et une condition dans son corps. Dans la seconde, Carte ne change plus : elle ne sait rien du contenu, donc rien ne l'oblige à le prévoir.

Plusieurs emplacements

function Panneau({ entete, actions, children }) {
  return (
    <section>
      <header>{entete}</header>
      <div className="corps">{children}</div>
      <footer>{actions}</footer>
    </section>
  );
}

<Panneau
  entete={<h2>Commande 1042</h2>}
  actions={<button>Annuler</button>}
>
  <p>Deux articles</p>
</Panneau>;

Une prop peut contenir du JSX. children n'est donc pas une limite à un seul emplacement : c'est juste l'emplacement qui a une écriture confortable.

Les termes à connaître

children

La prop que React remplit avec ce qui est écrit entre la balise ouvrante et la balise fermante. Un nom réservé par convention, pas par le langage.

Composition

Confier à l'enfant un morceau d'interface déjà construit, au lieu de lui passer des données qu'il devra mettre en forme lui-même.

Paramétrage

L'inverse : une prop par détail affichable. Chaque nouveau besoin ajoute une prop, et le composant finit en arbre de conditions.

Prop d'élément

Une prop dont la valeur est du JSX (entete={<h2>…</h2>}). C'est ce qui permet plusieurs emplacements dans un même composant.

Emplacement

Un endroit du composant destiné à recevoir du contenu venu de l'appelant. children en est un ; les props d'élément en ajoutent.

Fragment

<>…</> : regroupe plusieurs éléments sans ajouter de balise dans le document. Indispensable pour remplir un emplacement avec plusieurs nœuds.

Composant conteneur

Un composant qui apporte une structure, un cadre ou un comportement, et laisse l'appelant décider du contenu.

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.