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.