FormGroupApi | TanStack Form Español

Defined in: packages/form-core/src/FormGroupApi.ts:970

Type Parameters

TParentData

TParentData

TName

TName extends DeepKeys<TParentData>

TData

TData extends DeepValue<TParentData, TName>

TOnMount

TOnMount extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>

TOnChange

TOnChange extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>

TOnChangeAsync

TOnChangeAsync extends | undefined | FormGroupAsyncValidateOrFn<TParentData, TName, TData>

TOnBlur

TOnBlur extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>

TOnBlurAsync

TOnBlurAsync extends | undefined | FormGroupAsyncValidateOrFn<TParentData, TName, TData>

TOnSubmit

TOnSubmit extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>

TOnSubmitAsync

TOnSubmitAsync extends | undefined | FormGroupAsyncValidateOrFn<TParentData, TName, TData>

TOnDynamic

TOnDynamic extends undefined | FormGroupValidateOrFn<TParentData, TName, TData>

TOnDynamicAsync

TOnDynamicAsync extends | undefined | FormGroupAsyncValidateOrFn<TParentData, TName, TData>

TSubmitMeta

TSubmitMeta

TFormOnMount

TFormOnMount extends undefined | FormValidateOrFn<TParentData>

TFormOnChange

TFormOnChange extends undefined | FormValidateOrFn<TParentData>

TFormOnChangeAsync

TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>

TFormOnBlur

TFormOnBlur extends undefined | FormValidateOrFn<TParentData>

TFormOnBlurAsync

TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>

TFormOnSubmit

TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>

TFormOnSubmitAsync

TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>

TFormOnDynamic

TFormOnDynamic extends undefined | FormValidateOrFn<TParentData>

TFormOnDynamicAsync

TFormOnDynamicAsync extends undefined | FormAsyncValidateOrFn<TParentData>

TFormOnServer

TFormOnServer extends undefined | FormAsyncValidateOrFn<TParentData>

TParentSubmitMeta

TParentSubmitMeta

Constructors

Constructor

new FormGroupApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TSubmitMeta, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta>(opts): FormGroupApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TSubmitMeta, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta>;

Defined in: packages/form-core/src/FormGroupApi.ts:1217

Parameters

opts

FormGroupApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TSubmitMeta, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta>

Returns

FormGroupApi<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TSubmitMeta, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta>

Properties

form

form: FormApi<TParentData, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta>;

Defined in: packages/form-core/src/FormGroupApi.ts:1079

A reference to the form API instance.

Implementation of

FieldLikeAPI.form

name

name: TName;

Defined in: packages/form-core/src/FormGroupApi.ts:1108

The field name.

Implementation of

FieldLikeAPI.name

options

options: FormGroupApiOptions<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TSubmitMeta, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync, TFormOnServer, TParentSubmitMeta>;

Defined in: packages/form-core/src/FormGroupApi.ts:1112

The field options.

Implementation of

FieldLikeAPI.options

store

store: ReadonlyStore<FormGroupStoreState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync>>;

Defined in: packages/form-core/src/FormGroupApi.ts:1141

The field state store.

Implementation of

FieldLikeAPI.store

timeoutIds

timeoutIds: object;

Defined in: packages/form-core/src/FormGroupApi.ts:1199

formListeners

formListeners: Record<ListenerCause, ReturnType<typeof setTimeout> | null>;

listeners

listeners: Record<ListenerCause, ReturnType<typeof setTimeout> | null>;

validations

validations: Record<ValidationCause, ReturnType<typeof setTimeout> | null>;

Accessors

state

Get Signature

get state(): FormGroupStoreState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync>;

Defined in: packages/form-core/src/FormGroupApi.ts:1169

The current field state.

Returns

FormGroupStoreState<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync>

Methods

_handleSubmit()

_handleSubmit(submitMeta?): Promise<void>;

Defined in: packages/form-core/src/FormGroupApi.ts:2404

Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.

Parameters

submitMeta?

TSubmitMeta

Returns

Promise<void>

