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

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

Правило data-attributes для Claude Code задаёт паттерны data-state и data-slot для стилизации состояний и связи компонентов.

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

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

Что делает data-attributes

Правило data-attributes задаёт единый способ описывать состояния компонентов через атрибуты data-state, data-disabled, data-loading и похожие значения. Отдельные className-пропсы для открытого, закрытого, выбранного или загружаемого состояния не используются.

Для идентификации частей компонента добавляется data-slot в kebab-case, например search-input или submit-button. Родительские стили могут обращаться к дочерним слотам, а Tailwind применяется через произвольные варианты вроде data-[state=open]:fade-in и [&_[data-slot=button]]:w-full.

Варианты и размеры остаются пропсами. Без Tailwind-поддержки произвольных вариантов эти примеры классов не сработают.

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

  • описать открытое и закрытое состояние компонента
  • связать стили родителя с дочерними компонентами
  • обозначить выбранное, отключённое или загружаемое состояние
  • разделить состояния, слоты, варианты и размеры компонентов

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

  • Перепиши Dialog, чтобы его состояние задавалось через data-state, а стили использовали Tailwind-варианты.
  • Добавь data-slot к CheckboxGroup и настрой стиль FieldSet для вложенной группы.
  • Проверь компонент Button: состояния loading и disabled должны задаваться атрибутами, а варианты и размеры остаться пропсами.

Как установить data-attributes

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

.claude/rules/data-attributes.md

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

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

Вопросы о data-attributes

Как установить data-attributes в Claude Code?

Добавь файл правила по пути .claude/rules/data-attributes.md. Для этого правила отдельная команда не нужна.

Что делает data-attributes?

Правило задаёт паттерны для стилизации состояний через data-state и похожие атрибуты, а также для поиска частей компонентов через data-slot. Состояния отделяются от вариантов и размеров, которые остаются пропсами.

Что нужно для работы data-attributes?

Для примеров с классами нужен Tailwind с поддержкой произвольных вариантов. Без неё селекторы вроде data-[state=open]:fade-in не сработают.

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

data-attributes.md · Apache-2.0
---
title: Data Attributes for Styling
impact: LOW
impactDescription: Clean state-based styling patterns
tags: data-attributes, data-state, data-slot, styling, tailwind, css
---

## Data Attributes for Component Styling

Use `data-state` and `data-slot` attributes to create flexible, maintainable component APIs.

### Use data-state for Visual States

**Never expose separate className props for different states.** Use `data-state` attributes:

```tsx
const Dialog = ({ className, ...props }: DialogProps) => {
  const [isOpen, setIsOpen] = useState(false);
  return (
    <div
      data-state={isOpen ? "open" : "closed"}
      className={cn("transition-all", className)}
      {...props}
    />
  );
};
```

**Consumer styles from outside:**

```tsx
<Dialog className="data-[state=open]:opacity-100 data-[state=closed]:opacity-0" />
```

### Common State Patterns

```tsx
// Open/closed
<Accordion data-state={isOpen ? 'open' : 'closed'} />

// Selected
<Tab data-state={isSelected ? 'active' : 'inactive'} />

// Disabled
<Button data-disabled={isDisabled} disabled={isDisabled} />

// Loading
<Button data-loading={isLoading} />

// Orientation
<Slider data-orientation="horizontal" />

// Side/position
<Tooltip data-side="top" />
```

### Tailwind Integration

```tsx
<Dialog
  className={cn(
    "rounded-lg border p-4",
    "data-[state=open]:animate-in data-[state=open]:fade-in",
    "data-[state=closed]:animate-out data-[state=closed]:fade-out"
  )}
/>
```

### Use data-slot for Component Identification

Give components stable identifiers for parent targeting:

```tsx
function CheckboxGroup({ className, ...props }: React.ComponentProps<"div">) {
  return (
    <div
      data-slot="checkbox-group"
      className={cn("flex flex-col gap-2", className)}
      {...props}
    />
  );
}

function FieldSet({ className, ...props }: React.ComponentProps<"fieldset">) {
  return (
    <fieldset
      data-slot="field-set"
      className={cn(
        "flex flex-col gap-6",
        "has-[>[data-slot=checkbox-group]]:gap-3",
        className
      )}
      {...props}
    />
  );
}
```

### Parent-Aware Styling

