Open History to see the last commit
1import * as React from 'react'
2import { createRoot } from 'react-dom/client'
3β
4import { TanStackDevtools } from '@tanstack/react-devtools'
5import { formDevtoolsPlugin } from '@tanstack/react-form-devtools'
6import { useForm } from '@tanstack/react-form'
7import {
8 QueryClient,
9 QueryClientProvider,
10 useMutation,
11 useQuery,
12} from '@tanstack/react-query'
13β
14import type { AnyFieldApi } from '@tanstack/react-form'
15β
16function FieldInfo({ field }: { field: AnyFieldApi }) {
17 return (
18 <>
19 {field.state.meta.isTouched && !field.state.meta.isValid ? (
20 <em>{field.state.meta.errors.join(',')}</em>
21 ) : null}
22 {field.state.meta.isValidating ? 'Validating...' : null}
23 </>
24 )
25}
26β
27class DB {
28 private data: { firstName: string; lastName: string }
29β
30 constructor() {
31 this.data = { firstName: 'FirstName', lastName: 'LastName' }
32 }
33β
34 getData(): { firstName: string; lastName: string } {
35 return { ...this.data }
36 }
37β
38 async saveUser(value: { firstName: string; lastName: string }) {
39 this.data = value
40 return value
41 }
42}
43β
44// Dummy Database to emulate server-side actions
45const db = new DB()
46β
47export default function App() {
48 const { data, isLoading, refetch } = useQuery({
49 queryKey: ['data'],
50 queryFn: async () => {
51 await new Promise((resolve) => setTimeout(resolve, 1000))
52 return db.getData()
53 },
54 })
55β
56 const saveUserMutation = useMutation({
57 mutationFn: async (value: { firstName: string; lastName: string }) => {
58 await new Promise((resolve) => setTimeout(resolve, 1000))
59 db.saveUser(value)
60 },
61 })
62β
63 const form = useForm({
64 defaultValues: {
65 firstName: data?.firstName ?? '',
66 lastName: data?.lastName ?? '',
67 },
68 onSubmit: async ({ formApi, value }) => {
69 // Do something with form data
70 await saveUserMutation.mutateAsync(value)
71β
72 // Invalidating query to recheck fresh data
73 await refetch()
74β
75 // Reset the form to start-over with a clean state
76 formApi.reset()
77 },
78 })
79β
80 if (isLoading) return <p>Loading..</p>
81β
82 return (
83 <div>
84 <h1>Simple Form Example</h1>
85 <form
86 onSubmit={(e) => {
87 e.preventDefault()
88 e.stopPropagation()
89 form.handleSubmit()
90 }}
91 >
92 <div>
93 {/* A type-safe field component*/}
94 <form.Field
95 name="firstName"
96 validators={{
97 onChange: ({ value }) =>
98 !value
99 ? 'A first name is required'
100 : value.length < 3
101 ? 'First name must be at least 3 characters'
102 : undefined,
103 onChangeAsyncDebounceMs: 500,
104 onChangeAsync: async ({ value }) => {
105 await new Promise((resolve) => setTimeout(resolve, 1000))
106 return (
107 value.includes('error') && 'No "error" allowed in first name'
108 )
109 },
110 }}
111 children={(field) => {
112 // Avoid hasty abstractions. Render props are great!
113 return (
114 <>
115 <label htmlFor={field.name}>First Name:</label>
116 <input
117 id={field.name}
118 name={field.name}
119 value={field.state.value}
120 onBlur={field.handleBlur}
121 onChange={(e) => field.handleChange(e.target.value)}
122 />
123 <FieldInfo field={field} />
124 </>
125 )
126 }}
127 />
128 </div>
129 <div>
130 <form.Field
131 name="lastName"
132 children={(field) => (
133 <>
134 <label htmlFor={field.name}>Last Name:</label>
135 <input
136 id={field.name}
137 name={field.name}
138 value={field.state.value}
139 onBlur={field.handleBlur}
140 onChange={(e) => field.handleChange(e.target.value)}
141 />
142 <FieldInfo field={field} />
143 </>
144 )}
145 />
146 </div>
147 <form.Subscribe
148 selector={(state) => [state.canSubmit, state.isSubmitting]}
149 children={([canSubmit, isSubmitting]) => (
150 <>
151 <button type="submit" disabled={!canSubmit}>
152 {isSubmitting ? '...' : 'Submit'}
153 </button>
154 <button type="reset" onClick={() => form.reset()}>
155 Reset
156 </button>
157 </>
158 )}
159 />
160 </form>
161 </div>
162 )
163}
164β
165const rootElement = document.getElementById('root')!
166β
167const queryClient = new QueryClient()
168β
169createRoot(rootElement).render(
170 <React.StrictMode>
171 <QueryClientProvider client={queryClient}>
172 <App />
173 </QueryClientProvider>
174β
175 <TanStackDevtools
176 config={{ hideUntilHover: true }}
177 plugins={[formDevtoolsPlugin()]}
178 />
179 </React.StrictMode>,
180)