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

as-child — правило для Claude Code: что делает и как установить

Правило as-child для Claude Code объединяет свойства и обработчики компонента с дочерним элементом без лишней DOM-обёртки. Подключается при создании составных React-компонентов и trigger-элементов.

Apache-2.0 ★ 141 обновлён 2026-11-17

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/as-child.md
Открыть на GitHub

Что делает as-child

Правило as-child описывает паттерн, при котором компонент передаёт свойства, поведение и обработчики пользовательскому дочернему элементу вместо рендера стандартного DOM-тега. Так trigger может сохранить свою логику, а снаружи останется один семантичный элемент.

Для объединения используется Slot из @radix-ui/react-slot. Дочерний компонент должен принимать и передавать дальше все свойства через {...props}, а при asChild допускается только один дочерний элемент. Ручной React.cloneElement этот подход не заменяет.

Паттерн подходит для Dialog.Trigger, Tooltip.Trigger, DropdownMenu.Trigger и NavigationMenu.Link, включая вложенную композицию. При использовании несемантичного элемента нужно задать role, tabIndex и подходящий ARIA-атрибут.

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

  • убрать вложенные кнопки и лишние DOM-обёртки
  • передать обработчики trigger пользовательскому элементу
  • сохранить семантику HTML при смене рендера компонента
  • связать несколько составных компонентов через один дочерний элемент

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

  • Опиши паттерн asChild для Dialog.Trigger и покажи вариант с одной кнопкой.
  • Проверь компонент: дочерний элемент должен получать свойства через {...props}, а для объединения используй Slot.
  • Покажи, как применить asChild в NavigationMenu.Link с компонентом Link и сохранить доступность.

Как установить as-child

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

.claude/rules/as-child.md

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

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

Вопросы об as-child

Как установить as-child в Claude Code?

Разместите файл правила по пути .claude/rules/as-child.md.

Что делает as-child?

Паттерн передаёт свойства, поведение и обработчики компонента его пользовательскому дочернему элементу. Это позволяет рендерить один нужный DOM-элемент без стандартной обёртки.

Что нужно для работы as-child?

Для реализации используется @radix-ui/react-slot. Дочерний компонент должен принимать свойства через {...props}, а при asChild должен быть один дочерний элемент.

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

as-child.md · Apache-2.0
---
title: asChild Pattern
impact: MEDIUM
impactDescription: Prop merging without wrapper elements
tags: as-child, slot, radix, composition, prop-merging
---

## asChild Pattern

The `asChild` prop allows components to merge their props, behaviors, and event handlers with a custom child element instead of rendering a default DOM element.

### When to Use

Implement `asChild` when:

- Building trigger components (Dialog.Trigger, Tooltip.Trigger)
- Creating composable components that wrap other elements
- Allowing users to customize rendered element while preserving functionality
- Integrating with existing design system components

### Implementation

```tsx
import { Slot } from "@radix-ui/react-slot";

interface TriggerProps extends React.ComponentPropsWithoutRef<"button"> {
  asChild?: boolean;
}

export const Trigger = React.forwardRef<HTMLButtonElement, TriggerProps>(
  ({ asChild = false, children, ...props }, ref) => {
    if (asChild) {
      return (
        <Slot ref={ref} {...props}>
          {children}
        </Slot>
      );
    }
    return (
      <button ref={ref} {...props}>
        {children}
      </button>
    );
  }
);
```

### How It Works

**Without asChild (nested elements):**

```tsx
<Dialog.Trigger>
  <button>Open Dialog</button>
</Dialog.Trigger>
// Renders: <button><button>Open Dialog</button></button>
```

**With asChild (props merge onto child):**

```tsx
<Dialog.Trigger asChild>
  <button>Open Dialog</button>
</Dialog.Trigger>
// Renders: <button data-state="closed">Open Dialog</button>
```

### Common Use Cases

**Custom Trigger Elements:**

```tsx
<AlertDialog.Trigger asChild>
  <a href="/delete">Delete Account</a>
</AlertDialog.Trigger>

<Tooltip.Trigger asChild>
  <IconButton icon={<InfoIcon />} />
</Tooltip.Trigger>

<DropdownMenu.Trigger asChild>
  <Button variant="outline" size="icon">
    <MoreVertical className="h-4 w-4" />
  </Button>
</DropdownMenu.Trigger>
```

**Semantic HTML:**

```tsx
<NavigationMenu.Link asChild>
  <Link href="/products" className="nav-link">
    Products
  </Link>
</NavigationMenu.Link>
```

**Component Composition:**

```tsx
<Dialog.Trigger asChild>
  <Tooltip.Trigger asChild>
    <button>Open dialog (with tooltip)</button>
  </Tooltip.Trigger>
</Dialog.Trigger>
```

### Best Practices

**1. Child Must Spread Props:**

**Incorrect:**

```tsx
// Won't receive trigger behavior
const BadButton = ({ children }) => <button>{children}</button>;
```

