re:re:actable
Урок 104 минуты чтения

key в списках: зачем нужен и что будет при одинаковых ключах

На этой странице
Кратко

key — специальный атрибут, по которому React сопоставляет элементы списка между рендерами. Это идентичность элемента: по ней React понимает, какой элемент добавился, удалился или переместился, и к какому элементу относится состояние (введённый текст, отметка, раскрытый блок). Ключ должен быть стабильным (не меняться между рендерами), уникальным среди соседей и лучше всего — взятым из данных (id). Индекс массива ломается при вставке, удалении и сортировке: состояние «переезжает» к чужим элементам. Случайные ключи (Math.random() в map) пересоздают все элементы на каждом рендере. Одинаковые ключи дают предупреждение и путаницу элементов. key не попадает в props компонента.

Вопрос

Что делает key в списках? Почему нельзя использовать индекс и что произойдёт при одинаковых ключах?

Наглядно: что ломает индекс

function TodoList({ todos, onRemove }) {
  return (
    <ul>
      {todos.map((todo, index) => (
        <li key={index}>                          {/* ✗ */}
          <input type="checkbox" />               {/* неконтролируемое состояние в DOM */}
          {todo.title}
          <button onClick={() => onRemove(todo.id)}>✕</button>
        </li>
      ))}
    </ul>
  );
}
Было:                                   Удалили «Купить хлеб»:
key=0 ☑ Купить хлеб                     key=0 ☑ Позвонить маме   ← галочка «переехала»!
key=1 ☐ Позвонить маме                  key=1 ☐ Сделать ДЗ
key=2 ☐ Сделать ДЗ
 
React видит: элементов стало меньше на один, удалился key=2,
у key=0 и key=1 поменялся текст → DOM-узлы (и галочка) остались на местах.

С key={todo.id} React поймёт, что удалён именно элемент с id «хлеба», и уберёт его вместе с галочкой.

Хорошие и плохие ключи

КлючОценкаПочему
todo.id из БД✓Стабилен и уникален
crypto.randomUUID() при создании записи✓Сгенерирован один раз и хранится в данных
user.email✓ если уникаленЕстественный идентификатор
index⚠Только для статичных списков без состояния
Math.random() / randomUUID() в map✗Новый ключ на каждом рендере → все элементы пересоздаются, теряется фокус и состояние
${title} при возможных дубликатах✗Совпадения ключей

Когда индекс допустим

Только если одновременно: список не меняет порядок, элементы не удаляются и не вставляются в середину, у элементов нет собственного состояния (полей ввода, раскрытия). Пример — пункты меню из константы.

Одинаковые ключи

const tags = ["react", "hooks", "react"];
tags.map((tag) => <li key={tag}>{tag}</li>);
// Warning: Encountered two children with the same key, `react`.

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

key ставится на элемент в map

// ✗ key внутри компонента не помогает
function Item({ todo }) {
  return <li key={todo.id}>{todo.title}</li>;
}
todos.map((todo) => <Item todo={todo} />);
 
// ✓ key — на том, что возвращает map
todos.map((todo) => <Item key={todo.id} todo={todo} />);
 
// ✓ Несколько элементов на запись — Fragment с key
todos.map((todo) => (
  <Fragment key={todo.id}>
    <dt>{todo.title}</dt>
    <dd>{todo.description}</dd>
  </Fragment>
));

key не передаётся в props

function Item({ key, todo }) { // key здесь всегда undefined
  // …
}
<Item key={todo.id} id={todo.id} todo={todo} /> // нужен id внутри — передай отдельно

key вне списков: сброс состояния

// Смена userId → новый ключ → компонент создаётся заново с чистым состоянием
<ProfileForm key={userId} userId={userId} />

Так проще и надёжнее, чем очищать поля в useEffect при смене пользователя.

Что важно помнить

  • key = идентичность элемента; состояние «привязано» к ключу.
  • Ключ берут из данных или генерируют при создании данных, а не при рендере.
  • Индекс — только для статичных списков без состояния.
  • Уникальность нужна среди соседей.
  • key на элементе, который возвращает map; для групп — <Fragment key>.
  • Смена key сбрасывает состояние компонента.

Мини-шпаргалка

  • Стабильный + уникальный + из данных.
  • Индекс → состояние «переезжает» при удалении/сортировке.
  • Случайный ключ в map → всё пересоздаётся.
  • Одинаковые ключи → предупреждение и путаница.
  • key не виден в props.

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам