The goal of Freeform is to provide an unopinionated framework for building forms, without manually passing values and onChange events. There are only 3 decisions that have been made that limit your freedom, and all of them have workarounds if they impede your project.
- You must know the default values before the form is rendered
- You may not change the type of a value after it has been set
- Changing from an
objectto astringis usually a sign of data integrity problems <input>forces values to be a string, but if a value was previously a number, Freeform will attempt to typecast it back into one
- Changing from an
- Your form must support an object of values.
- If you're building a form with a single value, you probably don't need this library
- If you're building an array of values, you will need to put it in an object first and access it during the submit
Beyond these limitations, Freeform tries to let you write your form however you please.
You can build a form that uses 2005-style POST submissions, GraphQL, WebSockets,
or anything else you can imagine. Any component's render can be overridden, and Freeform
can work with any input field available, often out of the box.
React Freeform requires React 16.0 or later.
npm install --save react-freeformMIT