areRelatedFieldsValid()

areRelatedFieldsValid(): boolean;

Defined in: packages/form-core/src/FormGroupApi.ts:2293

Returns

boolean

clearFieldValues()

clearFieldValues<TField>(field): void;

Defined in: packages/form-core/src/FormGroupApi.ts:2274

Type Parameters

TField

TField extends string

Parameters

field

TField

Returns

void

Implementation of

FormLikeAPI.clearFieldValues

deleteField()

deleteField<TField>(field): void;

Defined in: packages/form-core/src/FormGroupApi.ts:2229

Type Parameters

TField

TField extends string

Parameters

field

TField

Returns

void

Implementation of

FormLikeAPI.deleteField

getFieldMeta()

getFieldMeta<TField>(field): AnyFieldLikeMeta | undefined;

Defined in: packages/form-core/src/FormGroupApi.ts:2209

Type Parameters

TField

TField extends string

Parameters

field

TField

Returns

AnyFieldLikeMeta | undefined

Implementation of

FormLikeAPI.getFieldMeta

getFieldValue()

getFieldValue<TField>(field): DeepValue<TParentData, TField>;

Defined in: packages/form-core/src/FormGroupApi.ts:2203

Type Parameters

TField

TField extends string

Parameters

field

TField

Returns

DeepValue<TParentData, TField>

Implementation of

FormLikeAPI.getFieldValue

getInfo()

getInfo(): FieldInfo<TParentData>;

Defined in: packages/form-core/src/FormGroupApi.ts:1636

Gets the field information object.

Returns

FieldInfo<TParentData>

Implementation of

FieldLikeAPI.getInfo

getMeta()

getMeta(): FormGroupMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync>;

Defined in: packages/form-core/src/FormGroupApi.ts:1600

Returns

FormGroupMeta<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync>

Implementation of

FieldLikeAPI.getMeta

handleSubmit()

Call Signature

handleSubmit(): Promise<void>;

Defined in: packages/form-core/src/FormGroupApi.ts:2395

Handles the form submission, performs validation, and calls the appropriate onSubmit or onSubmitInvalid callbacks.

Returns

Promise<void>

Implementation of

FormLikeAPI.handleSubmit

Call Signature

handleSubmit(submitMeta): Promise<void>;

Defined in: packages/form-core/src/FormGroupApi.ts:2396

Parameters

submitMeta

TSubmitMeta

Returns

Promise<void>

Implementation of

FormLikeAPI.handleSubmit

insertFieldValue()

insertFieldValue<TField>(
   field, 
   index, 
value): Promise<void>;

Defined in: packages/form-core/src/FormGroupApi.ts:2242

Type Parameters

TField

TField extends string

Parameters

field

TField

index

number

value

any

Returns

Promise<void>

Implementation of

FormLikeAPI.insertFieldValue

mount()

mount(): () => void;

Defined in: packages/form-core/src/FormGroupApi.ts:1447

Returns

(): void;

Returns

void

Implementation of

FieldLikeAPI.mount

moveFieldValues()

moveFieldValues<TField>(
   field, 
   fromIndex, 
   toIndex): void;

Defined in: packages/form-core/src/FormGroupApi.ts:2266

Type Parameters

TField

TField extends string

Parameters

field

TField

fromIndex

number

toIndex

number

Returns

void

Implementation of

FormLikeAPI.moveFieldValues

pushFieldValue()

pushFieldValue<TField>(field, value): void;

Defined in: packages/form-core/src/FormGroupApi.ts:2235

Type Parameters

TField

TField extends string

Parameters

field

TField

value

any

Returns

void

Implementation of

FormLikeAPI.pushFieldValue

removeFieldValue()

removeFieldValue<TField>(field, index): Promise<void>;

Defined in: packages/form-core/src/FormGroupApi.ts:2286

Type Parameters

TField

TField extends string

Parameters

field

TField

index

number

Returns

Promise<void>

Implementation of

FormLikeAPI.removeFieldValue

replaceFieldValue()

replaceFieldValue<TField>(
   field, 
   index, 
value): Promise<void>;

