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

list-performance-item-types — правило для Claude Code: списки

Правило list-performance-item-types для Claude Code задаёт типы элементов в списках с разной разметкой. Оно подключается при работе с такими списками и настраивает раздельное переиспользование компонентов.

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-types

Правило предлагает добавлять каждому элементу поле type и передавать тип в getItemType у LegendList. Для заголовков, сообщений и изображений задаются отдельные компоненты; элементы одного типа попадают в общий пул переиспользования, а заголовок не заменяет ячейку изображения.

В примере на TypeScript типы элементов объединены в FeedItem, а switch выбирает компонент по значению type. Для оценки размеров можно настроить getEstimatedItemSize с отдельным значением для каждого типа. Этот подход рассчитан на LegendList и требует поля type в данных списка.

Какие задачи решает

  • разделить переиспользование ячеек с разной разметкой
  • не допустить замену заголовка ячейкой изображения
  • сузить тип элемента в ветках switch на TypeScript
  • задать оценку размера отдельно для каждого типа

Примеры запросов агенту

  • Настрой список LegendList так, чтобы сообщения и изображения использовали разные пулы ячеек.
  • Перепиши Feed с типами элементов header, message и image.
  • Добавь оценку размера элемента для каждого типа в getEstimatedItemSize.

Как установить list-performance-item-types

1Через маркетплейс плагинов

/plugin marketplace add fcakyon/claude-codex-settings
/plugin install react-skills@claude-settings

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

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

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

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о list-performance-item-types

Как установить list-performance-item-types в Claude Code?

Выполни команды по порядку: /plugin marketplace add fcakyon/claude-codex-settings, затем /plugin install react-skills@claude-settings. Правило также доступно в .claude/rules/list-performance-item-types.md.

Что делает list-performance-item-types?

Правило учит задавать тип каждому элементу неоднородного списка и передавать его в getItemType. LegendList разделяет такие элементы по пулам переиспользования.

Как задавать размеры для разных типов элементов?

Передай функцию в getEstimatedItemSize и возвращай оценку в зависимости от itemType, например отдельно для заголовков, сообщений и изображений.

Исходный текст

list-performance-item-types.md · MIT
---
title: Use Item Types for Heterogeneous Lists
impact: HIGH
impactDescription: efficient recycling, less layout thrashing
tags: list, performance, recycling, heterogeneous, LegendList
---

## Use Item Types for Heterogeneous Lists

When a list has different item layouts (messages, images, headers, etc.), use a
`type` field on each item and provide `getItemType` to the list. This puts items
into separate recycling pools so a message component never gets recycled into an
image component.

**Incorrect (single component with conditionals):**

```tsx
type Item = { id: string; text?: string; imageUrl?: string; isHeader?: boolean }

function ListItem({ item }: { item: Item }) {
  if (item.isHeader) {
    return <HeaderItem title={item.text} />
  }
  if (item.imageUrl) {
    return <ImageItem url={item.imageUrl} />
  }
  return <MessageItem text={item.text} />
}

function Feed({ items }: { items: Item[] }) {
  return (
    <LegendList
      data={items}
      renderItem={({ item }) => <ListItem item={item} />}
      recycleItems
    />
  )
}
```

**Correct (typed items with separate components):**

```tsx
type HeaderItem = { id: string; type: 'header'; title: string }
type MessageItem = { id: string; type: 'message'; text: string }
type ImageItem = { id: string; type: 'image'; url: string }
type FeedItem = HeaderItem | MessageItem | ImageItem

function Feed({ items }: { items: FeedItem[] }) {
  return (
    <LegendList
      data={items}
      keyExtractor={(item) => item.id}
      getItemType={(item) => item.type}
      renderItem={({ item }) => {
        switch (item.type) {
          case 'header':
            return <SectionHeader title={item.title} />
          case 'message':
            return <MessageRow text={item.text} />
          case 'image':
            return <ImageRow url={item.url} />
        }
      }}
      recycleItems
    />
  )
}
```

**Why this matters:**

