Listes & clés React

Nous pouvons utiliserla méthode map() de JavaScriptpour créer des listes.

Exemple React

Utilisez la méthode map() pour parcourir le tableau et générer une liste de nombres de 1 à 5 :

const numbers = [1, 2, 3, 4, 5]; const listItems = numbers.map((numbers) => <li>{numbers}</li> ); const root = ReactDOM.createRoot(document.getElementById("root")); root.render( <ul>{listItems}</ul> );

Essayez-le vous-même »

Nous pouvons refactoriser l'exemple ci-dessus en un composant. Le composant reçoit un paramètre de tableau, et chaque élément de liste se voit attribuer une clé, sinon un avertissement apparaîtraune clé doit être fournie pour les éléments de liste, ce qui signifie qu'une clé doit être incluse :

Exemple React

function NumberList(props) { const numbers = props.numbers; const listItems = numbers.map((number) => <li key={number.toString()}> {number} </li> ); return ( <ul>{listItems}</ul> ); } const numbers = [1, 2, 3, 4, 5]; const root = ReactDOM.createRoot(document.getElementById("root")); root.render( <NumberList numbers={numbers} /> );

Essayez-le vous-même »

Keys

Les clés peuvent aider React à identifier quels éléments ont changé lorsque certains éléments du DOM sont ajoutés ou supprimés. Par conséquent, vous devez donner à chaque élément du tableau un identifiant stable.

const numbers = [1, 2, 3, 4, 5];
const listItems = numbers.map((number) =>
  <li key={number.toString()}>
    {number}
  </li>
);

La clé d'un élément doit idéalement être une chaîne unique que l'élément possède dans la liste. Habituellement, nous utilisons l'id des données comme clé pour l'élément :

const todoItems = todos.map((todo) =>
  <li key={todo.id}>
    {todo.text}
  </li>
);

Lorsque l'élément n'a pas d'id stable, vous pouvez utiliser son index dans la séquence comme clé :

const todoItems = todos.map((todo, index) =>
  // 只有在没有确定的 id 时使用
  <li key={index}>
    {todo.text}
  </li>
);

Si la liste peut être réorganisée, nous ne recommandons pas d'utiliser l'index comme clé, car cela peut rendre le rendu très lent.


Extraction de composants avec des clés

La clé d'un élément n'a de sens que lorsqu'elle est comparée à ses nœuds frères.

Par exemple, si vous extrayez un composant ListItem, vous devez conserver la clé sur cet<ListItem />élément, plutôt que sur l' <li>élément à l'intérieur du composant ListItem.

Exemple incorrect

function ListItem(props) {
  const value = props.value;
  return (
    // 错啦!你不需要在这里指定key:
    <li key={value.toString()}>
      {value}
    </li>
  );
}

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    //错啦!元素的key应该在这里指定:
    <ListItem value={number} />
  );
  return (
    <ul>
      {listItems}
    </ul>
  );
}

const numbers = [1, 2, 3, 4, 5];
const root = ReactDOM.createRoot(document.getElementById("root"));
root.render(
  <NumberList numbers={numbers} />
);

La bonne façon d'utiliser les clés

Exemple React

function ListItem(props) { //C'est exact ! Aucune clé n'est nécessaire ici : return <li>{props.value}</li>; } function NumberList(props) { const numbers = props.numbers; const listItems = numbers.map((number) => //C'est encore exact ! La clé doit être spécifiée dans le contexte du tableau <ListItem key={number.toString()} value={number} /> ); return ( <ul> {listItems} </ul> ); } const numbers = [1, 2, 3, 4, 5]; const root = ReactDOM.createRoot(document.getElementById("root")); root.render( <NumberList numbers={numbers} /> );

Essayez-le vous-même »

Lorsque vous appelez des éléments dans la méthode map(), vous devez toujours penser à ajouter une clé unique à chaque élément.


La clé d'un élément doit être unique parmi ses éléments frères.

Les clés utilisées dans les éléments d'un tableau doivent être uniques parmi leurs éléments frères. Cependant, elles n'ont pas besoin d'être globalement uniques. Lorsque nous générons deux tableaux différents, nous pouvons utiliser les mêmes clés.

Exemple React

function Blog(props) { const sidebar = ( <ul> {props.posts.map((post) => <li key={post.id}> {post.title} </li> )} </ul> ); const content = props.posts.map((post) => <div key={post.id}> <h3>{post.title}</h3> <p>{post.content}</p> </div> ); return ( <div> {sidebar} <hr /> {content} </div> ); } const posts = [ {id: 1, title: 'Bonjour le monde', content: 'Bienvenue dans l'apprentissage de React!'}, {id: 2, title: 'Installation', content: 'Vous pouvez installer React depuis npm.'} ]; const root = ReactDOM.createRoot(document.getElementById("root")); root.render( <Blog posts={posts} /> );

Essayez-le vous-même »

La key sert d'indice à React, mais elle ne sera pas transmise à vos composants. Si votre composant a besoin de la même valeur que la key, passez-la comme prop:

const content = posts.map((post) =>
  <Post
    key={post.id}
    id={post.id}
    title={post.title} />
);

Dans l'exemple ci-dessus, le composant Post peut lire props.id, mais ne peut pas lire props.key.


Intégration de map() dans JSX

Dans l'exemple ci-dessus, nous avons déclaré une variable listItems distincte et l'avons incluse dans JSX :

function NumberList(props) {
  const numbers = props.numbers;
  const listItems = numbers.map((number) =>
    <ListItem key={number.toString()}
              value={number} />

  );
  return (
    <ul>
      {listItems}
    </ul>
  );
}

JSX permet d'intégrer n'importe quelle expression entre accolades, nous pouvons donc l'utiliser comme ceci dans map() :

Exemple React

function NumberList(props) { const numbers = props.numbers; return ( <ul> {numbers.map((number) => <ListItem key={number.toString()} value={number} /> )} </ul> ); }

Essayez-le vous-même »

Faire cela peut parfois rendre votre code plus clair, mais parfois ce style peut aussi être trop utilisé. Tout comme en JavaScript, c'est à vous de décider quand extraire une variable pour améliorer la lisibilité. Mais rappelez-vous, si un map() est imbriqué sur trop de niveaux, vous pouvez extraire un composant.

Autres extensions