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

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

Правило polymorphism для Claude Code задаёт полиморфные React-компоненты с единым стилем и поведением. HTML-элемент меняется через проп as.

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

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

Что делает polymorphism

Правило polymorphism описывает компоненты React, которые сохраняют стили и поведение при смене HTML-элемента или другого компонента. Проп as позволяет передать a, button, div или собственный компонент, а TypeScript-тип подтягивает подходящие свойства через React.ElementType и React.ComponentPropsWithoutRef.

Материал охватывает текстовые, layout- и интерактивные компоненты. Для семантики заданы примеры с article, nav, h2, а для доступности — role, tabIndex, обработка клавиш и aria-label. Вложенная кнопка или div внутри p создают некорректную HTML-структуру.

В Claude Code файл размещается по пути .claude/rules/polymorphism.md, в Cursor — .cursor/rules/polymorphism.mdc, в GitHub Copilot — .github/instructions/polymorphism.instructions.md; для Windsurf нужен .devin/rules/polymorphism.md, для Cline — .clinerules/polymorphism.md. Пользовательский компонент передают стабильной ссылкой, иначе он создаётся заново на каждом рендере.

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

  • менять HTML-элемент компонента через проп as
  • сохранять стили при рендеринге Text как h1 или p
  • типизировать свойства полиморфного React-компонента в TypeScript
  • добавлять клавиатурное управление для кликабельного элемента
  • избегать некорректной вложенности HTML-элементов

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

  • Сделай компонент Button, который рендерится как a с href и как button с type.
  • Перепиши Text, чтобы он принимал as="h1" и сохранял вариант заголовка.
  • Проверь полиморфный компонент на доступность, клавиатурное управление и корректную HTML-вложенность.

Как установить polymorphism

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

.claude/rules/polymorphism.md

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

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

Вопросы о polymorphism

Как установить polymorphism в Claude Code?

Создайте файл .claude/rules/polymorphism.md и поместите в него правило.

Что делает polymorphism?

Правило описывает полиморфные React-компоненты: один компонент может выводить разные HTML-элементы через проп as, сохраняя стили, поведение и типизацию свойств.

Как polymorphism помогает с доступностью?

Оно предлагает выбирать семантические элементы, задавать aria-label для навигации и добавлять role, tabIndex и обработку клавиш для элементов, которые не являются button или a.

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

polymorphism.md · Apache-2.0
---
title: Polymorphism Patterns
impact: MEDIUM
impactDescription: Flexible element rendering
tags: polymorphism, as-prop, element-type, typescript, semantic-html
---

## Polymorphism Patterns

Build flexible components that can render as different HTML elements or components while maintaining consistent styling and behavior.

### Core Pattern: The `as` Prop

The `as` prop allows components to change their rendered element type:

```tsx
<Button as="a" href="/home">Go Home</Button>
<Button as="button" type="submit">Submit</Button>
<Button as="div" role="button" tabIndex={0}>Custom Element</Button>
```

### Basic Implementation

```tsx
function Component({ as: Element = "div", children, ...props }) {
  return <Element {...props}>{children}</Element>;
}
```

### TypeScript Implementation

```tsx
type PolymorphicProps<E extends React.ElementType> = {
  as?: E;
  children?: React.ReactNode;
} & React.ComponentPropsWithoutRef<E>;

function Component<E extends React.ElementType = "div">({
  as,
  children,
  ...props
}: PolymorphicProps<E>) {
  const Element = as || "div";
  return <Element {...props}>{children}</Element>;
}
```

### Common Use Cases

**Typography Components:**

```tsx
function Text({ as: Element = 'span', variant = 'body', ...props }) {
  const className = cn(
    'text-base',
    variant === 'heading' && 'text-2xl font-bold',
    variant === 'body' && 'text-base',
    props.className
  );
  return <Element className={className} {...props} />;
}

<Text as="h1" variant="heading">Title</Text>
<Text as="p" variant="body">Paragraph</Text>
```

**Layout Components:**

```tsx
function Flex({ as: Element = 'div', ...props }) {
  return <Element className={cn('flex', props.className)} {...props} />;
}

<Flex as="header" className="justify-between"><Logo /><Navigation /></Flex>
<Flex as="main" className="flex-col"><Content /></Flex>
```

**Interactive Elements:**

```tsx
function Clickable({ as: Element = "button", ...props }) {
  const isButton = Element === "button";
  const isAnchor = Element === "a";
  return (
    <Element
      role={!isButton && !isAnchor ? "button" : undefined}
      tabIndex={!isButton && !isAnchor ? 0 : undefined}
      {...props}
    />
  );
}
```

### Best Practices

**1. Default to Semantic Elements:**

**Incorrect (too generic):**

```tsx
function Component({ as: Element = "div", ...props }) {}
```

**Correct (semantic defaults):**

