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

Во-первых, давайте рассмотрим, как вы преобразовываете списки в JavaScript.

Учитывая приведенный ниже код, мы используем функцию map(), чтобы взять массив чисел и удвоить их значения. Мы присваиваем новый массив, возвращаемый map(), переменной, удвоенной и записываем в нее:

1
const numbers = [1, 2, 3, 4, 5];
2
const doubled = numbers.map((number) => number * 2);
3
console.log(doubled);

Этот код регистрирует [2, 4, 6, 8, 10] в консоли.

В React преобразование массивов в списки элементов почти одинаково.

Отображение нескольких компонентов

Вы можете создавать коллекции элементов и включать их в JSX, используя фигурные скобки {}.

Ниже мы прокручиваем массив чисел, используя функцию JavaScript map(). Мы возвращаем элемент

для каждого элемента. Наконец, мы назначим результирующий массив элементов listItems:

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

Мы включаем весь массив listItems внутри элемента

1
ReactDOM.render(
2
  <ul>{listItems}</ul>,
3
  document.getElementById('root')
4
);

Этот код отображает список чисел от 1 до 5

Базовый компонент списка

Обычно вы должны отображать списки внутри компонента.

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

1
function NumberList(props) {
2
  const numbers = props.numbers;
3
  const listItems = numbers.map((number) =>
4
    <li>{number}</li>
5
  );
6
  return (
7
    <ul>{listItems}</ul>
8
  );
9
}
10

11
const numbers = [1, 2, 3, 4, 5];
12
ReactDOM.render(
13
  <NumberList numbers={numbers} />,
14
  document.getElementById('root')
15
);

Когда вы запустите этот код, вам будет выведено предупреждение о том, что для элементов списка должен быть предоставлен ключ. «Ключ» - это специальный атрибут строки, который необходимо включить при создании списков. Мы обсудим, почему это важно в следующем разделе. Давайте назначим ключ для наших элементов списка внутри numbers.map() и исправим недостающую ключевую проблему.

1
function NumberList(props) {
2
  const numbers = props.numbers;
3
  const listItems = numbers.map((number) =>
4
    <li key={number.toString()}>
5
      {number}
6
    </li>
7
  );
8
  return (
9
    <ul>{listItems}</ul>
10
  );
11
}
12

13
const numbers = [1, 2, 3, 4, 5];
14
ReactDOM.render(
15
  <NumberList numbers={numbers} />,
16
  document.getElementById('root')
17
);

Ключи списков React

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

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

Лучший способ выбрать ключ - использовать строку, которая однозначно идентифицирует элемент списка среди всех остальных. Чаще всего вы будете использовать идентификаторы из ваших данных в качестве ключей:

1
const todoItems = todos.map((todo) =>
2
  <li key={todo.id}>
3
    {todo.text}
4
  </li>
5
);

Если у вас нет уникальных идентификаторов для отображаемых товаров, вы можете использовать индекс товара в качестве ключа:

1
const todoItems = todos.map((todo, index) =>
2
  // Only do this if items have no stable IDs
3
  <li key={index}>
4
    {todo.text}
5
  </li>
6
);

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

Извлечение компонентов с помощью ключей

Ключи имеют смысл только в контексте массива.

Например, если вы извлекаете компонент ListItem, вы должны держать ключ в элементев массиве , а не в корневом элементе

в самом элементе ListItem.

Пример: неправильное использование ключа

1
function ListItem(props) {
2
  const value = props.value;
3
  return (
4
    // Wrong! There is no need to specify the key here:
5
    <li key={value.toString()}>
6
      {value}
7
    </li>
8
  );
9
}
10

11
function NumberList(props) {
12
  const numbers = props.numbers;
13
  const listItems = numbers.map((number) =>
14
    // Wrong! The key should have been specified here:
15
    <ListItem value={number} />
16
  );
17
  return (
18
    <ul>
19
      {listItems}
20
    </ul>
21
  );
22
}
23

24
const numbers = [1, 2, 3, 4, 5];
25
ReactDOM.render(
26
  <NumberList numbers={numbers} />,
27
  document.getElementById('root')
28
);

Пример: правильное использование ключа

1
function ListItem(props) {
2
  // Correct! There is no need to specify the key here:
3
  return <li>{props.value}</li>;
4
}
5

6
function NumberList(props) {
7
  const numbers = props.numbers;
8
  const listItems = numbers.map((number) =>
9
    // Correct! Key should be specified inside the array.
10
    <ListItem key={number.toString()}
11
              value={number} />
12

13
  );
14
  return (
15
    <ul>
16
      {listItems}
17
    </ul>
18
  );
19
}
20

21
const numbers = [1, 2, 3, 4, 5];
22
ReactDOM.render(
23
  <NumberList numbers={numbers} />,
24
  document.getElementById('root')
25
);

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

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

1
function Blog(props) {
2
  const sidebar = (
3
    <ul>
4
      {props.posts.map((post) =>
5
        <li key={post.id}>
6
          {post.title}
7
        </li>
8
      )}
9
    </ul>
10
  );
11
  const content = props.posts.map((post) =>
12
    <div key={post.id}>
13
      <h3>{post.title}</h3>
14
      <p>{post.content}</p>
15
    </div>
16
  );
17
  return (
18
    <div>
19
      {sidebar}
20
      <hr />
21
      {content}
22
    </div>
23
  );
24
}
25

26
const posts = [
27
  {id: 1, title: 'Hello World', content: 'Welcome to learning React!'},
28
  {id: 2, title: 'Installation', content: 'You can install React from npm.'}
29
];
30
ReactDOM.render(
31
  <Blog posts={posts} />,
32
  document.getElementById('root')
33
);

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

1
const content = posts.map((post) =>
2
  <Post
3
    key={post.id}
4
    id={post.id}
5
    title={post.title} />
6
);

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

Вложение map() в JSX

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

1
function NumberList(props) {
2
  const numbers = props.numbers;
3
  const listItems = numbers.map((number) =>
4
    <ListItem key={number.toString()}
5
              value={number} />
6

7
  );
8
  return (
9
    <ul>
10
      {listItems}
11
    </ul>
12
  );
13
}

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

1
function NumberList(props) {
2
  const numbers = props.numbers;
3
  return (
4
    <ul>
5
      {numbers.map((number) =>
6
        <ListItem key={number.toString()}
7
                  value={number} />
8

9
      )}
10
    </ul>
11
  );
12
}

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