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, unknown, unknown> }) {
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 // Memoize your default values to prevent re-renders
20 defaultValues: {
21 firstName: "",
22 lastName: "",
23 },
24 onSubmit: async (values) => {
25 // Do something with form data
26 console.log(values);
27 },
28 });
29β
30 return (
31 <div>
32 <h1>Simple Form Example</h1>
33 {/* A pre-bound form component */}
34 <form.Provider>
35 <form
36 onSubmit={(e) => {
37 e.preventDefault();
38 e.stopPropagation();
39 void form.handleSubmit();
40 }}
41 >
42 <div>
43 {/* A type-safe and pre-bound field component*/}
44 <form.Field
45 name="firstName"
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 }
53 onChangeAsyncDebounceMs={500}
54 onChangeAsync={async (value) => {
55 await new Promise((resolve) => setTimeout(resolve, 1000));
56 return (
57 value.includes("error") && 'No "error" allowed in first name'
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 />);