**Correct:**

```tsx
// Properly receives all props
const GoodButton = ({ children, ...props }) => (
  <button {...props}>{children}</button>
);
```

**2. Single Child Element Only:**

**Incorrect:**

```tsx
// Multiple children
<Trigger asChild>
  <button>One</button>
  <button>Two</button>
</Trigger>
```

**Correct:**

```tsx
// Single child
<Trigger asChild>
  <button>Single Button</button>
</Trigger>
```

**3. Maintain Accessibility:**

**Correct:**

```tsx
// Maintains button semantics
<Dialog.Trigger asChild>
  <button type="button">Open</button>
</Dialog.Trigger>
```

**Note (ensure proper ARIA):**

```tsx
// Ensure proper ARIA when using non-semantic elements
<Dialog.Trigger asChild>
  <div role="button" tabIndex={0} aria-label="Open dialog">
    Open
  </div>
</Dialog.Trigger>
```

### Common Pitfalls

**Don't manually clone elements:**

**Incorrect:**

```tsx
// Manual cloning misses edge cases
if (asChild) {
  return React.cloneElement(children, { ...props });
}
```

**Correct:**

```tsx
// Use Slot for proper merging
if (asChild) {
  return <Slot {...props}>{children}</Slot>;
}
```

### Integration

The `asChild` pattern is essential for:

- **Composability** - Enables flexible component composition
- **Customizable** - Allows users to control rendered elements
- **Transparent** - No hidden wrapper elements in DOM
- **Accessible** - Maintains semantic HTML structure

Reference: [@radix-ui/react-slot](https://www.radix-ui.com/primitives/docs/utilities/slot)

© maxtrigify · Apache-2.0 · maxtrigify/Otto

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

Все правила IDE по теме «Фронтенд и UI» →
fluid-functionalism mickadesign Скилл fluid-functionalism для Claude Code ставит компоненты реестра @fluid для shadcn/ui с общей системой движения и сверяет стек проекта перед установкой. Держит анимации React-интерфейса в одном наборе правил. CX Codex +1 1 100установок shadcn-ui existential-birds Учит агента строить UI-компоненты по паттернам shadcn/ui — CVA-варианты, составные компоненты, data-slot-атрибуты. CX Codex +1 358установок vercel-skills podo Ставит пять официальных скиллов Vercel: ревью интерфейса по Web Interface Guidelines, проверку текстов, производительность React/Next.js, композицию компонентов и View Transitions. CX Codex +1 213установок vercel-composition-patterns vercel Скилл vercel-composition-patterns для Claude Code задаёт правила перехода от Boolean props к compound components и общему контексту в React. CX Codex +1 464 000установок react-hooks-composition Claude MPM Team Скилл react-hooks-composition для Claude Code помогает собирать React-хуки для загрузки данных, поиска с задержкой и контекстов. Связывает состояние интерфейса с запросами к API. CX Codex +1 206установок server-parallel-fetching tech-leads-club Правило server-parallel-fetching для Claude Code показывает, как перестроить React Server Components для параллельных независимых запросов данных. Устраняет цепочки загрузки, где компонент ждёт другого. CX Codex +1 ★ 7 191звёзд репо

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

Весь набор →
overview Правило overview для Claude Code задаёт принципы создания доступных и составных UI-компонентов. Оно подключается при проектировании компонентов и их API. CX Codex +1 ★ 141звёзд репо types Правило types для Claude Code стандартизирует описание пропсов компонентов в TypeScript. Оно задаёт архитектуру для создания гибких и типизированных интерфейсов в React-проектах. CX Codex +1 ★ 141звёзд репо data-attributes Правило data-attributes для Claude Code задаёт паттерны data-state и data-slot для стилизации состояний и связи компонентов. CX Codex +1 ★ 141звёзд репо principles Правило principles для Claude Code, Codex, Cursor, GitHub Copilot, Windsurf и Cline задаёт шесть критериев проектирования компонентов для оценки кода, рефакторинга и создания интерфейсов. CX Codex +1 ★ 141звёзд репо documentation Правило documentation для Claude Code задаёт единый стандарт описания компонентов интерфейса. Ассистент оформляет справку со свойствами, примерами и требованиями доступности. CX Codex +1 ★ 141звёзд репо state Правило state для Claude Code задаёт паттерны управляемого и неуправляемого состояния React-компонентов. Оно включается при проектировании API компонентов. CX Codex +1 ★ 141звёзд репо accessibility Правило accessibility для Claude Code задаёт стандарты доступности интерфейсов. Включается при верстке компонентов, форм и навигационных меню по WCAG. CX Codex +1 ★ 141звёзд репо polymorphism Правило polymorphism для Claude Code задаёт полиморфные React-компоненты с единым стилем и поведением. HTML-элемент меняется через проп as. CX Codex +1 ★ 141звёзд репо

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

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