Перевод официальной документации библиотеки 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()» тоже вложен, то можно извлечь тот или иной компонент.
ссылка на оригинал статьи https://habrahabr.ru/post/317330/
Добавить комментарий