FieldGroupApi

Class: FieldGroupApi<TFormData, TFieldGroupData, TFields, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>

Defined in: packages/form-core/src/FieldGroupApi.ts:104

Type Parameters

TFormData

TFieldGroupData

TFields extends | DeepKeysOfType<TFormData, TFieldGroupData | null | undefined> | FieldsMap<TFormData, TFieldGroupData>

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

Implements

  • FieldManipulator<TFieldGroupData, TSubmitMeta>

Constructors

new FieldGroupApi()

ts
new FieldGroupApi<TFormData, TFieldGroupData, TFields, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>(opts): FieldGroupApi<TFormData, TFieldGroupData, TFields, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>
new FieldGroupApi<TFormData, TFieldGroupData, TFields, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>(opts): FieldGroupApi<TFormData, TFieldGroupData, TFields, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>

Defined in: packages/form-core/src/FieldGroupApi.ts:175

Constructs a new FieldGroupApi instance with the given form options.

Parameters

opts

FieldGroupOptions<TFormData, TFieldGroupData, TFields, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>

Returns

FieldGroupApi<TFormData, TFieldGroupData, TFields, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>

Properties

fieldsMap

ts
readonly fieldsMap: TFields;
readonly fieldsMap: TFields;

Defined in: packages/form-core/src/FieldGroupApi.ts:137


form

ts
readonly form: FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>;
readonly form: FormApi<TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnServer, TSubmitMeta>;

Defined in: packages/form-core/src/FieldGroupApi.ts:124

The form that called this field group.


store

ts
store: Derived<FieldGroupState<TFieldGroupData>>;
store: Derived<FieldGroupState<TFieldGroupData>>;

Defined in: packages/form-core/src/FieldGroupApi.ts:166

Accessors

state

Get Signature

ts
get state(): FieldGroupState<TFieldGroupData>
get state(): FieldGroupState<TFieldGroupData>

Defined in: packages/form-core/src/FieldGroupApi.ts:168

Returns

FieldGroupState<TFieldGroupData>

Methods

clearFieldValues()

ts
clearFieldValues<TField>(field, opts?): void
clearFieldValues<TField>(field, opts?): void

Defined in: packages/form-core/src/FieldGroupApi.ts:445

Type Parameters

TField extends string

Parameters

field

TField

opts?

UpdateMetaOptions

Returns

void

Implementation of

ts
FieldManipulator.clearFieldValues
FieldManipulator.clearFieldValues

deleteField()

ts
deleteField<TField>(field): void
deleteField<TField>(field): void

Defined in: packages/form-core/src/FieldGroupApi.ts:332

Delete a field and its subfields.

Type Parameters

TField extends string

Parameters

field

TField

Returns

void

Implementation of

ts
FieldManipulator.deleteField
FieldManipulator.deleteField

getFieldMeta()

ts
getFieldMeta<TField>(field): undefined | AnyFieldMeta
getFieldMeta<TField>(field): undefined | AnyFieldMeta

Defined in: packages/form-core/src/FieldGroupApi.ts:300

Gets the metadata of the specified field.

Type Parameters

TField extends string

Parameters

field

TField

Returns

undefined | AnyFieldMeta

Implementation of

ts
FieldManipulator.getFieldMeta
FieldManipulator.getFieldMeta

getFieldValue()

ts
getFieldValue<TField>(field): DeepValue<TFieldGroupData, TField>
getFieldValue<TField>(field): DeepValue<TFieldGroupData, TField>

Defined in: packages/form-core/src/FieldGroupApi.ts:288

Gets the value of the specified field.

Type Parameters

TField extends string

Parameters

field

TField

Returns

DeepValue<TFieldGroupData, TField>

Implementation of

ts
FieldManipulator.getFieldValue
FieldManipulator.getFieldValue

handleSubmit()

Call Signature

ts
handleSubmit(): Promise<void>
handleSubmit(): Promise<void>

Defined in: packages/form-core/src/FieldGroupApi.ts:278

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

Returns

Promise<void>

Implementation of
ts
FieldManipulator.handleSubmit
FieldManipulator.handleSubmit

Call Signature

ts
handleSubmit(submitMeta): Promise<void>
handleSubmit(submitMeta): Promise<void>

Defined in: packages/form-core/src/FieldGroupApi.ts:279

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

Parameters
submitMeta

TSubmitMeta

Returns

Promise<void>

Implementation of
ts
FieldManipulator.handleSubmit
FieldManipulator.handleSubmit

insertFieldValue()

ts
insertFieldValue<TField>(
   field, 
   index, 
   value, 
opts?): Promise<void>
insertFieldValue<TField>(
   field, 
   index, 
   value, 
opts?): Promise<void>

Defined in: packages/form-core/src/FieldGroupApi.ts:357

Insert a value into an array field at the specified index.

Type Parameters

TField extends string

Parameters

field

TField

index

number

value

DeepValue<TFieldGroupData, TField> extends any[] ? any[] & DeepValue<TFieldGroupData, TField>[number] : never

opts?

UpdateMetaOptions

Returns

Promise<void>

Implementation of

ts
FieldManipulator.insertFieldValue
FieldManipulator.insertFieldValue

mount()

ts
mount(): () => void
mount(): () => void

Defined in: packages/form-core/src/FieldGroupApi.ts:242

Mounts the field group instance to listen to value changes.

Returns

Function

Returns

void


moveFieldValues()

ts
moveFieldValues<TField>(
   field, 
   index1, 
   index2, 
   opts?): void
