Open History to see the last commit
1import {
2 Directive,
3 Input,
4 booleanAttribute,
5 numberAttribute,
6} from '@angular/core'
7import {
8 FieldApi,
9 FieldApiOptions,
10 FieldAsyncValidateOrFn,
11 FieldValidateOrFn,
12 FormApi,
13} from '@tanstack/form-core'
14import type {
15 DeepKeys,
16 DeepValue,
17 FieldListeners,
18 FieldMeta,
19 FieldOptions,
20 FieldValidators,
21 FormAsyncValidateOrFn,
22 FormValidateOrFn,
23} from '@tanstack/form-core'
24import type { OnChanges, OnDestroy, OnInit } from '@angular/core'
25β
26@Directive({
27 selector: '[tanstackField]',
28 standalone: true,
29 exportAs: 'field',
30})
31export class TanStackField<
32 TParentData,
33 const TName extends DeepKeys<TParentData>,
34 TData extends DeepValue<TParentData, TName>,
35 TOnMount extends undefined | FieldValidateOrFn<TParentData, TName, TData>,
36 TOnChange extends undefined | FieldValidateOrFn<TParentData, TName, TData>,
37 TOnChangeAsync extends
38 | undefined
39 | FieldAsyncValidateOrFn<TParentData, TName, TData>,
40 TOnBlur extends undefined | FieldValidateOrFn<TParentData, TName, TData>,
41 TOnBlurAsync extends
42 | undefined
43 | FieldAsyncValidateOrFn<TParentData, TName, TData>,
44 TOnSubmit extends undefined | FieldValidateOrFn<TParentData, TName, TData>,
45 TOnSubmitAsync extends
46 | undefined
47 | FieldAsyncValidateOrFn<TParentData, TName, TData>,
48 TFormOnMount extends undefined | FormValidateOrFn<TParentData>,
49 TFormOnChange extends undefined | FormValidateOrFn<TParentData>,
50 TFormOnChangeAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
51 TFormOnBlur extends undefined | FormValidateOrFn<TParentData>,
52 TFormOnBlurAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
53 TFormOnSubmit extends undefined | FormValidateOrFn<TParentData>,
54 TFormOnSubmitAsync extends undefined | FormAsyncValidateOrFn<TParentData>,
55 TFormOnServer extends undefined | FormAsyncValidateOrFn<TParentData>,
56 TSubmitMeta,
57 >
58 implements
59 OnInit,
60 OnChanges,
61 OnDestroy,
62 FieldOptions<
63 TParentData,
64 TName,
65 TData,
66 TOnMount,
67 TOnChange,
68 TOnChangeAsync,
69 TOnBlur,
70 TOnBlurAsync,
71 TOnSubmit,
72 TOnSubmitAsync
73 >
74{
75 @Input({ required: true }) name!: TName
76 @Input() defaultValue?: NoInfer<TData>
77 @Input({ transform: numberAttribute }) asyncDebounceMs?: number
78 @Input({ transform: booleanAttribute }) asyncAlways?: boolean
79 @Input({ required: true }) tanstackField!: FormApi<
80 TParentData,
81 TFormOnMount,
82 TFormOnChange,
83 TFormOnChangeAsync,
84 TFormOnBlur,
85 TFormOnBlurAsync,
86 TFormOnSubmit,
87 TFormOnSubmitAsync,
88 TFormOnServer,
89 TSubmitMeta
90 >
91 @Input() validators?: NoInfer<
92 FieldValidators<
93 TParentData,
94 TName,
95 TData,
96 TOnMount,
97 TOnChange,
98 TOnChangeAsync,
99 TOnBlur,
100 TOnBlurAsync,
101 TOnSubmit,
102 TOnSubmitAsync
103 >
104 >
105 @Input() listeners?: NoInfer<FieldListeners<TParentData, TName, TData>>
106 @Input() defaultMeta?: Partial<
107 FieldMeta<
108 TParentData,
109 TName,
110 TData,
111 TOnMount,
112 TOnChange,
113 TOnChangeAsync,
114 TOnBlur,
115 TOnBlurAsync,
116 TOnSubmit,
117 TOnSubmitAsync,
118 TFormOnMount,
119 TFormOnChange,
120 TFormOnChangeAsync,
121 TFormOnBlur,
122 TFormOnBlurAsync,
123 TFormOnSubmit,
124 TFormOnSubmitAsync
125 >
126 >
127 @Input() disableErrorFlat?: boolean
128β
129 api!: FieldApi<
130 TParentData,
131 TName,
132 TData,
133 TOnMount,
134 TOnChange,
135 TOnChangeAsync,
136 TOnBlur,
137 TOnBlurAsync,
138 TOnSubmit,
139 TOnSubmitAsync,
140 TFormOnMount,
141 TFormOnChange,
142 TFormOnChangeAsync,
143 TFormOnBlur,
144 TFormOnBlurAsync,
145 TFormOnSubmit,
146 TFormOnSubmitAsync,
147 TFormOnServer,
148 TSubmitMeta
149 >
150β
151 private getOptions(): FieldApiOptions<
152 TParentData,
153 TName,
154 TData,
155 TOnMount,
156 TOnChange,
157 TOnChangeAsync,
158 TOnBlur,
159 TOnBlurAsync,
160 TOnSubmit,
161 TOnSubmitAsync,
162 TFormOnMount,
163 TFormOnChange,
164 TFormOnChangeAsync,
165 TFormOnBlur,
166 TFormOnBlurAsync,
167 TFormOnSubmit,
168 TFormOnSubmitAsync,
169 TFormOnServer,
170 TSubmitMeta
171 > {
172 return {
173 defaultValue: this.defaultValue,
174 asyncDebounceMs: this.asyncDebounceMs,
175 asyncAlways: this.asyncAlways,
176 disableErrorFlat: this.disableErrorFlat,
177 validators: this.validators,
178 listeners: this.listeners,
179 defaultMeta: this.defaultMeta,
180 name: this.name,
181 form: this.tanstackField,
182 }
183 }
184β
185 unmount?: () => void
186β
187 ngOnInit() {
188 this.api = new FieldApi(this.getOptions())
189β
190 this.unmount = this.api.mount()
191 }
192β
193 ngOnDestroy() {
194 this.unmount?.()
195 }
196β
197 ngOnChanges() {
198 const api = this.api as typeof this.api | undefined
199 if (!api) return
200 api.update(this.getOptions())
201 }
202}