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

state — правило для Claude Code: управляемое состояние

Правило state для Claude Code задаёт паттерны управляемого и неуправляемого состояния React-компонентов. Оно включается при проектировании API компонентов.

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

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

Что делает state

Правило state описывает два режима состояния React-компонентов. В неуправляемом режиме компонент хранит значение сам, а в управляемом родитель передаёт значение и обработчик изменений. Это помогает согласовать состояние с внешними данными, валидацией формы и сохранением.

Для объединения обоих режимов используется useControllableState из @radix-ui/react-use-controllable-state. Правило задаёт имена пропсов: value и defaultValue, checked и defaultChecked, open и defaultOpen, а также соответствующие callback-пропсы. Для работы объединённого режима нужна библиотека @radix-ui/react-use-controllable-state.

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

  • выбрать управляемую или неуправляемую модель состояния компонента
  • согласовать состояние компонента с данными родителя
  • добавить поддержку value и defaultValue в одном API
  • назвать пропсы и callback-пропсы по единому паттерну

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

  • Спроектируй компонент Stepper с управляемым и неуправляемым состоянием.
  • Добавь в Toggle поддержку checked, defaultChecked и onCheckedChange.
  • Переведи компонент на useControllableState из @radix-ui/react-use-controllable-state.

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

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

.claude/rules/state.md

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

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

Вопросы о state

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

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

Что делает state?

Правило описывает API компонентов, которое поддерживает управляемое и неуправляемое состояние. Для общего решения используется useControllableState.

Что нужно для работы state?

Для объединённого режима состояния нужна библиотека @radix-ui/react-use-controllable-state.

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

state.md · Apache-2.0
---
title: State Management Patterns
impact: HIGH
impactDescription: Flexible component APIs for all use cases
tags: state, controlled, uncontrolled, useControllableState, radix
---

## State Management Patterns

Build flexible components that work seamlessly in both controlled and uncontrolled modes.

### Uncontrolled State

Component manages its own state internally:

```tsx
export const Stepper = () => {
  const [value, setValue] = useState(0);
  return (
    <div>
      <p>{value}</p>
      <button onClick={() => setValue(value + 1)}>Increment</button>
    </div>
  );
};
```

**When to use:** Simple components, default behavior, internal state is sufficient.

### Controlled State

Parent component manages the state:

```tsx
type StepperProps = {
  value: number;
  setValue: (value: number) => void;
};

export const Stepper = ({ value, setValue }: StepperProps) => (
  <div>
    <p>{value}</p>
    <button onClick={() => setValue(value + 1)}>Increment</button>
  </div>
);
```

**When to use:** State coordination, external data sources, form validation, persistence.

### Merging Both Patterns

Use `@radix-ui/react-use-controllable-state` to support both:

```tsx
import { useControllableState } from "@radix-ui/react-use-controllable-state";

type StepperProps = {
  value?: number;
  defaultValue?: number;
  onValueChange?: (value: number) => void;
};

export const Stepper = ({
  value: controlledValue,
  defaultValue,
  onValueChange,
}: StepperProps) => {
  const [value, setValue] = useControllableState({
    prop: controlledValue,
    defaultProp: defaultValue,
    onChange: onValueChange,
  });

  return (
    <div>
      <p>{value}</p>
      <button onClick={() => setValue(value + 1)}>Increment</button>
    </div>
  );
};
```

**Usage:**

```tsx
// Uncontrolled
<Stepper defaultValue={0} />;

// Controlled
const [count, setCount] = useState(5);
<Stepper value={count} onValueChange={setCount} />;
```

### Prop Naming Conventions

| State Type | Value Prop | Default Prop      | Change Callback    |
| ---------- | ---------- | ----------------- | ------------------ |
| Generic    | `value`    | `defaultValue`    | `onValueChange`    |
| Boolean    | `checked`  | `defaultChecked`  | `onCheckedChange`  |
| Open/Close | `open`     | `defaultOpen`     | `onOpenChange`     |
| Selection  | `selected` | `defaultSelected` | `onSelectedChange` |

### Complete Example: Toggle

