FieldGroupApi

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

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

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>

TOnDynamic extends undefined | FormValidateOrFn<TFormData>

TOnDynamicAsync 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, TOnDynamic, TOnDynamicAsync, TOnServer, TSubmitMeta>(opts): FieldGroupApi<TFormData, TFieldGroupData, TFields, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TOnServer, TSubmitMeta>
new FieldGroupApi<TFormData, TFieldGroupData, TFields, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TOnServer, TSubmitMeta>(opts): FieldGroupApi<TFormData, TFieldGroupData, TFields, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TOnServer, TSubmitMeta>

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

Constructs a new FieldGroupApi instance with the given form options.

Parameters

opts

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

Returns

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

Properties

fieldsMap

ts
readonly fieldsMap: TFields;
readonly fieldsMap: TFields;

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


form

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

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

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:178

Accessors

state

Get Signature

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

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

Returns

FieldGroupState<TFieldGroupData>

Methods

clearFieldValues()

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

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

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:346

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:314

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:302

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:292

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:293

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:371

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:256

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:445

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:353

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:415

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:393

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:469

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:321

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:331

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:428

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:473

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:265

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:282

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