list-performance-item-memo — правило для Claude Code: что делает
Правило list-performance-item-memo для строк списка в React: отдавать в элемент отдельные примитивы вместо объекта целиком, чтобы memo() сравнивал props и не перерисовывал строку без изменений.
MIT ★ 1 216 обновлён 2026-10-24
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settingsЧто делает list-performance-item-memo
Правило касается компонентов, которые рисуют элементы списка. Вместо того чтобы спускать вниз весь объект одним prop, его разбивают на строки, числа и булевы значения. Тогда поверхностное сравнение внутри memo() отрабатывает как надо, и строка остаётся на месте, пока её данные не поменялись.
Внутри — markdown-файл с примерами на TSX. Одна пара показывает UserRow, который принимает объект user, рядом версия с отдельными id, name и email. Другой блок про то, чтобы передавать только те поля, которые компонент действительно рисует. Для колбэков отдельная секция: обработчик поднимают наверх либо передают id элемента, а нажатие обрабатывают внутри дочернего компонента через useCallback.
С объектом в props memo() смотрит на ссылку, поэтому новый объект от родителя сбрасывает всю экономию даже при тех же значениях. Если включён React Compiler, memo() и useCallback() можно не писать, но ссылки на объекты всё равно играют роль.
Какие задачи решает
- убрать перерисовки строк, когда данные не менялись
- переписать
UserRowс объекта на отдельные props - вынести инлайновый
onPressиз props - разобраться, почему
memo()не пропускает рендер - передать в строку только те поля, которые она рисует
Примеры запросов агенту
- Посмотри на
UserRow: почемуmemo()всё равно перерисовывает строку, и переделай props на примитивы - Перепиши
renderItemв этомFlatListтак, чтобы элемент получалidиname, а нажатие обрабатывал сам - Прогони этот экран со списком по правилу
list-performance-item-memoи покажи, где передаётся объект целиком
Как установить list-performance-item-memo
1Через маркетплейс плагинов
/plugin marketplace add fcakyon/claude-codex-settings/plugin install react-skills@claude-settings2Вручную: положить файлы
.claude/rules/list-performance-item-memo.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/list-performance-item-memo.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/list-performance-item-memo.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/list-performance-item-memo.mdВручную: положить файлы
.clinerules/list-performance-item-memo.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о list-performance-item-memo
Как установить list-performance-item-memo в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add fcakyon/claude-codex-settings, затем поставьте плагин: /plugin install react-skills@claude-settings. Правило появится файлом .claude/rules/list-performance-item-memo.md.
Что делает list-performance-item-memo?
Требует передавать в компонент строки списка отдельные примитивы, чтобы memo() сравнивал props поверхностно и пропускал рендер, когда значения те же. Заодно подсказывает, что делать с колбэками.
Нужны ли memo() и useCallback(), если включён React Compiler?
Нет, писать их вручную не требуется. Ссылки на объекты в props при этом никуда не деваются, так что разбивать объект на примитивы всё равно стоит.
Исходный текст
list-performance-item-memo.md · MIT
---
title: Pass Primitives to List Items for Memoization
impact: HIGH
impactDescription: enables effective memo() comparison
tags: lists, performance, memo, primitives
---
## Pass Primitives to List Items for Memoization
When possible, pass only primitive values (strings, numbers, booleans) as props
to list item components. Primitives enable shallow comparison in `memo()` to
work correctly, skipping re-renders when values haven't changed.
**Incorrect (object prop requires deep comparison):**
```tsx
type User = { id: string; name: string; email: string; avatar: string }
const UserRow = memo(function UserRow({ user }: { user: User }) {
// memo() compares user by reference, not value
// If parent creates new user object, this re-renders even if data is same
return <Text>{user.name}</Text>
})
renderItem={({ item }) => <UserRow user={item} />}
```
This can still be optimized, but it is harder to memoize properly.
**Correct (primitive props enable shallow comparison):**
```tsx
const UserRow = memo(function UserRow({
id,
name,
email,
}: {
id: string
name: string
email: string
}) {
// memo() compares each primitive directly
// Re-renders only if id, name, or email actually changed
return <Text>{name}</Text>
})
renderItem={({ item }) => (
<UserRow id={item.id} name={item.name} email={item.email} />
)}
```
**Pass only what you need:**
```tsx
// Incorrect: passing entire item when you only need name
<UserRow user={item} />
// Correct: pass only the fields the component uses
<UserRow name={item.name} avatarUrl={item.avatar} />
```
**For callbacks, hoist or use item ID:**
```tsx
// Incorrect: inline function creates new reference
<UserRow name={item.name} onPress={() => handlePress(item.id)} />
// Correct: pass ID, handle in child
<UserRow id={item.id} name={item.name} />
const UserRow = memo(function UserRow({ id, name }: Props) {
const handlePress = useCallback(() => {
// use id here
}, [id])
return <Pressable onPress={handlePress}><Text>{name}</Text></Pressable>
})
```
Primitive props make memoization predictable and effective.
**Note:** If you have the React Compiler enabled, you do not need to use
`memo()` or `useCallback()`, but the object references still apply.
© fcakyon · MIT · fcakyon/claude-codex-settings