📖 Справочник API

`createForm(initialValues, rulesBuilder, options?)`

Создает реактивную форму с валидацией.

Параметры:

initialValues - Начальные значения формы (поддерживает вывод типов)
rulesBuilder - Функция-строитель правил (r, define) => define({...}) или реактивный computed computed(() => { const r = createRules(); return {...} }) для i18n
options - Дополнительные настройки

Настройки:

onSubmit? - Обработчик отправки формы
onClear? - Обработчик очистки формы

Возвращает: Экземпляр формы с реактивными свойствами и методами

Поддерживаемые возможности:

Поддержка вложенных путей типа 'contacts.0.email'
Методы arrayPath() и objectPath() для типобезопасного построения путей
Управление массивами: addArrayItem(), removeArrayItem(), toggleArrayItem()
Автоматическая оптимизация в зависимости от структуры данных

Свойства и методы формы

Реактивное состояние

Свойство	Тип	Описание
`values`	`Ref<T>`	Текущие значения формы (реактивный ref)
`val`	`T`	Геттер для удобного доступа к значениям (в script)
`errors`	`Ref<Record<string, string[]>>`	Ошибки валидации по полям
`touched`	`Ref<Record<string, boolean>>`	Состояние "тронутости" полей
`dirty`	`Ref<Record<string, boolean>>`	Измененные поля
`isValidating`	`Ref<Record<string, boolean>>`	Поля в процессе валидации
`isSubmitting`	`Ref<boolean>`	Статус отправки формы
`isValid`	`ComputedRef<boolean>`	Валидность всей формы
`isDirty`	`ComputedRef<boolean>`	Наличие несохраненных изменений
`hasAnyErrors`	`ComputedRef<boolean>`	Наличие ошибок в форме
`touchedFields`	`ComputedRef<string[]>`	Список "тронутых" полей
`dirtyFields`	`ComputedRef<string[]>`	Список измененных полей

Методы валидации

Метод	Описание
`setRules(rules)`	Установить правила валидации
`validateField(name)`	Валидировать поле (обычное или вложенное)
`validateForm()`	Валидировать всю форму
`submit()`	Отправить форму после валидации
`touch(field)`	Отметить поле как "тронутое" (обычное или вложенное)

Управление состоянием

Метод	Описание
`setValues(values)`	Обновить значения полей
`getValues()`	Получить копию текущих значений
`clear(useInitial?)`	Очистить форму
`reset(newValues?)`	Сбросить форму к начальным значениям
`resetState()`	Сбросить состояние валидации
`setErrors(errors)`	Установить ошибки для полей
`resetErrors()`	Очистить все ошибки

Проверка состояния полей

Унифицированные методы (работают с обычными и вложенными полями):

Метод	Возврат	Описание
`hasError(field)`	`boolean`	Есть ли ошибки в поле
`error(field)`	`string \| null`	Первая ошибка поля
`allErrors(field)`	`string[]`	Все ошибки поля
`isTouched(field)`	`boolean`	Было ли поле "тронуто"
`validating(field)`	`boolean`	Валидируется ли поле
`isFieldDirty(field)`	`boolean`	Изменено ли поле
`getFieldStatus(field)`	`FieldStatus`	Полная информация о состоянии поля

Примеры использования:

typescript

// Обычные поля
form.hasError('email')
form.error('name')

// Вложенные пути
form.hasError('contacts.0.email')
form.error('address.street')

// С автодополнением через helper'ы
form.hasError(form.arrayPath('contacts', 0, 'email'))
form.error(form.objectPath('address', 'street'))

Работа с вложенными структурами

Метод	Описание
`addArrayItem(arrayPath, item)`	Добавить элемент в массив
`removeArrayItem(arrayPath, index)`	Удалить элемент из массива
`toggleArrayItem(arrayPath, item)`	Переключить элемент в массиве (добавить/удалить)
`arrayIncludes(arrayPath, item)`	Проверить содержится ли элемент в массиве
`arrayPath(arrayField, index, property)`	Построить типобезопасный путь к элементу массива
`objectPath(objectField, property)`	Построить типобезопасный путь к свойству объекта

Файловые утилиты

Свойство	Описание
`file.{fieldName}.files`	`ComputedRef<File[]>` - Список файлов
`file.{fieldName}.fileInfo`	`ComputedRef<FileInfo[]>` - Информация о файлах
`file.{fieldName}.handler`	`(event: Event) => void` - Обработчик выбора файлов
`file.{fieldName}.clear`	`() => void` - Очистить выбранные файлы и DOM input

Note: Helpers создаются лениво при первом обращении. Для множественного выбора установите multiple на <input type="file"> — библиотека определит это автоматически по событию ввода.

Важно: Метод clear() полностью очищает файловые поля - как значение в форме, так и визуальное отображение в DOM input элементе. Это предотвращает ситуацию, когда после clear() файл исчезает из формы, но остается отображаться в input.

Продвинутые методы

Метод	Описание
`clearCache(field?)`	Очистить кэш валидации (поля или весь кэш)
`dispose()`	Остановить watchers и очистить ресурсы (авто при unmount)

📖 Справочник API ​

createForm(initialValues, rulesBuilder, options?) ​

Свойства и методы формы ​

Реактивное состояние ​

Методы валидации ​

Управление состоянием ​

Проверка состояния полей ​

Работа с вложенными структурами ​

Файловые утилиты ​

Продвинутые методы ​