- **Recycling efficiency**: Items with the same type share a recycling pool
- **No layout thrashing**: A header never recycles into an image cell
- **Type safety**: TypeScript can narrow the item type in each branch
- **Better size estimation**: Use `getEstimatedItemSize` with `itemType` for
  accurate estimates per type

```tsx
<LegendList
  data={items}
  keyExtractor={(item) => item.id}
  getItemType={(item) => item.type}
  getEstimatedItemSize={(index, item, itemType) => {
    switch (itemType) {
      case 'header':
        return 48
      case 'message':
        return 72
      case 'image':
        return 300
      default:
        return 72
    }
  }}
  renderItem={({ item }) => {
    /* ... */
  }}
  recycleItems
/>
```

Reference:
[LegendList getItemType](https://legendapp.com/open-source/list/api/props/#getitemtype-v2)

© fcakyon · MIT · fcakyon/claude-codex-settings

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

Все правила IDE по теме «Фронтенд и UI» →
list-performance-images alexj11324 Правило list-performance-images для Claude Code задаёт способ загружать изображения в списках без лишних пикселей. Срабатывает при работе с миниатюрами в интерфейсе. CX Codex +1 ★ 88звёзд репо list-performance-virtualize alexj11324 Правило list-performance-virtualize для Claude Code направляет работу со списками на виртуализацию. Оно срабатывает при создании прокручиваемого содержимого. CX Codex +1 ★ 88звёзд репо legend-list-best-practices LegendApp Скилл legend-list-best-practices для работы с виртуализированным списком @legendapp/list: помогает внедрить его по контрактам библиотеки или провести аудит существующего кода. CX Codex +1 562установок narrow-react-prop-types humanlayer Скилл narrow-react-prop-types сужает типы пропсов React-компонента до контракта, который реально используется в живом коде, и заставляет сторис и тесты подстроиться под него. CX Codex +1 1 500установок types maxtrigify Правило types для Claude Code стандартизирует описание пропсов компонентов в TypeScript. Оно задаёт архитектуру для создания гибких и типизированных интерфейсов в React-проектах. CX Codex +1 ★ 141звёзд репо swiftui-performance dpearson2699 Скилл swiftui-performance для Claude Code, Cursor, Codex и других агентов, который ведёт от воспроизводимого симптома торможения SwiftUI к измеренному результату. CX Codex +1 5 000установок

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

Весь набор →
commit-staged Скилл commit-staged формирует структурированные коммиты: прогоняет diff через /simplify, смотрит только staged-файлы и собирает понятные сообщения из контекста сессии. CX Codex +1 ★ 1 216звёзд репо shell-and-workflows Правило shell-and-workflows описывает работу с Docker-сервисами проекта, типовые команды и порядок запуска тестов. Помогает выбрать, где выполнять фронтенд- и бэкенд-проверки. CX Codex +1 ★ 1 216звёзд репо js-request-idle-callback Правило js-request-idle-callback учит агента уводить аналитику, сохранение состояния и предзагрузку в простой браузера, чтобы интерфейс не подвисал на кликах. CX Codex +1 ★ 1 216звёзд репо pr-comment-resolver Субагент pr-comment-resolver находит неразрешённые замечания в пуллреквесте, исправляет код и готовит черновики ответов рецензентам. Помогает закрыть ревью без ручного разбора тредов. CX Codex ★ 1 216звёзд репо manage-instances Правило manage-instances для параллельного запуска нескольких изолированных стеков приложения в отдельных worktree, каждый со своей БД, Redis и портами. CX Codex +1 ★ 1 216звёзд репо test-audit Скилл test-audit проверяет новые и изменённые тесты, а также помогает находить дубли и низкоценные проверки. Пригодится перед добавлением тестов и при аудите тестового набора. CX Codex +1 ★ 1 216звёзд репо webmcp-gen Скилл webmcp-gen собирает рабочий процесс сайта в WebMCP-инструмент и проверяет, что он ведёт себя так же, как существующий интерфейс. CX Codex +1 ★ 1 216звёзд репо start-environment Правило start-environment для Claude Code описывает запуск локального окружения через dev docker up: ожидание готовности сервисов и определение назначенных портов. CX Codex +1 ★ 1 216звёзд репо

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

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