@@ -7,7 +7,7 @@ title: FormState
7
7
8
8
# Interface: FormState\< TFormData, TOnMount, TOnChange, TOnChangeAsync, TOnBlur, TOnBlurAsync, TOnSubmit, TOnSubmitAsync, TOnDynamic, TOnDynamicAsync, TOnServer\>
9
9
10
- Defined in: [ packages/form-core/src/FormApi.ts:711 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L711 )
10
+ Defined in: [ packages/form-core/src/FormApi.ts:715 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L715 )
11
11
12
12
An object representing the current state of the form.
13
13
@@ -47,7 +47,7 @@ An object representing the current state of the form.
47
47
optional _force_re_eval : boolean ;
48
48
```
49
49
50
- Defined in: [ packages/form-core/src/FormApi.ts:630 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L630 )
50
+ Defined in: [ packages/form-core/src/FormApi.ts:634 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L634 )
51
51
52
52
@private , used to force a re-evaluation of the form state when options change
53
53
@@ -65,7 +65,7 @@ BaseFormState._force_re_eval
65
65
canSubmit : boolean ;
66
66
```
67
67
68
- Defined in: [ packages/form-core/src/FormApi.ts:704 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L704 )
68
+ Defined in: [ packages/form-core/src/FormApi.ts:708 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L708 )
69
69
70
70
A boolean indicating if the form can be submitted based on its current state.
71
71
@@ -83,7 +83,7 @@ DerivedFormState.canSubmit
83
83
errorMap : ValidationErrorMap < UnwrapFormValidateOrFn < TOnMount > , UnwrapFormValidateOrFn < TOnChange > , UnwrapFormAsyncValidateOrFn < TOnChangeAsync > , UnwrapFormValidateOrFn < TOnBlur > , UnwrapFormAsyncValidateOrFn < TOnBlurAsync > , UnwrapFormValidateOrFn < TOnSubmit > , UnwrapFormAsyncValidateOrFn < TOnSubmitAsync > , UnwrapFormValidateOrFn < TOnDynamic > , UnwrapFormAsyncValidateOrFn < TOnDynamicAsync > , UnwrapFormAsyncValidateOrFn < TOnServer >> ;
84
84
```
85
85
86
- Defined in: [ packages/form-core/src/FormApi.ts:574 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L574 )
86
+ Defined in: [ packages/form-core/src/FormApi.ts:578 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L578 )
87
87
88
88
The error map for the form itself.
89
89
@@ -111,7 +111,7 @@ errors: (
111
111
| UnwrapFormAsyncValidateOrFn < TOnServer > )[];
112
112
```
113
113
114
- Defined in: [ packages/form-core/src/FormApi.ts:657 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L657 )
114
+ Defined in: [ packages/form-core/src/FormApi.ts:661 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L661 )
115
115
116
116
The error array for the form itself.
117
117
@@ -129,7 +129,7 @@ DerivedFormState.errors
129
129
fieldMeta : Record < DeepKeys < TFormData > , AnyFieldMeta > ;
130
130
```
131
131
132
- Defined in: [ packages/form-core/src/FormApi.ts:708 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L708 )
132
+ Defined in: [ packages/form-core/src/FormApi.ts:712 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L712 )
133
133
134
134
A record of field metadata for each field in the form.
135
135
@@ -147,7 +147,7 @@ DerivedFormState.fieldMeta
147
147
fieldMetaBase : Record < DeepKeys < TFormData > , AnyFieldMetaBase > ;
148
148
```
149
149
150
- Defined in: [ packages/form-core/src/FormApi.ts:593 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L593 )
150
+ Defined in: [ packages/form-core/src/FormApi.ts:597 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L597 )
151
151
152
152
A record of field metadata for each field in the form, not including the derived properties, like ` errors ` and such
153
153
@@ -165,7 +165,7 @@ BaseFormState.fieldMetaBase
165
165
isBlurred : boolean ;
166
166
```
167
167
168
- Defined in: [ packages/form-core/src/FormApi.ts:684 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L684 )
168
+ Defined in: [ packages/form-core/src/FormApi.ts:688 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L688 )
169
169
170
170
A boolean indicating if any of the form fields have been blurred.
171
171
@@ -183,7 +183,7 @@ DerivedFormState.isBlurred
183
183
isDefaultValue : boolean ;
184
184
```
185
185
186
- Defined in: [ packages/form-core/src/FormApi.ts:696 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L696 )
186
+ Defined in: [ packages/form-core/src/FormApi.ts:700 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L700 )
187
187
188
188
A boolean indicating if all of the form's fields are the same as default values.
189
189
@@ -201,7 +201,7 @@ DerivedFormState.isDefaultValue
201
201
isDirty : boolean ;
202
202
```
203
203
204
- Defined in: [ packages/form-core/src/FormApi.ts:688 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L688 )
204
+ Defined in: [ packages/form-core/src/FormApi.ts:692 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L692 )
205
205
206
206
A boolean indicating if any of the form's fields' values have been modified by the user. Evaluates ` true ` if the user have modified at least one of the fields. Opposite of ` isPristine ` .
207
207
@@ -219,7 +219,7 @@ DerivedFormState.isDirty
219
219
isFieldsValid : boolean ;
220
220
```
221
221
222
- Defined in: [ packages/form-core/src/FormApi.ts:676 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L676 )
222
+ Defined in: [ packages/form-core/src/FormApi.ts:680 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L680 )
223
223
224
224
A boolean indicating if all the form fields are valid. Evaluates ` true ` if there are no field errors.
225
225
@@ -237,7 +237,7 @@ DerivedFormState.isFieldsValid
237
237
isFieldsValidating : boolean ;
238
238
```
239
239
240
- Defined in: [ packages/form-core/src/FormApi.ts:672 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L672 )
240
+ Defined in: [ packages/form-core/src/FormApi.ts:676 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L676 )
241
241
242
242
A boolean indicating if any of the form fields are currently validating.
243
243
@@ -255,7 +255,7 @@ DerivedFormState.isFieldsValidating
255
255
isFormValid : boolean ;
256
256
```
257
257
258
- Defined in: [ packages/form-core/src/FormApi.ts:653 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L653 )
258
+ Defined in: [ packages/form-core/src/FormApi.ts:657 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L657 )
259
259
260
260
A boolean indicating if the form is valid.
261
261
@@ -273,7 +273,7 @@ DerivedFormState.isFormValid
273
273
isFormValidating : boolean ;
274
274
```
275
275
276
- Defined in: [ packages/form-core/src/FormApi.ts:649 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L649 )
276
+ Defined in: [ packages/form-core/src/FormApi.ts:653 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L653 )
277
277
278
278
A boolean indicating if the form is currently validating.
279
279
@@ -291,7 +291,7 @@ DerivedFormState.isFormValidating
291
291
isPristine : boolean ;
292
292
```
293
293
294
- Defined in: [ packages/form-core/src/FormApi.ts:692 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L692 )
294
+ Defined in: [ packages/form-core/src/FormApi.ts:696 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L696 )
295
295
296
296
A boolean indicating if none of the form's fields' values have been modified by the user. Evaluates ` true ` if the user have not modified any of the fields. Opposite of ` isDirty ` .
297
297
@@ -309,7 +309,7 @@ DerivedFormState.isPristine
309
309
isSubmitSuccessful : boolean ;
310
310
```
311
311
312
- Defined in: [ packages/form-core/src/FormApi.ts:626 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L626 )
312
+ Defined in: [ packages/form-core/src/FormApi.ts:630 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L630 )
313
313
314
314
A boolean indicating if the last submission was successful.
315
315
@@ -327,7 +327,7 @@ BaseFormState.isSubmitSuccessful
327
327
isSubmitted : boolean ;
328
328
```
329
329
330
- Defined in: [ packages/form-core/src/FormApi.ts:614 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L614 )
330
+ Defined in: [ packages/form-core/src/FormApi.ts:618 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L618 )
331
331
332
332
A boolean indicating if the ` onSubmit ` function has completed successfully.
333
333
@@ -349,7 +349,7 @@ BaseFormState.isSubmitted
349
349
isSubmitting : boolean ;
350
350
```
351
351
352
- Defined in: [ packages/form-core/src/FormApi.ts:606 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L606 )
352
+ Defined in: [ packages/form-core/src/FormApi.ts:610 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L610 )
353
353
354
354
A boolean indicating if the form is currently in the process of being submitted after ` handleSubmit ` is called.
355
355
@@ -375,7 +375,7 @@ BaseFormState.isSubmitting
375
375
isTouched : boolean ;
376
376
```
377
377
378
- Defined in: [ packages/form-core/src/FormApi.ts:680 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L680 )
378
+ Defined in: [ packages/form-core/src/FormApi.ts:684 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L684 )
379
379
380
380
A boolean indicating if any of the form fields have been touched.
381
381
@@ -393,7 +393,7 @@ DerivedFormState.isTouched
393
393
isValid : boolean ;
394
394
```
395
395
396
- Defined in: [ packages/form-core/src/FormApi.ts:700 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L700 )
396
+ Defined in: [ packages/form-core/src/FormApi.ts:704 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L704 )
397
397
398
398
A boolean indicating if the form and all its fields are valid. Evaluates ` true ` if there are no errors.
399
399
@@ -411,7 +411,7 @@ DerivedFormState.isValid
411
411
isValidating : boolean ;
412
412
```
413
413
414
- Defined in: [ packages/form-core/src/FormApi.ts:618 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L618 )
414
+ Defined in: [ packages/form-core/src/FormApi.ts:622 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L622 )
415
415
416
416
A boolean indicating if the form or any of its fields are currently validating.
417
417
@@ -429,7 +429,7 @@ BaseFormState.isValidating
429
429
submissionAttempts : number ;
430
430
```
431
431
432
- Defined in: [ packages/form-core/src/FormApi.ts:622 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L622 )
432
+ Defined in: [ packages/form-core/src/FormApi.ts:626 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L626 )
433
433
434
434
A counter for tracking the number of submission attempts.
435
435
@@ -447,7 +447,7 @@ BaseFormState.submissionAttempts
447
447
validationMetaMap : Record < " onMount" | " onChange" | " onBlur" | " onSubmit" | " onDynamic" | " onServer" , undefined | ValidationMeta > ;
448
448
```
449
449
450
- Defined in: [ packages/form-core/src/FormApi.ts:589 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L589 )
450
+ Defined in: [ packages/form-core/src/FormApi.ts:593 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L593 )
451
451
452
452
An internal mechanism used for keeping track of validation logic in a form.
453
453
@@ -465,7 +465,7 @@ BaseFormState.validationMetaMap
465
465
values : TFormData ;
466
466
```
467
467
468
- Defined in: [ packages/form-core/src/FormApi.ts:570 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L570 )
468
+ Defined in: [ packages/form-core/src/FormApi.ts:574 ] ( https://github.com/TanStack/form/blob/main/packages/form-core/src/FormApi.ts#L574 )
469
469
470
470
The current values of the form fields.
471
471
0 commit comments