```tsx
<form className="[&_[data-slot=button]]:w-full">
  <Button>Submit</Button>
</form>
```

### Naming Conventions

**Incorrect:**

```tsx
data-slot="input"           // Too generic
data-slot="blueButton"      // Includes styling
data-slot="div-wrapper"     // Implementation detail
```

**Correct:**

```tsx
data-slot="search-input"
data-slot="navigation-menu"
data-slot="error-message"
data-slot="submit-button"
```

### When to Use Each

| Pattern      | Use For                                              |
| ------------ | ---------------------------------------------------- |
| `data-state` | Visual states (open/closed, active, loading)         |
| `data-slot`  | Component identification, parent-child targeting     |
| `props`      | Variants (primary, secondary), sizes, event handlers |

### Combined Example

```tsx
const Button = ({
  variant = "primary",
  size = "md",
  loading,
  disabled,
  className,
  ...props
}: ButtonProps) => {
  return (
    <button
      data-slot="button"
      data-loading={loading}
      data-disabled={disabled}
      className={cn(buttonVariants({ variant, size }), className)}
      disabled={disabled}
      {...props}
    />
  );
};

// Usage
<form className="[&_[data-slot=button]]:w-full">
  <Button loading={isLoading} className="data-[loading=true]:opacity-50">
    Submit
  </Button>
</form>;
```

### Rules

1. **Use `data-state` instead of separate className props** for states
2. **Add `data-slot` to reusable components** for targeting
3. **Use kebab-case** for `data-slot` values
4. **Prefer Tailwind arbitrary variants** over custom CSS
5. **Never rely on class names** for parent-child targeting

© maxtrigify · Apache-2.0 · maxtrigify/Otto

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

Все правила IDE по теме «Фронтенд и UI» →
baseline-ui ibelick Скилл baseline-ui для Claude Code задаёт правила для чистки UI-кода. Запускается для правок интерфейса или проверки конкретного файла. CX Codex +1 27 000установок stitch::extract-design-md официальный google-labs-code Скилл stitch::extract-design-md для Claude Code извлекает дизайн-систему из исходников фронтенда в DESIGN.md без сборки. Переносит визуальные токены и правила вёрстки в формат Stitch. CX Codex +1 12 300установок tailwind-v4-shadcn secondsky Скилл tailwind-v4-shadcn настраивает связку Tailwind CSS v4, shadcn/ui и React в проектах на Vite. Помогает избежать ошибок импорта и поломки CSS-переменных при переключении тем оформления. CX Codex +1 8 300установок tailwind-theme-builder jezweb Скилл tailwind-theme-builder для Claude Code настраивает тему Tailwind v4 и shadcn/ui с тёмным режимом. Запускается при настройке цветов, переходе с Tailwind v3 или поиске причин, почему стили не работают. CX Codex +1 3 300установок emilkowal-animations pproenca Скилл emilkowal-animations для Claude Code — набор из 58 правил веб-анимации для настройки кривых плавности, жестов и таймингов в React и CSS. CX Codex +1 2 800установок tailwindcss Mindrally Задаёт агенту роль эксперта по TailwindCSS с акцентом на utility-first подход и мобильно-ориентированную вёрстку. CX Codex +1 1 600установок

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

Весь набор →
design-tokens Правило design-tokens для Claude Code заменяет жёстко заданные цвета семантическими токенами. Переключение светлой и тёмной темы меняет значения переменных, а не классы компонентов. CX Codex +1 ★ 141звёзд репо composition Правило composition для Claude Code помогает разбивать крупные UI-компоненты на небольшие субагенты с четкими задачами. Оно применяется при проектировании библиотек и сложных интерфейсов. CX Codex +1 ★ 141звёзд репо overview Правило overview для Claude Code задаёт принципы создания доступных и составных UI-компонентов. Оно подключается при проектировании компонентов и их API. CX Codex +1 ★ 141звёзд репо types Правило types для Claude Code стандартизирует описание пропсов компонентов в TypeScript. Оно задаёт архитектуру для создания гибких и типизированных интерфейсов в React-проектах. CX Codex +1 ★ 141звёзд репо principles Правило principles для Claude Code, Codex, Cursor, GitHub Copilot, Windsurf и Cline задаёт шесть критериев проектирования компонентов для оценки кода, рефакторинга и создания интерфейсов. CX Codex +1 ★ 141звёзд репо 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звёзд репо

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

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