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