@angular/forms/signals

submit

function

API

function submit<TModel>(
  form: FieldTree<TModel>,
  options?: NoInfer<FormSubmitOptions<unknown, TModel>> | undefined,
): Promise<boolean>;
function submit<TModel>(
  form: FieldTree<TModel>,
  action: NoInfer<
    (
      field: FieldTree<TModel, string | number>,
      detail: {
        root: FieldTree<unknown, string | number>;
        submitted: FieldTree<TModel, string | number>;
      },
    ) => Promise<TreeValidationResult<WithOptionalFieldTree>>
  >,
): Promise<boolean>;

function submit<TModel>(form: FieldTree<TModel>, options?: NoInfer<FormSubmitOptions<unknown, TModel>> | undefined): Promise<boolean>;

Submits a given FieldTree using the given action function and applies any submission errors resulting from the action to the field. Submission errors returned by the action will be integrated into the field as a ValidationError on the sub-field indicated by the fieldTree property of the submission error.

Concurrent submissions are prohibited. If a submit is already in progress for the given field or any of its parents, subsequent calls to submit will return false immediately without running the action.

@paramformFieldTree<TModel>

The field to submit.

@paramoptionsNoInfer<FormSubmitOptions<unknown, TModel>> | undefined

Options for the submission.

@returnsPromise<boolean>

function submit<TModel>(form: FieldTree<TModel>, action: NoInfer<(field: FieldTree<TModel, string | number>, detail: { root: FieldTree<unknown, string | number>; submitted: FieldTree<TModel, string | number>; }) => Promise<TreeValidationResult<WithOptionalFieldTree>>>): Promise<boolean>;

@paramformFieldTree<TModel>

@paramaction

NoInfer<(field: FieldTree<TModel, string | number>, detail: { root: FieldTree<unknown, string | number>; submitted: FieldTree<TModel, string | number>; }) => Promise<TreeValidationResult<WithOptionalFieldTree>>>

@returnsPromise<boolean>