К основному содержанию
правило CX Codex

list-performance-item-memo — правило для Claude Code: что делает

Правило list-performance-item-memo для строк списка в React: отдавать в элемент отдельные примитивы вместо объекта целиком, чтобы memo() сравнивал props и не перерисовывал строку без изменений.

MIT ★ 1 216 обновлён 2026-10-24

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settings
Открыть на GitHub

Что делает 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-settings

2Вручную: положить файлы

.claude/rules/list-performance-item-memo.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: 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

Похожие правила IDE

Все правила IDE по теме «Фронтенд и UI» →
list-performance-virtualize alexj11324 Правило list-performance-virtualize для Claude Code направляет работу со списками на виртуализацию. Оно срабатывает при создании прокручиваемого содержимого. CX Codex +1 ★ 88звёзд репо list-performance-images alexj11324 Правило list-performance-images для Claude Code задаёт способ загружать изображения в списках без лишних пикселей. Срабатывает при работе с миниатюрами в интерфейсе. CX Codex +1 ★ 88звёзд репо rerender-memo tech-leads-club Правило rerender-memo учит агента выносить дорогие вычисления в отдельные мемоизированные компоненты, чтобы избежать лишних расчётов при ранних возвратах. Помогает ускорить рендеринг в React-приложениях. CX Codex +1 ★ 7 191звёзд репо rerender-memo-with-default-value tech-leads-club Правило rerender-memo-with-default-value предотвращает ломку мемоизации компонентов React из-за того, что новые экземпляры объектов и функций создаются при каждом рендере. Извлекает дефолтные значения в константы. CX Codex +1 ★ 7 191звёзд репо investment-memo claude-office-skills Скилл investment-memo для Claude Code составляет инвестиционные меморандумы для VC, PE и публичных рынков. Он структурирует тезис, риски и рекомендацию для инвестиционного комитета. CX Codex +1 5 600установок ic-memo официальный anthropics Скилл ic-memo готовит структурированный меморандум для инвесткомитета по сделке прямых инвестиций. Собирает результаты due diligence, финмодель и условия в девять разделов. CX Codex +1 1 200установок

Из того же набора113

Весь набор →
state-ground-truth Правило state-ground-truth, которое запрещает хранить в состоянии производные визуальные значения. Учит агента разделять факт и его отображение. CX Codex +1 ★ 1 216звёзд репо ui-styling Правило ui-styling задаёт современные стандарты стилизации React Native: скругления со сглаживанием, отступы через gap, синтаксис boxShadow и градиенты без сторонних библиотек. CX Codex +1 ★ 1 216звёзд репо ui-measure-views Правило ui-measure-views предписывает измерять размеры View в React Native через связку useLayoutEffect и onLayout, предотвращая лишние ререндеры. CX Codex +1 ★ 1 216звёзд репо create-issue Скилл create-issue для Claude Code помогает создать или переписать issue: оформить баг, запросить функцию или улучшить заголовок и описание. Перед публикацией он проверяет шаблон репозитория и ищет похожие обращения. CX Codex +1 ★ 1 216звёзд репо react-state-dispatcher Правило react-state-dispatcher требует передавать колбэк-апдейтер в setState, когда новое значение зависит от текущего. Защищает от устаревших замыканий и лишних перерисовок. CX Codex +1 ★ 1 216звёзд репо setup Скилл setup для Claude Code разворачивает интеграционные тесты и пользовательские сценарии тестирования в проекте. Включается при запросах настроить сквозное тестирование или добавить QA-сценарии. CX Codex +1 ★ 1 216звёзд репо list-performance-inline-objects Правило list-performance-inline-objects запрещает создавать объекты внутри renderItem для передачи в пропсы. Встроенные объекты создают новые ссылки на каждом рендере и ломают мемоизацию. CX Codex +1 ★ 1 216звёзд репо setup Команда setup настраивает ключ API для MCP-сервера Tavily в Claude Code и сохраняет его в конфигурационном файле плагина. CX Codex +1 ★ 1 216звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой