Components/useForm

useForm

Lightweight form state management with validation, touched tracking, and submit handling. No external dependencies.

Installation

Usage

API Reference

PropTypeDefaultDescription
valuesTCurrent form values object.
errorsPartial<Record<keyof T, string>>Validation error messages.
touchedPartial<Record<keyof T, boolean>>Which fields have been blurred.
isSubmittingbooleanTrue while onSubmit is running.
isDirtybooleanTrue when values differ from initialValues.
isValidbooleanTrue when validate returns no errors.
setValue(field, value) => voidSet a single field value.
handleChange(field) => ChangeHandlerReturns an onChange handler.
handleBlur(field) => () => voidReturns an onBlur handler.
handleSubmit(e?) => voidRuns validation then calls onSubmit.
reset() => voidResets to initialValues.