Open History to see the last commit
1import * as React from 'react'
2import { createRoot } from 'react-dom/client'
3import { useForm } from '@tanstack/react-form'
4import {
5 QueryClient,
6 QueryClientProvider,
7 useQuery,
8} from '@tanstack/react-query'
9import type { FieldApi } from '@tanstack/react-form'
10β
11function FieldInfo({ field }: { field: FieldApi<any, any, any, any> }) {
12 return (
13 <>
14 {field.state.meta.isTouched && field.state.meta.errors.length ? (
15 <em>{field.state.meta.errors.join(',')}</em>
16 ) : null}
17 {field.state.meta.isValidating ? 'Validating...' : null}
18 </>
19 )
20}
21β
22export default function App() {
23 const { data, isLoading } = useQuery({
24 queryKey: ['data'],
25 queryFn: async () => {
26 await new Promise((resolve) => setTimeout(resolve, 1000))
27 return { firstName: 'FirstName', lastName: 'LastName' }
28 },
29 })
30β
31 const form = useForm({
32 defaultValues: {
33 firstName: data?.firstName ?? '',
34 lastName: data?.lastName ?? '',
35 },
36 onSubmit: async ({ value }) => {
37 // Do something with form data
38 console.log(value)
39 },
40 })
41β
42 if (isLoading) return <p>Loading..</p>
43β
44 return (
45 <div>
46 <h1>Simple Form Example</h1>
47 <form
48 onSubmit={(e) => {
49 e.preventDefault()
50 e.stopPropagation()
51 form.handleSubmit()
52 }}
53 >
54 <div>
55 {/* A type-safe field component*/}
56 <form.Field
57 name="firstName"
58 validators={{
59 onChange: ({ value }) =>
60 !value
61 ? 'A first name is required'
62 : value.length < 3
63 ? 'First name must be at least 3 characters'
64 : undefined,
65 onChangeAsyncDebounceMs: 500,
66 onChangeAsync: async ({ value }) => {
67 await new Promise((resolve) => setTimeout(resolve, 1000))
68 return (
69 value.includes('error') && 'No "error" allowed in first name'
70 )
71 },
72 }}
73 children={(field) => {
74 // Avoid hasty abstractions. Render props are great!
75 return (
76 <>
77 <label htmlFor={field.name}>First Name:</label>
78 <input
79 id={field.name}
80 name={field.name}
81 value={field.state.value}
82 onBlur={field.handleBlur}
83 onChange={(e) => field.handleChange(e.target.value)}
84 />
85 <FieldInfo field={field} />
86 </>
87 )
88 }}
89 />
90 </div>
91 <div>
92 <form.Field
93 name="lastName"
94 children={(field) => (
95 <>
96 <label htmlFor={field.name}>Last Name:</label>
97 <input
98 id={field.name}
99 name={field.name}
100 value={field.state.value}
101 onBlur={field.handleBlur}
102 onChange={(e) => field.handleChange(e.target.value)}
103 />
104 <FieldInfo field={field} />
105 </>
106 )}
107 />
108 </div>
109 <form.Subscribe
110 selector={(state) => [state.canSubmit, state.isSubmitting]}
111 children={([canSubmit, isSubmitting]) => (
112 <>
113 <button type="submit" disabled={!canSubmit}>
114 {isSubmitting ? '...' : 'Submit'}
115 </button>
116 <button type="reset" onClick={() => form.reset()}>
117 Reset
118 </button>
119 </>
120 )}
121 />
122 </form>
123 </div>
124 )
125}
126β
127const rootElement = document.getElementById('root')!
128β
129const queryClient = new QueryClient()
130β
131createRoot(rootElement).render(
132 <React.StrictMode>
133 <QueryClientProvider client={queryClient}>
134 <App />
135 </QueryClientProvider>
136 </React.StrictMode>,
137)