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

FormBundle

Defined in: form/form-bundle.ts:91

Результат createForm: модель, форма, часть для рендерера и уровень формы (FormLevel) — validate(), validateStep(id), поток шагов и отправка submission.submit(handler).

Extends​

Type Parameters​

T​

T

Форма данных модели.

Methods​

dispose()​

dispose(): void;

Defined in: form/form-bundle.ts:102

Снять сборку: поведение формы, подписки нод, живую проверку; идущие проверки — полная, шага, отправки — получают cancelled. Значения модели остаются. Идемпотентно.

Владелец сборки — тот, кто вызвал createForm: вне React (тесты, сервер, своя оболочка) снимайте её этим вызовом, когда форма больше не нужна.

Returns​

void

Overrides​

FormLevel.dispose

validate()​

validate(): Promise<ValidationResult>;

Defined in: form/form-level.ts:109

Проверить всю форму и показать замечания. Поля выключенных нод (enableWhen, disable()) не учитываются — статус совпадает с valid формы.

Правила читают модель в момент вызова. Исключение — вызов в одном тике со сборкой формы или правкой поля: поведение ещё пишет отложенно (колбэк onChange, сброс resetOnDisable), и проверка сначала дожидается этих записей; validating поднят сразу. Так же ведут себя validateStep и отправка.

Попыткой отправки проверка не считается: стратегия afterFirstSubmit остаётся в тихой фазе.

Returns​

Promise<ValidationResult>

Inherited from​

FormLevel.validate

validateStep()​

validateStep(stepId): Promise<ValidationResult>;

Defined in: form/form-level.ts:116

Проверить шаг потока (без выключенных полей); неизвестный шаг — исключение.

Это отчёт о шаге, как validate — о форме. Переход делает flow.next(): он сверяет модель и не переходит, если её изменили, пока шла проверка шага.

Parameters​

stepId​

string

Returns​

Promise<ValidationResult>

Inherited from​

FormLevel.validateStep

Properties​

flow​

readonly flow: FormFlow | undefined;

Defined in: form/form-level.ts:88

Поток шагов; без flow в конфиге — undefined.

Inherited from​

FormLevel.flow

form​

readonly form: FormGroup<T>;

Defined in: form/form-bundle.ts:93

model​

readonly model: FormModel<T>;

Defined in: form/form-bundle.ts:92

render​

readonly render: FormRender;

Defined in: form/form-bundle.ts:94

submission​

readonly submission: FormSubmission<T>;

Defined in: form/form-level.ts:97

Отправка: submission.submit(handler) — один прогон всех правил и обработчик со значениями, которые они видели; submission.submitting — идёт ли обработчик.

Inherited from​

FormLevel.submission

validating​

readonly validating: ReadonlySignal<boolean>;

Defined in: form/form-level.ts:90

Идёт ли проверка: полная или шага.

Inherited from​

FormLevel.validating

validation​

readonly validation: FormValidationState<T> | undefined;

Defined in: form/form-level.ts:92

Правила и контроллер живой проверки; без правил — undefined.

Inherited from​

FormLevel.validation