Defined in: packages/form-core/src/FormGroupApi.ts:2250

Type Parameters

TField

TField extends string

Parameters

field

TField

index

number

value

any

Returns

Promise<void>

Implementation of

FormLikeAPI.replaceFieldValue

resetField()

resetField<TField>(field): void;

Defined in: packages/form-core/src/FormGroupApi.ts:2280

Type Parameters

TField

TField extends string

Parameters

field

TField

Returns

void

Implementation of

FormLikeAPI.resetField

setFieldMeta()

setFieldMeta<TField>(field, updater): void;

Defined in: packages/form-core/src/FormGroupApi.ts:2215

Type Parameters

TField

TField extends string

Parameters

field

TField

updater

Updater<AnyFieldLikeMetaBase>

Returns

void

Implementation of

FormLikeAPI.setFieldMeta

setFieldValue()

setFieldValue<TField>(field, value): void;

Defined in: packages/form-core/src/FormGroupApi.ts:2222

Type Parameters

TField

TField extends string

Parameters

field

TField

value

any

Returns

void

Implementation of

FormLikeAPI.setFieldValue

setMeta()

setMeta(updater): void;

Defined in: packages/form-core/src/FormGroupApi.ts:1605

Sets the field metadata.

Parameters

updater

Updater<FieldLikeMetaBase<TParentData, TName, TData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TFormOnMount, TFormOnChange, TFormOnChangeAsync, TFormOnBlur, TFormOnBlurAsync, TFormOnSubmit, TFormOnSubmitAsync, TFormOnDynamic, TFormOnDynamicAsync>>

Returns

void

Implementation of

FieldLikeAPI.setMeta

setValue()

setValue(updater, options?): void;

Defined in: packages/form-core/src/FormGroupApi.ts:1584

Sets the field value and run the change validator.

Parameters

updater

Updater<TData>

options?

UpdateMetaOptions

Returns

void

Implementation of

FieldLikeAPI.setValue

swapFieldValues()

swapFieldValues<TField>(
   field, 
   index1, 
   index2): void;

Defined in: packages/form-core/src/FormGroupApi.ts:2258

Type Parameters

TField

TField extends string

Parameters

field

TField

index1

number

index2

number

Returns

void

Implementation of

FormLikeAPI.swapFieldValues

update()

update(opts): void;

Defined in: packages/form-core/src/FormGroupApi.ts:1356

Updates the field instance with new options.

Parameters

opts

Returns

void

validate()

validate(cause, opts?): unknown[] | Promise<unknown[]>;

Defined in: packages/form-core/src/FormGroupApi.ts:2302

Validates the form group and all related children.

Parameters

cause

ValidationCause

opts?

skipFormValidation?

boolean

skipRelatedFieldValidation?

boolean

Returns

unknown[] | Promise<unknown[]>

Implementation of

FieldLikeAPI.validate

validateAllFields()

validateAllFields(cause): Promise<unknown[]>;

Defined in: packages/form-core/src/FormGroupApi.ts:2158

Validates all fields according to the FIELD level validators. This will ignore FORM level validators, use form.validate({ValidationCause}) for a complete validation

Parameters

cause

ValidationCause

Returns

Promise<unknown[]>

Implementation of

FormLikeAPI.validateAllFields

validateArrayFieldsStartingFrom()

validateArrayFieldsStartingFrom<TField>(
   field, 
   index, 
cause): Promise<unknown[]>;

Defined in: packages/form-core/src/FormGroupApi.ts:2186

Type Parameters

TField

TField extends string

Parameters

field

TField

index

number

cause

ValidationCause

Returns

Promise<unknown[]>

Implementation of

FormLikeAPI.validateArrayFieldsStartingFrom

validateField()

validateField<TField>(field, cause): any[] | Promise<any[]>;

Defined in: packages/form-core/src/FormGroupApi.ts:2196

Type Parameters

TField

TField extends string

Parameters

field

TField

cause

ValidationCause

Returns

any[] | Promise<any[]>

Implementation of

FormLikeAPI.validateField