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

ReFormer

Реактивная библиотека форм на сигналах

Модель на сигналах — источник истины. Одна схема связывает поля, валидацию и реактивные behaviors. Рендерите вручную, из схемы или из JSON.

Форма за минуту

import { createForm, type FormModel } from '@reformer/core';
import { useFormBundle } from '@reformer/core/react';
import { defineValidation, validate } from '@reformer/core/validation';
import { required, email } from '@reformer/core/validators';
import { FormField, Input, Button } from '@reformer/ui-kit';

type Contact = { email: string };

// 1. Схема — привязка поля к сигналу модели + компонент (без валидаторов)
const schema = (model: FormModel<Contact>) => ({
children: [
{ model: model.$.email, component: Input, componentProps: { label: 'Email', type: 'email' } },
],
});

// 2. Валидация — отдельный слой
const validation = defineValidation<Contact>(({ model }) => {
validate(model.$.email, [required(), email()]);
});

function ContactForm() {
// 3. Сборка один раз: модель из initial, узлы формы поверх её сигналов, правила
const bundle = useFormBundle(() =>
createForm<Contact>({ initial: { email: '' }, schema, validation })
);

// 4. Отправка — один прогон правил; при замечаниях обработчик не вызывается, поля подсвечены
const onSubmit = (event) => {
event.preventDefault();
void bundle.submission.submit((values) => console.log(values));
};

// 5. Тонкий JSX — FormField делает всю работу
return (
<form onSubmit={onSubmit}>
<FormField control={bundle.form.email} />
<Button type="submit">Отправить</Button>
</form>
);
}
⚡

Реактивность по умолчанию

Построено на Preact Signals для точечной реактивности. Перерисовываются только компоненты, использующие изменённые значения.

🛡️

Типобезопасные формы

Полная поддержка TypeScript с автоматическим выводом типов. Ловите ошибки на этапе компиляции, а не в рантайме.

✅

Декларативная валидация

14 встроенных валидаторов, асинхронная валидация и простое создание кастомных валидаторов. Определите правила один раз — применяйте везде.

🔄

Умные поведения

Вычисляемые поля, условная видимость, синхронизация полей. Сложная логика форм стала простой.

📦

Вложенные структуры

Поддержка глубоко вложенных объектов и динамических массивов. Создавайте любую структуру форм.

🔌

Фреймворк-агностик

Ядро работает где угодно. React-биндинги включены, поддержка других фреймворков скоро.

🤖

AI-Friendly

Хорошо документированный API с понятными паттернами. ИИ-ассистенты легко понимают и генерируют код с ReFormer.