patterns-children-over-render-props — правило
Правило patterns-children-over-render-props для Claude Code описывает композицию React-компонентов через children вместо renderX-пропсов, в том числе для формы с разросшимися колбэками.
MIT ★ 7 191 обновлён 2026-10-24
.claude/rules/patterns-children-over-render-props.mdЧто делает patterns-children-over-render-props
Правило описывает один приём в React: собирать компонент из children, а не из пропсов вида renderHeader или renderFooter. Внутри есть пример формы, где шапка, футер и кнопки приходят колбэками, и переписанный вариант на составных частях — Composer.Frame, Composer.Footer, Composer.Input. Вызов становится обычным JSX, читать его проще.
Есть и обратный случай. Когда родитель передаёт ребёнку данные или состояние, render props остаются: в примере это List с data и renderItem. Поэтому колбэки правило не запрещает целиком — смотрите, у кого данные.
Файл кладётся в .claude/rules/patterns-children-over-render-props.md, иначе правило просто не подхватится.
Какие задачи решает
- переписать форму с
renderHeaderиrenderFooterнаchildren - разложить монолитный компонент на
Composer.FrameиComposer.Footer - решить, оправдан ли пропс
renderItemв конкретном списке - убрать колбэки из публичного API компонента
- объяснить на ревью, почему JSX с детьми читается легче
Примеры запросов агенту
- Перепиши
Composerтак, чтобы шапка и футер передавались черезchildren, а не черезrenderHeaderиrenderFooter. - Разбей эту форму на
Composer.Frame,Composer.InputиComposer.Footer. - Тут точно нужен
renderItemили лучше отдать элементы черезchildren?
Как установить patterns-children-over-render-props
Вручную: положить файлы
.claude/rules/patterns-children-over-render-props.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/patterns-children-over-render-props.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/patterns-children-over-render-props.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/patterns-children-over-render-props.mdВручную: положить файлы
.clinerules/patterns-children-over-render-props.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о patterns-children-over-render-props
Как установить правило patterns-children-over-render-props в Claude Code?
Положите файл правила в проект по пути .claude/rules/patterns-children-over-render-props.md.
Что делает patterns-children-over-render-props?
Учит агента собирать React-компоненты через children и оставлять renderX-пропсы для случая, когда родитель отдаёт ребёнку данные или состояние.
Когда render props всё-таки уместны?
Когда данные или состояние идут сверху вниз. В правиле это List, который получает data и renderItem.
Исходный текст
patterns-children-over-render-props.md · MIT
---
title: Prefer Composing Children Over Render Props
impact: MEDIUM
impactDescription: cleaner composition, better readability
tags: composition, children, render-props
---
## Prefer Children Over Render Props
Use `children` for composition instead of `renderX` props. Children are more
readable, compose naturally, and don't require understanding callback
signatures.
**Incorrect (render props):**
```tsx
function Composer({
renderHeader,
renderFooter,
renderActions,
}: {
renderHeader?: () => React.ReactNode
renderFooter?: () => React.ReactNode
renderActions?: () => React.ReactNode
}) {
return (
<form>
{renderHeader?.()}
<Input />
{renderFooter ? renderFooter() : <DefaultFooter />}
{renderActions?.()}
</form>
)
}
// Usage is awkward and inflexible
return (
<Composer
renderHeader={() => <CustomHeader />}
renderFooter={() => (
<>
<Formatting />
<Emojis />
</>
)}
renderActions={() => <SubmitButton />}
/>
)
```
**Correct (compound components with children):**
```tsx
function ComposerFrame({ children }: { children: React.ReactNode }) {
return <form>{children}</form>
}
function ComposerFooter({ children }: { children: React.ReactNode }) {
return <footer className='flex'>{children}</footer>
}
// Usage is flexible
return (
<Composer.Frame>
<CustomHeader />
<Composer.Input />
<Composer.Footer>
<Composer.Formatting />
<Composer.Emojis />
<SubmitButton />
</Composer.Footer>
</Composer.Frame>
)
```
**When render props are appropriate:**
```tsx
// Render props work well when you need to pass data back
<List
data={items}
renderItem={({ item, index }) => <Item item={item} index={index} />}
/>
```
Use render props when the parent needs to provide data or state to the child.
Use children when composing static structure.
© tech-leads-club · MIT · tech-leads-club/agent-skills