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.
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.