FormOptions

Interface: FormOptions<TFormData, TFormValidator>

An object representing the options for a form.

Type Parameters

TFormData

TFormValidator extends Validator<TFormData, unknown> | undefined = undefined

Properties

asyncAlways?

ts
optional asyncAlways: boolean;
optional asyncAlways: boolean;

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

Defined in

packages/form-core/src/FormApi.ts:152


asyncDebounceMs?

ts
optional asyncDebounceMs: number;
optional asyncDebounceMs: number;

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

Defined in

packages/form-core/src/FormApi.ts:156


defaultState?

ts
optional defaultState: Partial<FormState<TFormData>>;
optional defaultState: Partial<FormState<TFormData>>;

The default state for the form.

Defined in

packages/form-core/src/FormApi.ts:148


defaultValues?

ts
optional defaultValues: TFormData;
optional defaultValues: TFormData;

Set initial values for your form.

Defined in

packages/form-core/src/FormApi.ts:144


onSubmit()?

ts
optional onSubmit: (props) => any;
optional onSubmit: (props) => any;

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

props.formApi: FormApi<TFormData, TFormValidator>

props.value: TFormData

Returns

any

Defined in

packages/form-core/src/FormApi.ts:168


onSubmitInvalid()?

ts
optional onSubmitInvalid: (props) => void;
optional onSubmitInvalid: (props) => void;

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

Parameters

props

props.formApi: FormApi<TFormData, TFormValidator>

props.value: TFormData

Returns

void

Defined in

packages/form-core/src/FormApi.ts:175


transform?

ts
optional transform: FormTransform<TFormData, TFormValidator>;
optional transform: FormTransform<TFormData, TFormValidator>;

Defined in

packages/form-core/src/FormApi.ts:179


validatorAdapter?

ts
optional validatorAdapter: TFormValidator;
optional validatorAdapter: TFormValidator;

A validator adapter to support usage of extra validation types (IE: Zod, Yup, or Valibot usage)

Defined in

packages/form-core/src/FormApi.ts:160


validators?

ts
optional validators: FormValidators<TFormData, TFormValidator>;
optional validators: FormValidators<TFormData, TFormValidator>;

A list of validators to pass to the form

Defined in

packages/form-core/src/FormApi.ts:164

Subscribe to Bytes

Your weekly dose of JavaScript news. Delivered every Monday to over 100,000 devs, for free.

Bytes

No spam. Unsubscribe at any time.