moveFieldValues<TField>(
   field, 
   index1, 
   index2, 
   opts?): void

Defined in: packages/form-core/src/FieldGroupApi.ts:431

Moves the value at the first specified index to the second specified index within an array field.

Type Parameters

TField extends string

Parameters

field

TField

index1

number

index2

number

opts?

UpdateMetaOptions

Returns

void

Implementation of

ts
FieldManipulator.moveFieldValues
FieldManipulator.moveFieldValues

pushFieldValue()

ts
pushFieldValue<TField>(
   field, 
   value, 
   opts?): void
pushFieldValue<TField>(
   field, 
   value, 
   opts?): void

Defined in: packages/form-core/src/FieldGroupApi.ts:339

Pushes a value into an array field.

Type Parameters

TField extends string

Parameters

field

TField

value

DeepValue<TFieldGroupData, TField> extends any[] ? any[] & DeepValue<TFieldGroupData, TField>[number] : never

opts?

UpdateMetaOptions

Returns

void

Implementation of

ts
FieldManipulator.pushFieldValue
FieldManipulator.pushFieldValue

removeFieldValue()

ts
removeFieldValue<TField>(
   field, 
   index, 
opts?): Promise<void>
removeFieldValue<TField>(
   field, 
   index, 
opts?): Promise<void>

Defined in: packages/form-core/src/FieldGroupApi.ts:401

Removes a value from an array field at the specified index.

Type Parameters

TField extends string

Parameters

field

TField

index

number

opts?

UpdateMetaOptions

Returns

Promise<void>

Implementation of

ts
FieldManipulator.removeFieldValue
FieldManipulator.removeFieldValue

replaceFieldValue()

ts
replaceFieldValue<TField>(
   field, 
   index, 
   value, 
opts?): Promise<void>
replaceFieldValue<TField>(
   field, 
   index, 
   value, 
opts?): Promise<void>

Defined in: packages/form-core/src/FieldGroupApi.ts:379

Replaces a value into an array field at the specified index.

Type Parameters

TField extends string

Parameters

field

TField

index

number

value

DeepValue<TFieldGroupData, TField> extends any[] ? any[] & DeepValue<TFieldGroupData, TField>[number] : never

opts?

UpdateMetaOptions

Returns

Promise<void>

Implementation of

ts
FieldManipulator.replaceFieldValue
FieldManipulator.replaceFieldValue

resetField()

ts
resetField<TField>(field): void
resetField<TField>(field): void

Defined in: packages/form-core/src/FieldGroupApi.ts:455

Resets the field value and meta to default state

Type Parameters

TField extends string

Parameters

field

TField

Returns

void

Implementation of

ts
FieldManipulator.resetField
FieldManipulator.resetField

setFieldMeta()

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

Defined in: packages/form-core/src/FieldGroupApi.ts:307

Updates the metadata of the specified field.

Type Parameters

TField extends string

Parameters

field

TField

updater

Updater<AnyFieldMetaBase>

Returns

void

Implementation of

ts
FieldManipulator.setFieldMeta
FieldManipulator.setFieldMeta

setFieldValue()

ts
setFieldValue<TField>(
   field, 
   updater, 
   opts?): void
setFieldValue<TField>(
   field, 
   updater, 
   opts?): void

Defined in: packages/form-core/src/FieldGroupApi.ts:317

Sets the value of the specified field and optionally updates the touched state.

Type Parameters

TField extends string

Parameters

field

TField

updater

Updater<DeepValue<TFieldGroupData, TField>>

opts?

UpdateMetaOptions

Returns

void

Implementation of

ts
FieldManipulator.setFieldValue
FieldManipulator.setFieldValue

swapFieldValues()

ts
swapFieldValues<TField>(
   field, 
   index1, 
   index2, 
   opts?): void
swapFieldValues<TField>(
   field, 
   index1, 
   index2, 
   opts?): void

Defined in: packages/form-core/src/FieldGroupApi.ts:414

Swaps the values at the specified indices within an array field.

Type Parameters

TField extends string

Parameters

field

TField

index1

number

index2

number

opts?

UpdateMetaOptions

Returns

void

Implementation of

ts
FieldManipulator.swapFieldValues
FieldManipulator.swapFieldValues

validateAllFields()

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

Defined in: packages/form-core/src/FieldGroupApi.ts:459

Parameters

cause

ValidationCause

Returns

Promise<unknown[]>

Implementation of

ts
FieldManipulator.validateAllFields
FieldManipulator.validateAllFields

validateArrayFieldsStartingFrom()

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

Defined in: packages/form-core/src/FieldGroupApi.ts:251

Validates the children of a specified array in the form starting from a given index until the end using the correct handlers for a given validation type.

Type Parameters

TField extends string

Parameters

field

TField

index

number

cause

ValidationCause

Returns

Promise<unknown[]>

Implementation of

ts
FieldManipulator.validateArrayFieldsStartingFrom
FieldManipulator.validateArrayFieldsStartingFrom

validateField()

ts
validateField<TField>(field, cause): unknown[] | Promise<unknown[]>
validateField<TField>(field, cause): unknown[] | Promise<unknown[]>

Defined in: packages/form-core/src/FieldGroupApi.ts:268

Validates a specified field in the form using the correct handlers for a given validation type.

Type Parameters

TField extends string

Parameters

field

TField

cause

ValidationCause

Returns

unknown[] | Promise<unknown[]>

Implementation of

ts
FieldManipulator.validateField
FieldManipulator.validateField
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.