Перевод официальной документации библиотеки React.js на русском языке.
Оглавление:
1 — Часть первая — Установка
2 — Часть вторая — Внедрение JSX
3 — Часть третья — Отрисовка элементов
4 — Часть четвертая — Компоненты и свойства
5 — Часть пятая — Состояние и жизненный цикл
6 — Часть шестая — Обработка событий
7 — Часть седьмая — Условный рендеринг
8 — Часть восьмая — Списки и ключи
9 — Часть девятая (скоро)
Списки и ключи
Для начала, давайте рассмотрим, как преобразовать списки в JavaScript.
В приведенном ниже примере, мы используем функцию «map()», чтобы считать массив устройств «numbers» и удвоить их значения. Мы задаем новый массив устройств, возвращенный с помощью «map()», посредством удвоенной переменной и зарегистрировали ее следующим образом:
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()».Мы возвращаем элемент "" для каждой единицы. Напоследок, мы присваиваем полученный массив элементов к «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')
);
Попробуйте на CodePen.
Этот код выводит маркированный список чисел между 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» — это специальный строковый атрибут, который нужно включить при создании списков элементов. В следующем разделе мы расскажем, почему он так важен.
Зададим «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')
);
Попробуйте на CodePen.
Ключи (Keys)
Ключи помогают React определить, какие элементы были изменены, добавлены или удалены. Элементы внутри массива должны быть обеспечены ключами, чтобы иметь стабильную идентичность:
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) для генерированных элементов, в крайнем случае, в качестве ключа вы можете использовать индекс (index) элемента:
const todoItems = todos.map((todo, index) =>
// Only do this if items have no stable IDs
<li key={index}>
{todo.text}
</li>
);
Мы не рекомендуем использовать индексы для ключей в случае если элементы могут изменить порядок, так как это будет происходить медленно.
Извлечение компонентов при помощи ключей
Ключи имеют смысл только в контексте окружающего массива.
Например, если вы извлекаете компонент «ListItem», сохраните ключ для элементов
"<ListItem />" в массиве устройств, а не для корневого элемента
<li>в самом компоненте «ListItem».
Пример: неправильное использование ключа
function ListItem(props) {
const value = props.value;
return (
// Wrong! There is no need to specify the key here:
<li key={value.toString()}>
{value}
</li>
);
}
function NumberList(props) {
const numbers = props.numbers;
const listItems = numbers.map((number) =>
// Wrong! The key should have been specified here:
<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) {
// Correct! There is no need to specify the key here:
return <li>{props.value}</li>;
}
function NumberList(props) {
const numbers = props.numbers;
const listItems = numbers.map((number) =>
// Correct! Key should be specified inside the array.
<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')
);
Попробуйте на CodePen.
Практическое правило состоит в том, что элементы внутри запроса «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: 'Hello World', content: 'Welcome to learning React!'},
{id: 2, title: 'Installation', content: 'You can install React from npm.'}
];
ReactDOM.render(
<Blog posts={posts} />,
document.getElementById('root')
);
Попробуйте на CodePen.
Для 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>
);
}
Попробуйте на CodePen.
Иногда получается более понятный код, но не стоит этим злоупотреблять. Как и в JavaScript, стоит ли извлекать переменную для легкости чтения — решать вам. Имейте в виду, что если «map()» тоже вложен, то можно извлечь тот или иной компонент.
Автор: html_manpro
