Списки и ключи
Сначала давайте посмотрим, как можно преобразовывать списки в JavaScript.
В приведённом ниже коде мы используем функцию map(), чтобы взять массив numbers и удвоить каждое из его значений. WМы присваиваем новый массив, возвращённый map(), переменной doubled и выводим на консоль на его:
const numbers = [1, 2, 3, 4, 5];
const doubled = numbers.map((number) => number * 2);
console.log(doubled);Данный код выводит на консоль [2, 4, 6, 8, 10].
В React преобразование массивов в списки элементов почти идентично.
Отрисовка несколько компонентов
Вы можете создавать коллекции элементов и включить его в JSX, используя фигурные скобки {}.
Ниже перебираем массив numbers, используя JavaScript-функцию map(). Мы возвращаем элемент <li> для каждого элемента. Наконец, мы присваиваем полученный массив элементов переменной listItems:
const numbers = [1, 2, 3, 4, 5];
const listItems = numbers.map((number) =>
<li>{number}</li>
);
Мы включаем весь массив listItems внутри элемента <ul> и отрисовываем его в DOM:
ReactDOM.render(
<ul>{listItems}</ul>,
document.getElementById('root')
);Этот код отображается маркированный список чисел от 1 до 5.
Простой компонент списка
Обычно вы будете отрисовывать списки внутри компонента.
Мы можем переписать предыдущий пример в компонент, принимающий массив чисел (numbers) и выводит неупорядоченный список элементов.
function NumberList(props) {
const numbers = props.numbers;
const listItems = numbers.map((number) =>
<li>{number}</li>
);
return (
<ul>{listItems}</ul>
);
}
const numbers = [1, 2, 3, 4, 5];
ReactDOM.render(
<NumberList numbers={numbers} />,
document.getElementById('root')
);При выполнении данного кода, вы получите предупреждение, что должен предоставлен ключ для элементов списка. «Ключ» — специальный строковый атрибут, который необходимо включать при создании списков элементов. Мы обсудим, почему это важно в следующем разделе.
Давайте назначим значение для атрибута key нашим элементам списка внутри numbers.map() для исправления ошибки с отсутствующим ключом.
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];
ReactDOM.render(
<NumberList numbers={numbers} />,
document.getElementById('root')
);Ключи
Ключи помогают React идентифицировать, какие элементы были изменены, добавлены или удалены. Ключи должны быть заданы элементам внутри массива, чтобы предоставить элементам постоянный идентификатор:
const numbers = [1, 2, 3, 4, 5];
const listItems = numbers.map((number) =>
<li key={number.toString()}>
{number}
</li>
);Лучший способ выбрать ключ — использовать строку, которая однозначно идентифицирует элемент списка среди его соседних элементов. Чаще всего в качестве ключей вы будете использовать идентификаторы из ваших данных:
const todoItems = todos.map((todo) =>
<li key={todo.id}>
{todo.text}
</li>
);Если у вас нет постоянных идентификаторов для отрисовываемых элементов, в крайнем случае вы можете использовать индекс элемента в качестве ключа:
const todoItems = todos.map((todo, index) =>
// Делайте подобное только в случае, если у элементов нет постоянных идентификаторов
<li key={index}>
{todo.text}
</li>
);Мы не рекомендуем использовать индексы для ключей, если порядок элементов может измениться. Это может негативно сказаться на производительности и вызвать проблемы с состоянием компонента. Ознакомтесь со статьёй Робина Покорни (Robin Pokorny) для подробного объяснения негативных последствий использования индекса в качестве ключа. Если вы решите не назначать явный ключ для списка элементов, тогда React по умолчанию будет использовать индексы в качестве ключей.
Также вы можете прочитать подробное объяснение того, почему ключи необходимы, если вам интересно узнать это.
Выделение компонентов с ключами
Ключи имеют смысл только в контексте окружающего массива.
Например, если вы выделяете компонент ListItem, вам нужно присваивать ключ элементам <ListItem /> в массиве, а не элементам <li> в самом ListItem.
Пример: неправильное назначение ключа
function ListItem(props) {
const value = props.value;
return (
// Неправильно! Здесь не нужно указывать ключ:
<li key={value.toString()}>
{value}
</li>
);
}
function NumberList(props) {
const numbers = props.numbers;
const listItems = numbers.map((number) =>
// Неправильно! Здесь должен быть указан ключ:
<ListItem value={number} />
);
return (
<ul>
{listItems}
</ul>
);
}
const numbers = [1, 2, 3, 4, 5];
ReactDOM.render(
<NumberList numbers={numbers} />,
document.getElementById('root')
);Пример: Корректное использование ключа
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];
ReactDOM.render(
<NumberList numbers={numbers} />,
document.getElementById('root')
);Придерживайтесь хорошему правилу: внутри вызова map() обязательно указывать ключи для элементов.
Ключи должны быть уникальными только в пределах элементов одного уровня
Ключи, используемые в массивах, должны быть уникальными среди их элементов на одном и том же уровне. Поэтому им не обязательно быть глобально уникальными. Мы можем использовать те же самые ключи при создании двух разных массивов:
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.'}
];
ReactDOM.render(
<Blog posts={posts} />,
document.getElementById('root')
);Ключи служат подсказкой для React, но они не передаются вашим компонентам. Если вам нужно то же самое значение в вашем компоненте, передайте его явно в виде свойства с другим именем:
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():
function NumberList(props) {
const numbers = props.numbers;
return (
<ul>
{numbers.map((number) =>
<ListItem key={number.toString()}
value={number} />
)}
</ul>
);
}Иногда это приводит к более чистому коду, но этим стилем не стоит злоупотреблять. Как и в JavaScript, вам решать, стоит ли извлекать переменную для большей читабельности. Имейте в виду, что если у блока кода в map() слишком большой уровень вложенности, возможно, наступило подходящее время для извлечения компонента.