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

formoptions.md

176 lines4.5 KB

Interface: FormOptions<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>

Defined in: packages/form-core/src/FormApi.ts:237

An object representing the options for a form.

Type Parameters

• TFormData

• TOnMount extends undefined | FormValidateOrFn<TFormData>

• TOnChange extends undefined | FormValidateOrFn<TFormData>

• TOnChangeAsync extends undefined | FormAsyncValidateOrFn<TFormData>

• TOnBlur extends undefined | FormValidateOrFn<TFormData>

• TOnBlurAsync extends undefined | FormAsyncValidateOrFn<TFormData>

• TOnSubmit extends undefined | FormValidateOrFn<TFormData>

• TOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TFormData>

• TOnServer extends undefined | FormAsyncValidateOrFn<TFormData>

• TSubmitMeta = never

Properties

asyncAlways?

optional asyncAlways: boolean;

Defined in: packages/form-core/src/FormApi.ts:272

If true, always run async validation, even when sync validation has produced an error. Defaults to undefined.


asyncDebounceMs?

optional asyncDebounceMs: number;

Defined in: packages/form-core/src/FormApi.ts:276

Optional time in milliseconds if you want to introduce a delay before firing off an async action.


defaultState?

optional defaultState: Partial<FormState<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer>>;

Defined in: packages/form-core/src/FormApi.ts:256

The default state for the form.


defaultValues?

optional defaultValues: TFormData;

Defined in: packages/form-core/src/FormApi.ts:252

Set initial values for your form.


onSubmit()?

optional onSubmit: (props) => any;

Defined in: packages/form-core/src/FormApi.ts:299

A function to be called when the form is submitted, what should happen once the user submits a valid form returns any or a promise Promise<any>

Parameters

props
formApi

FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>

meta

TSubmitMeta

value

TFormData

Returns

any


onSubmitInvalid()?

optional onSubmitInvalid: (props) => void;

Defined in: packages/form-core/src/FormApi.ts:318

Specify an action for scenarios where the user tries to submit an invalid form.

Parameters

props
formApi

FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>

value

TFormData

Returns

void


onSubmitMeta?

optional onSubmitMeta: TSubmitMeta;

Defined in: packages/form-core/src/FormApi.ts:294

onSubmitMeta, the data passed from the handleSubmit handler, to the onSubmit function props


transform?

optional transform: FormTransform<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>;

Defined in: packages/form-core/src/FormApi.ts:333


validators?

optional validators: FormValidators<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync>;

Defined in: packages/form-core/src/FormApi.ts:280

A list of validators to pass to the form