Уберите checked из локального состояния строки и храните выбор в компоненте списка, store или модели формы как множество стабильных item IDs. Виртуализатор размонтирует строки вне окна и позже создаёт их снова; локальное состояние исчезает вместе с компонентом или, при неверном key, переезжает к другому объекту.
После исправления строка становится проекцией данных: checked равен selectedIds.has(item.id), а обработчик добавляет или удаляет именно item.id. Индекс видимой строки годится для позиционирования, но не для бизнес-идентичности.
Виртуализация экономит DOM, но не хранит выбор
На экране могут существовать только двадцать компонентов из десяти тысяч записей. Прокрутка меняет диапазон, старые компоненты удаляются, новые получают данные других элементов. Это нормальная работа. Ошибка появляется, когда состояние пользователя привязано к жизненному циклу временной строки.
React объясняет, что state связан с позицией компонента в дереве, а key участвует в определении его identity. В документации списков также предупреждается: индекс и случайно сгенерированный key приводят к тонким ошибкам и потере пользовательского ввода при перестановках.
Выбор живёт в наборе идентификаторов
const [selected, setSelected] = useState(() => new Set());
function toggle(id) {
setSelected(previous => {
const next = new Set(previous);
next.has(id) ? next.delete(id) : next.add(id);
return next;
});
}
checked = selected.has(item.id);Создавайте новый Set при изменении, чтобы React увидел новую ссылку. Сам item.id должен приходить из данных и оставаться тем же после сортировки, фильтра и повторной загрузки. Если backend выдаёт только позицию в странице, сначала добавьте постоянный идентификатор; составной ключ допустим лишь при доказанной уникальности и стабильности.
Три identity обязаны согласоваться
| Уровень | Правильный ключ | Что ломает выбор |
|---|---|---|
| Данные | item.id из источника | ID меняется при каждой загрузке |
| React/Vue строка | key=item.id | key=index или случайное значение |
| Виртуализатор | getItemKey возвращает item.id | Кэш измерений привязан к индексу |
| Selection store | Set или map по item.id | selected[index] |
| Отправка на сервер | Список item IDs | Номера строк текущего окна |
TanStack Virtual по умолчанию может использовать индекс, но рекомендует переопределить getItemKey и возвращать уникальный ключ элемента. Особенно это важно при вставке, удалении и prepend: старый индекс начинает обозначать другой объект, а вместе с ним путаются измерение, DOM и selection.
Фильтр меняет видимость, а не владение выбором
- Режим preserve: скрытые фильтром IDs остаются выбранными, рядом показывается общее количество.
- Режим visible only: смена фильтра явно очищает невидимые IDs и сообщает об этом пользователю.
- Select all current page выбирает загруженные ID, а не абстрактные индексы.
- Select all results хранит query snapshot плюс исключения, если весь набор слишком велик.
- Удалённый с сервера item удаляется из selection после подтверждённого ответа, а не из-за scroll.
Политику выбора надо назвать в интерфейсе. Иначе пользователь отмечает элементы, применяет фильтр и не понимает, отправится действие к скрытым строкам или нет. Для массовой операции сервер всё равно повторно проверяет доступ и существование каждого ID.
Неконтролируемый input маскирует дефект
defaultChecked задаёт начальное значение DOM и не синхронизирует дальнейшие изменения selection store. В recycled-строке он может визуально показать состояние предыдущего объекта. Используйте controlled checked и обработчик, работающий с текущим item.id. Аналогично текстовый input хранит draft по ID, если ввод обязан пережить выход из viewport.
Overscan только дольше держит соседние строки смонтированными. Он может сделать баг реже, но не исправляет модель. При быстрой прокрутке, маленьком окне или мобильном устройстве строка всё равно покинет диапазон.
Контрольный тест принудительно перерабатывает строки
- Выбрать элементы в начале, середине и конце набора.
- Прокрутить так, чтобы каждый выбранный элемент был размонтирован.
- Вернуться и проверить controlled checked и счётчик выбранных ID.
- Изменить сортировку, фильтр и добавить элемент в начало списка.
- Перезагрузить одну страницу данных и выполнить массовое действие по ожидаемым ID.
Для разбора приложите небольшой обезличенный массив с ID, конфигурацию getItemKey, JSX одной строки и состояние selection до и после прокрутки. Скриншот чекбокса без этих данных не показывает, потерялся state, изменился key или сервер вернул другой объект.