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 type { FieldApi } from '@tanstack/react-form'
5β
6function FieldInfo({ field }: { field: FieldApi<any, any, any, any> }) {
7 return (
8 <>
9 {field.state.meta.touchedErrors ? (
10 <em>{field.state.meta.touchedErrors}</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.Provider>
33 <form
34 onSubmit={(e) => {
35 e.preventDefault()
36 e.stopPropagation()
37 void form.handleSubmit()
38 }}
39 >
40 <div>
41 {/* A type-safe field component*/}
42 <form.Field
43 name="firstName"
44 validators={{
45 onChange: ({ value }) =>
46 !value
47 ? 'A first name is required'
48 : value.length < 3
49 ? 'First name must be at least 3 characters'
50 : undefined,
51 onChangeAsyncDebounceMs: 500,
52 onChangeAsync: async ({ value }) => {
53 await new Promise((resolve) => setTimeout(resolve, 1000))
54 return (
55 value.includes('error') &&
56 '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 name={field.name}
67 value={field.state.value}
68 onBlur={field.handleBlur}
69 onChange={(e) => field.handleChange(e.target.value)}
70 />
71 <FieldInfo field={field} />
72 </>
73 )
74 }}
75 />
76 </div>
77 <div>
78 <form.Field
79 name="lastName"
80 children={(field) => (
81 <>
82 <label htmlFor={field.name}>Last Name:</label>
83 <input
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 <button type="submit" disabled={!canSubmit}>
98 {isSubmitting ? '...' : 'Submit'}
99 </button>
100 )}
101 />
102 </form>
103 </form.Provider>
104 </div>
105 )
106}
107β
108const rootElement = document.getElementById('root')!
109β
110createRoot(rootElement).render(<App />)