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