```tsx
import { useControllableState } from "@radix-ui/react-use-controllable-state";

type ToggleProps = {
  checked?: boolean;
  defaultChecked?: boolean;
  onCheckedChange?: (checked: boolean) => void;
  disabled?: boolean;
};

export const Toggle = ({
  checked: controlledChecked,
  defaultChecked,
  onCheckedChange,
  disabled,
}: ToggleProps) => {
  const [checked, setChecked] = useControllableState({
    prop: controlledChecked,
    defaultProp: defaultChecked ?? false,
    onChange: onCheckedChange,
  });

  return (
    <button
      type="button"
      role="switch"
      aria-checked={checked}
      disabled={disabled}
      onClick={() => !disabled && setChecked(!checked)}
    >
      {checked ? "On" : "Off"}
    </button>
  );
};
```

### Best Practices

**1. Always Make Props Optional:**

```tsx
// ✅ Supports both patterns
type Props = {
  value?: number;
  defaultValue?: number;
  onValueChange?: (value: number) => void;
};
```

**2. Provide Sensible Defaults:**

```tsx
const [value, setValue] = useControllableState({
  prop: controlledValue,
  defaultProp: defaultValue ?? 0,
  onChange: onValueChange,
});
```

**3. Handle onChange in Both Modes:**

The `onChange` callback should fire regardless of controlled/uncontrolled mode.

### Key Benefits

1. **Flexibility** - Works in both controlled and uncontrolled modes
2. **Developer Experience** - Simple API for simple cases, powerful for complex
3. **Consistency** - Matches patterns used by Radix UI and professional libraries
4. **Backward Compatibility** - Easy to migrate from uncontrolled to controlled

© maxtrigify · Apache-2.0 · maxtrigify/Otto

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

Каталог правил IDE →
react-state-management Seth Hobson Скилл react-state-management помогает выбрать и настроить управление состоянием в React: локальное, глобальное, серверное, URL и состояние форм. CX Codex +1 15 286установок state-machine jakubkrehel Скилл state-machine для Claude Code выводит состояния выбранного компонента на временную страницу с тестовыми данными и переключателем. Агент запускает его по явной просьбе. CX Codex +1 11 400установок principle-separate-before-serializing-shared-state backnotprop Скилл principle-separate-before-serializing-shared-state для Claude Code задаёт архитектурный принцип при параллельной записи. Направляет разделять файлы и ключи акторов вместо ввода блокировок. CX Codex +1 10 100установок compose-state-and-effects chrisbanes Скилл compose-state-and-effects помогает проектировать и проверять владение состоянием в Jetpack Compose. Он распределяет стейт по уровням и подбирает эффекты под их жизненный цикл. CX Codex +1 1 500установок ue-state-trees quodsoler Скилл ue-state-trees для Claude Code: работа с State Tree в Unreal Engine C++ — задачи, условия, evaluators, схемы, переходы и Mass-поведения. Покрывает написание и отладку деревьев состояний. CX Codex +1 1 400установок texture-state-animation RobLe3 Скилл texture-state-animation помогает продумать переходы между состояниями текстур в Blender так, чтобы не получить грубый кроссфейд целых картинок и дёргание текстур. CX Codex +1 1 300установок

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

Весь набор →
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звёзд репо as-child Правило as-child для Claude Code объединяет свойства и обработчики компонента с дочерним элементом без лишней DOM-обёртки. Подключается при создании составных React-компонентов и trigger-элементов. CX Codex +1 ★ 141звёзд репо documentation Правило documentation для Claude Code задаёт единый стандарт описания компонентов интерфейса. Ассистент оформляет справку со свойствами, примерами и требованиями доступности. CX Codex +1 ★ 141звёзд репо accessibility Правило accessibility для Claude Code задаёт стандарты доступности интерфейсов. Включается при верстке компонентов, форм и навигационных меню по WCAG. CX Codex +1 ★ 141звёзд репо polymorphism Правило polymorphism для Claude Code задаёт полиморфные React-компоненты с единым стилем и поведением. HTML-элемент меняется через проп as. 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звёзд репо

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

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