TanStack Form is headless. UI library integration consists of adapting a field's value, blur callback, change callback, invalid state, and errors to the component's prop names.
Text inputs#
Many Solid text-input components accept DOM-like props:
<form.Field name="name">
{(field) => (
<TextInput
name={field().name}
label="Name"
value={field().value}
onBlur={field().handleBlur}
onInput={(event) => field().handleChange(event.currentTarget.value)}
error={field()
.errors.map((error) => error.message)
.join(', ')}
/>
)}
</form.Field>
Pass value instead of using a component's one-time default-value prop so the
component reflects form state.
Checkboxes and switches#
DOM-style checkbox components expose event.currentTarget.checked:
<form.Field name="acceptedTerms">
{(field) => (
<Checkbox
checked={field().value}
onBlur={field().handleBlur}
onChange={(event) => field().handleChange(event.currentTarget.checked)}
aria-invalid={field().meta.isInvalid}
/>
)}
</form.Field>
Some libraries call back with a boolean, a details object, or a union such as
boolean | 'indeterminate'. Normalize that value at the boundary:
<Checkbox
checked={field().value}
onCheckedChange={(checked) => field().handleChange(checked === true)}
/>
Selects, date pickers, and custom controls#
The integration does not require a native event. Pass the value produced by the
component to field().handleChange:
<DatePicker
value={field().value}
onValueChange={(nextDate) => field().handleChange(nextDate)}
onBlur={field().handleBlur}
/>
Choose a serializable form value appropriate for your application, then adapt the UI library's richer object at the component boundary if necessary.
Reuse the adapter#
If the same wiring appears throughout the application, extract a Solid
component that accepts Accessor<FieldWithValue<T>> or register it with
createFormHook.
For the helper types used when passing a form or field to an extracted component, see Splitting forms.
The repository's examples/solid/large-form example demonstrates reusable
field and form components with the v2 Solid adapter.