```tsx
function Article({ as: Element = "article", ...props }) {}
function Navigation({ as: Element = "nav", ...props }) {}
function Heading({ as: Element = "h2", ...props }) {}
```

**2. Document Valid Elements:**

```tsx
interface BoxProps {
  /**
   * The HTML element to render as
   * @default 'div'
   */
  as?: "div" | "section" | "article" | "aside" | "main" | "header" | "footer";
}
```

**3. Handle Event Handlers:**

```tsx
function Interactive({ as: Element = "button", onClick, ...props }) {
  const handleKeyDown = (e: React.KeyboardEvent) => {
    if (Element !== "button" && (e.key === "Enter" || e.key === " ")) {
      onClick?.(e as any);
    }
  };
  return (
    <Element
      onClick={onClick}
      onKeyDown={Element !== "button" ? handleKeyDown : undefined}
      {...props}
    />
  );
}
```

### Common Pitfalls

**Invalid HTML Nesting:**

```tsx
// Incorrect: Invalid - button inside button
<Button as="button"><Button as="button">Nested</Button></Button>

// Incorrect: Invalid - div inside p
<Text as="p"><Box as="div">Invalid</Box></Text>

// Correct: Valid nesting
<Text as="div"><Box as="div">Valid</Box></Text>
```

**Missing Accessibility:**

```tsx
// ❌ Missing accessibility
<Box as="nav"><MenuItems /></Box>

// ✅ Proper accessibility
<Box as="nav" aria-label="Main navigation"><MenuItems /></Box>
```

**Performance:**

```tsx
// ❌ Creates new component on every render
function Parent() {
  const CustomDiv = (props) => <div {...props} />;
  return <Component as={CustomDiv} />;
}

// ✅ Stable component reference
const CustomDiv = (props) => <div {...props} />;
function Parent() {
  return <Component as={CustomDiv} />;
}
```

### Key Benefits

1. **Semantic HTML Flexibility** - Use the most appropriate element
2. **Component Reusability** - One component serves multiple purposes
3. **Accessibility** - Choose elements for best accessibility
4. **Style System Integration** - Maintain styling while changing elements

© maxtrigify · Apache-2.0 · maxtrigify/Otto

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

Все правила IDE по теме «Фронтенд и UI» →
wcag-audit-patterns Seth Hobson Скилл wcag-audit-patterns проверяет веб-интерфейс по WCAG 2.2, сочетая автотесты и ручную проверку. Нужен при поиске нарушений и внедрении доступных паттернов. CX Codex +1 12 486установок semantic-html-and-seo dembrandt Скилл semantic-html-and-seo для ИИ-агента: подсказывает семантичную разметку HTML5, метатеги, alt-тексты и progressive enhancement. Пригодится при вёрстке интерфейса и разборе чужого markup. CX Codex +1 1 100установок accessibility oakoss Скилл accessibility помогает создавать и проверять интерфейсы по WCAG 2.2 AA: от семантической HTML-разметки до клавиатурной навигации и поддержки скринридеров. CX Codex +1 164установок frontend-developer VoltAgent Community Субагент frontend-developer для разработки полных фронтенд-приложений на React 18+, Vue 3+ и Angular 15+. Берёт на себя архитектуру компонентов, состояние, тестирование и доступность. CX Codex 40 905установок react-code-review giuseppe-trisciuoglio Скилл react-code-review проверяет React-компоненты и хуки перед мержем: архитектура, зависимости в useEffect, доступность, типы. Полезен, когда правки уже готовы и нужен разбор по серьёзности. CX Codex +1 4 600установок front-end-developer Mindrally Задаёт агенту роль Senior Front-End Developer с экспертизой в React, Next.js, TypeScript и TailwindCSS. CX Codex +1 1 300установок

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

Весь набор →
as-child Правило as-child для Claude Code объединяет свойства и обработчики компонента с дочерним элементом без лишней DOM-обёртки. Подключается при создании составных React-компонентов и trigger-элементов. 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звёзд репо styling Правило styling для Claude Code задаёт стандарты вёрстки компонентов на Tailwind CSS. Направляет агента объединять классы через tailwind-merge, clsx и CVA. CX Codex +1 ★ 141звёзд репо definitions Правило definitions для Claude Code классифицирует UI-артефакты и задаёт точные названия для компонентов, блоков, шаблонов и паттернов. CX Codex +1 ★ 141звёзд репо components-build Скилл components-build для Claude Code помогает создавать, проверять и перерабатывать переиспользуемые компоненты React по спецификации components.build. Он подключается к задачам об API компонентов, доступности, стилях и типах TypeScript. CX Codex +1 ★ 141звёзд репо otto-design Скилл otto-design для Claude Code задаёт процесс проектирования интерфейсов Otto в Paper перед сборкой в SwiftUI. Включается при запросах на мокапы, редизайн или изменение экранов и карточек приложения. CX Codex +1 ★ 141звёзд репо

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

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