Skip to content
Source
Sign inSign up
TanStack/form
Open History to see the last commit

FormGroupOptions.md

118 lines2.5 KB

Defined in: FormGroupApi/FormGroupApi.public.ts:118

Type Parameters

TFormData

TFormData

TGroupName

TGroupName

TGroupValue

TGroupValue

TGroupValidators

TGroupValidators extends FormGroupValidators<TGroupValue>

TFormErrorTypes

TFormErrorTypes extends FormErrorTypes

Properties

form

form: FormApi<TFormData, TFormErrorTypes>;

Defined in: FormGroupApi/FormGroupApi.public.ts:125


name

name: TGroupName;

Defined in: FormGroupApi/FormGroupApi.public.ts:126


onSubmit?

optional onSubmit?: FormGroupSubmitFn<TFormData, TGroupName, TGroupValue, TGroupValidators, TFormErrorTypes>;

Defined in: FormGroupApi/FormGroupApi.public.ts:142

Called after group submission validation succeeds. The callback is awaited before submission finishes.

Example

{
  // ...
  onSubmit: () => {
    setStep(step => step + 1)
  },
}

onSubmitInvalid?

optional onSubmitInvalid?: (context) => void | Promise<void>;

Defined in: FormGroupApi/FormGroupApi.public.ts:165

Called when group validation fails or validation or submission throws. The callback is awaited before submission finishes.

Parameters

context

FormGroupSubmitInvalidContext<TFormData, TGroupName, TGroupValue, ToFormGroupErrorTypes<NoInfer<TGroupValidators>>, TFormErrorTypes>

Returns

void | Promise<void>

Example

{
  // ...
  onSubmitInvalid: ({ groupApi }) => {
    document
      .querySelector<HTMLElement>('[aria-invalid="true"]')
      ?.focus()
  },
}

validators?

optional validators?: TGroupValidators;

Defined in: FormGroupApi/FormGroupApi.public.ts:127