Skip to content
Source
Sign inSign up
TanStack/form
Open History to see the last commit

FieldApiOptions.md

162 lines4.1 KB

1---
2id: FieldApiOptions
3title: FieldApiOptions
4---
5​
6# Interface: FieldApiOptions\<TParentData, TName, TFieldValidator, TFormValidator, TData\>
7​
8An object type representing the required options for the FieldApi class.
9​
10## Extends
11​
12- [`FieldOptions`](FieldOptions.md)\<`TParentData`, `TName`, `TFieldValidator`, `TFormValidator`, `TData`\>
13​
14## Type Parameters
15​
16β€’ **TParentData**
17​
18β€’ **TName** *extends* [`DeepKeys`](DeepKeys.md)\<`TParentData`\>
19​
20β€’ **TFieldValidator** *extends* `Validator`\<[`DeepValue`](DeepValue.md)\<`TParentData`, `TName`\>, `unknown`\> \| `undefined` = `undefined`
21​
22β€’ **TFormValidator** *extends* `Validator`\<`TParentData`, `unknown`\> \| `undefined` = `undefined`
23​
24β€’ **TData** *extends* [`DeepValue`](DeepValue.md)\<`TParentData`, `TName`\> = [`DeepValue`](DeepValue.md)\<`TParentData`, `TName`\>
25​
26## Properties
27​
28### asyncAlways?
29​
30```ts
31optional asyncAlways: boolean;
32```
33​
34If `true`, always run async validation, even if there are errors emitted during synchronous validation.
35​
36#### Inherited from
37​
38[`FieldOptions`](FieldOptions.md).[`asyncAlways`](Interface.FieldOptions.md#asyncalways)
39​
40#### Defined in
41​
42[packages/form-core/src/FieldApi.ts:284](https://github.com/TanStack/form/blob/a6313b7699753752ae30ff16c169e0b08c2369e8/packages/form-core/src/FieldApi.ts#L284)
43​
44***
45​
46### asyncDebounceMs?
47​
48```ts
49optional asyncDebounceMs: number;
50```
51​
52The default time to debounce async validation if there is not a more specific debounce time passed.
53​
54#### Inherited from
55​
56[`FieldOptions`](FieldOptions.md).[`asyncDebounceMs`](Interface.FieldOptions.md#asyncdebouncems)
57​
58#### Defined in
59​
60[packages/form-core/src/FieldApi.ts:280](https://github.com/TanStack/form/blob/a6313b7699753752ae30ff16c169e0b08c2369e8/packages/form-core/src/FieldApi.ts#L280)
61​
62***
63​
64### defaultMeta?
65​
66```ts
67optional defaultMeta: Partial<FieldMeta>;
68```
69​
70An optional object with default metadata for the field.
71​
72#### Inherited from
73​
74[`FieldOptions`](FieldOptions.md).[`defaultMeta`](Interface.FieldOptions.md#defaultmeta)
75​
76#### Defined in
77​
78[packages/form-core/src/FieldApi.ts:302](https://github.com/TanStack/form/blob/a6313b7699753752ae30ff16c169e0b08c2369e8/packages/form-core/src/FieldApi.ts#L302)
79​
80***
81​
82### defaultValue?
83​
84```ts
85optional defaultValue: NoInfer<TData>;
86```
87​
88An optional default value for the field.
89​
90#### Inherited from
91​
92[`FieldOptions`](FieldOptions.md).[`defaultValue`](Interface.FieldOptions.md#defaultvalue)
93​
94#### Defined in
95​
96[packages/form-core/src/FieldApi.ts:276](https://github.com/TanStack/form/blob/a6313b7699753752ae30ff16c169e0b08c2369e8/packages/form-core/src/FieldApi.ts#L276)
97​
98***
99​
100### form
101​
102```ts
103form: FormApi<TParentData, TFormValidator>;
104```
105​
106#### Defined in
107​
108[packages/form-core/src/FieldApi.ts:325](https://github.com/TanStack/form/blob/a6313b7699753752ae30ff16c169e0b08c2369e8/packages/form-core/src/FieldApi.ts#L325)
109​
110***
111​
112### name
113​
114```ts
115name: TName;
116```
117​
118The field name. The type will be `DeepKeys<TParentData>` to ensure your name is a deep key of the parent dataset.
119​
120#### Inherited from
121​
122[`FieldOptions`](FieldOptions.md).[`name`](Interface.FieldOptions.md#name)
123​
124#### Defined in
125​
126[packages/form-core/src/FieldApi.ts:272](https://github.com/TanStack/form/blob/a6313b7699753752ae30ff16c169e0b08c2369e8/packages/form-core/src/FieldApi.ts#L272)
127​
128***
129​
130### validatorAdapter?
131​
132```ts
133optional validatorAdapter: TFieldValidator;
134```
135​
136A validator provided by an extension, like `yupValidator` from `@tanstack/yup-form-adapter`
137​
138#### Inherited from
139​
140[`FieldOptions`](FieldOptions.md).[`validatorAdapter`](Interface.FieldOptions.md#validatoradapter)
141​
142#### Defined in
143​
144[packages/form-core/src/FieldApi.ts:288](https://github.com/TanStack/form/blob/a6313b7699753752ae30ff16c169e0b08c2369e8/packages/form-core/src/FieldApi.ts#L288)
145​
146***
147​
148### validators?
149​
150```ts
151optional validators: FieldValidators<TParentData, TName, TFieldValidator, TFormValidator, TData>;
152```
153​
154A list of validators to pass to the field
155​
156#### Inherited from
157​
158[`FieldOptions`](FieldOptions.md).[`validators`](Interface.FieldOptions.md#validators)
159​
160#### Defined in
161​
162[packages/form-core/src/FieldApi.ts:292](https://github.com/TanStack/form/blob/a6313b7699753752ae30ff16c169e0b08c2369e8/packages/form-core/src/FieldApi.ts#L292)