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

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

Обрати курс