React Listas y Keys

Podemos usarel método map() de JavaScriptpara crear listas.

Ejemplo de React

Al usar el método map() para iterar sobre el array, se genera una lista de números del 1 al 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> );

Pruébalo »

Podemos refactorizar el ejemplo anterior en un componente que recibe un array como parámetro. A cada elemento de la lista se le asigna una key; de lo contrario, aparecerá una advertenciaa key should be provided for list items, lo que significa que es necesario incluir una key:

Ejemplo de 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} /> );

Pruébalo »

Keys

Las keys ayudan a React a identificar qué elementos han cambiado cuando se añaden o eliminan ciertos elementos en el DOM. Por lo tanto, debes asignar un identificador estable a cada elemento del array.

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

Lo ideal es que la key de un elemento sea una cadena única que ese elemento tenga en la lista. Normalmente, usamos el id de los datos como la key del elemento:

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

Cuando el elemento no tiene un id definido, puedes usar el índice (index) como key:

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

Si la lista puede reordenarse, no recomendamos usar el índice como key, ya que esto puede hacer que el renderizado sea muy lento.


Extraer componentes con keys

La key de un elemento solo tiene sentido cuando se compara con sus nodos hermanos.

Por ejemplo, si extraes un componente ListItem, deberías poner la key en este<ListItem />elemento del array, y no en el <li>elemento del componente ListItem.

Ejemplo incorrecto

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 forma correcta de usar key

Ejemplo de React

function ListItem(props) { //¡Correcto! Aquí no es necesario especificar la key: return <li>{props.value}</li>; } function NumberList(props) { const numbers = props.numbers; const listItems = numbers.map((number) => //¡Correcto otra vez! La key debe especificarse en el contexto del array. <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} /> );

Pruébalo »

Cuando generes elementos dentro del método map(), es mejor que recuerdes siempre añadir una key única a cada elemento.


La key de un elemento debe ser única entre sus elementos hermanos

Las keys utilizadas en los elementos del array deben ser únicas entre sus hermanos. Sin embargo, no necesitan ser únicas a nivel global. Cuando generamos dos arrays diferentes, podemos usar las mismas keys.

Ejemplo de 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: 'Hello World', content: 'Welcome to learning React!'}, {id: 2, title: 'Installation', content: 'You can install React from npm.'} ]; const root = ReactDOM.createRoot(document.getElementById("root")); root.render( <Blog posts={posts} /> );

Pruébalo »

La key es una pista para React, pero no se pasa a tu componente. Si tu componente necesita usar el mismo valor que la key, pásalo como una prop.

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

En el ejemplo anterior, el componente Post puede leer props.id, pero no puede leer props.key.


Incrustar map() en JSX

En el ejemplo anterior, declaramos una variable listItems por separado y la incluimos en JSX:

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

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

JSX permite incrustar cualquier expresión entre llaves, por lo que podemos usarlo dentro de map() de esta manera:

Ejemplo de React

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

Pruébalo »

Hacer esto a veces puede hacer que tu código sea más claro, pero a veces también se abusa de este estilo. Al igual que en JavaScript, depende completamente de ti saber cuándo extraer una variable por legibilidad. Pero recuerda que si un map() está demasiado anidado, puedes extraer un componente.

Otras extensiones