Списки и ключи React

Мы можем использоватьметод map() в JavaScriptдля создания списков.

Пример React

Используйте метод map() для перебора массива и создания списка чисел от 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> );

Попробуйте сами »

Мы можем отрефакторить приведённый выше пример в компонент. Компонент получает параметр-массив, и каждому элементу списка назначается key, иначе появится предупреждениедля элементов списка должен быть указан key, что означает, что key нужно включить:

Пример 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} /> );

Попробуйте сами »

Keys

Ключи помогают React определять, какие элементы изменились, когда в DOM добавляются или удаляются определённые элементы. Поэтому каждому элементу в массиве следует присвоить стабильный идентификатор.

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

В идеале ключ элемента должен быть уникальной строкой, которая есть у элемента в списке. Обычно мы используем id из данных как ключ для элемента:

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

Когда у элемента нет стабильного id, можно использовать его индекс в последовательности как ключ:

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

Если список можно переупорядочить, мы не рекомендуем использовать индекс как ключ, потому что это может привести к тому, что рендеринг станет очень медленным.


Извлечение компонентов с ключами

Ключ элемента имеет смысл только при сравнении с его соседними узлами.

For example, if you extract a ListItem component, you should keep the key on this<ListItem />элементе, а не на <li>элементе внутри компонента ListItem.

Неправильный пример

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

Правильный способ использования ключей

Пример React

function ListItem(props) { //Верно! Здесь ключ не нужен: return <li>{props.value}</li>; } function NumberList(props) { const numbers = props.numbers; const listItems = numbers.map((number) => //Снова верно! Ключ должен быть указан в контексте массива <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} /> );

Попробуйте сами »

Когда вы вызываете элементы внутри метода map(), всегда помните о необходимости добавить уникальный ключ к каждому элементу.


Ключ элемента должен быть уникальным среди его соседних элементов.

Ключи, используемые в элементах массива, должны быть уникальными среди их соседних элементов. Однако они не обязаны быть глобально уникальными. Когда мы создаём два разных массива, мы можем использовать одни и те же ключи.

Пример 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: 'Привет, мир!', content: 'Добро пожаловать в изучение React!'}, {id: 2, title: 'Установка', content: 'Вы можете установить React из npm.'} ]; const root = ReactDOM.createRoot(document.getElementById("root")); root.render( <Blog posts={posts} /> );

Попробуйте сами »

key служит подсказкой для React, но он не будет передан вашим компонентам. Если вашему компоненту нужно то же значение, что и key, передайте его как prop:

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

В приведённом выше примере компонент Post может читать props.id, но не может читать props.key.


Встраивание map() в JSX

В приведённом выше примере мы объявили отдельную переменную listItems и включили её в JSX:

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

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

JSX позволяет встраивать любое выражение в фигурные скобки, поэтому мы можем использовать это так в map():

Пример React

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

Попробуйте сами »

Это иногда может сделать ваш код понятнее, но иногда этот стиль также может использоваться слишком часто. Как и в JavaScript, только вы решаете, когда выделять переменную для удобочитаемости. Но помните: если map() имеет слишком много уровней вложенности, можно выделить компонент.

Другие расширения