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