Phone icon Связаться с нами

Веб-разработка

Что такое key в React?

Key (ключ) — это специальный атрибут, который React требует для каждого элемента списка, созданного через map. Ключ помогает React понять, какой элемент добавлен, удалён или перемещён, когда список меняется.

При обновлении React сравнивает старый и новый список именно по ключам. Если ключи стабильные, React переиспользует существующие DOM-элементы и состояние компонентов, меняя только то, что действительно изменилось. Ключи должны быть уникальными среди соседних элементов и не меняться между рендерами — лучше всего брать id из данных.

Индекс массива как ключ подходит только для статичных списков, которые никогда не сортируются, не фильтруются и не меняют порядок. Иначе состояние может «переехать» к другому элементу: например, введённый текст или отметка окажется не в той строке.

Где применяется

Ключи нужны в каждом списке в React: карточки товаров и курсов, строки таблиц, сообщения чата, пункты меню, комментарии, результаты поиска. Без ключа React выводит в консоли предупреждение.

Ключ также используют как приём для сброса состояния: если изменить key компонента, React посчитает его новым, удалит старый и создаст заново с начальным состоянием. Так удобно очищать форму при переходе к другому пользователю.

Пример

Правильный ключ, проблемный индекс и сброс состояния через key.

// Good: stable unique id from data
<ul>
  {courses.map(course => (
    <li key={course.id}>{course.title}</li>
  ))}
</ul>

// Bad: index as key in a list that can be sorted or filtered
{todos.map((todo, index) => (
  <TodoItem key={index} todo={todo} />
))}

// Trick: change key to reset component state
<ProfileForm key={userId} userId={userId} />
Атрибут key в списках и на отдельном компоненте.

Частые вопросы

Почему нельзя использовать Math.random() как key?

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

Должен ли key быть уникальным во всём приложении?

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

Доступен ли key внутри компонента как проп?

Нет. key — служебный атрибут для React и не передаётся в props. Если значение нужно компоненту, его передают отдельным пропом, например id.

Обучение фронтенд-разработке в OWU

Освойте фронтенд-разработку на практических курсах с менторами и реальными проектами.

Выбрать курс