Перейти к основному содержимому

Обзор

@reformer/cdk — набор headless-примитивов поверх @reformer/core. Компоненты не несут ни разметки-обёрток, ни стилей: вы получаете состояние и поведение через compound-компоненты, render-props (children как функция) и хуки, а внешний вид полностью пишете сами. Состояние разделяется через React Context, всё типизировано и поддерживает tree-shaking.

Такой подход даёт полную свободу дизайна и доступность (a11y) из коробки. Если готовые стилизованные версии нужны сразу — используйте @reformer/ui-kit, который построен поверх cdk.

Установка​

npm install @reformer/cdk @reformer/core

Peer-зависимости: @reformer/core, react, react-dom — npm 7+ установит их автоматически. Собственных стилей у пакета нет, подключать CSS не требуется.

Компоненты​

  • FormArray — динамические add/remove/reorder массивы. Части: FormArray, FormArrayList, FormArrayAddButton, FormArrayRemoveButton, FormArrayEmpty, FormArrayCount, FormArrayItemIndex; хук useFormArray.
  • FormWizard — многошаговый визард с пошаговой валидацией. Части: FormWizard, FormWizardStep, FormWizardIndicator, FormWizardActions, FormWizardProgress; хук useFormWizard.
  • FormField — доступная анатомия поля (label/control/error/description с проброшенными id и aria). Части: FormField.Root, FormField.Label, FormField.Control, FormField.Error, FormField.Description; хук useFormField.
  • AsyncBoundary — состояния загрузки данных (loading / error / ready) для async-UI вокруг формы.
  • FileUpload — выбор и загрузка файлов. Части: FileUpload.Root, FileUpload.Trigger, FileUpload.Dropzone, FileUpload.Item* (preview, name, size, progress, delete).
  • Валидация/i18n — ValidationMessagesProvider, createMessageResolver, defaultErrorResolver.

Импорт​

// Всё сразу
import { FormArray, FormField, FormWizard } from '@reformer/cdk';

// Tree-shaking (рекомендуется)
import { FormArray, useFormArray } from '@reformer/cdk/form-array';
import { FormField, useFormField } from '@reformer/cdk/form-field';
import { FormWizard, useFormWizard } from '@reformer/cdk/form-wizard';
import { AsyncBoundary } from '@reformer/cdk/async-boundary';
import { FileUpload } from '@reformer/cdk/file-upload';

Быстрый пример​

Форма и модель создаются через M1 API @reformer/core, а cdk отвечает только за поведение и анатомию:

import { createModel, createForm } from '@reformer/core';
import { FormArray } from '@reformer/cdk/form-array';

const model = createModel({
  items: [{ name: '' }],
});

const form = createForm({ model, schema });

<FormArray.Root control={form.items}>
  <FormArray.Empty>
    <p>Пока нет элементов</p>
  </FormArray.Empty>

  <FormArray.List>
    {({ control, index, remove }) => (
      <div>
        <span>Элемент #{index + 1}</span>
        <ItemForm control={control} />
        <button onClick={remove}>Удалить</button>
      </div>
    )}
  </FormArray.List>

  <FormArray.AddButton>Добавить</FormArray.AddButton>
</FormArray.Root>;

Каждый элемент разметки — ваш: cdk не навязывает ни тегов, ни классов, только прокидывает состояние и обработчики через render-props.

Дальше​