fielder

Fielder

A field-first form library for React and React Native.

About

Fielder is a form library for React and React Native that has been built from the ground up with a field-first approach to validation.

Features

⚡️ Synchronous validation - no cascading renders

🛎 Validation events - validation can differ per event (change, blur, submit, etc.)

🪝 Hooks that work - hooks respond to validation changes

🧠 Evolving schemas - validation logic evolves with the UI

Basic usage

Install Fielder

Add Fielder to your project.

npm i fielder

Import the module

Use fielder or fielder/preact.

// React
import { useForm, ... } from 'fielder';

// Preact
import { useForm, ... } from 'fielder/preact';

Set up a form

Use the useForm hook to create a form.

const myForm = useForm();

return <FielderProvider value={myForm}>{children}</FielderProvider>;

Create some fields

Use the useField hook to create a field.

const [usernameProps, usernameMeta] = useField({
  name: 'username',
  initialValue: '',
  validate: useCallback(({ value }) => {
    if (!value) {
      throw Error('Username is required!');
    }
  }, []),
});

return (
  <>
    <input type="text" {...usernameProps} />
    <span>{usernameMeta.error}</span>
  </>
);

Additional info

Once you're all set up, be sure to check out the guides for a deeper dive!

Additional resources

For more info, tutorials and examples, visit the official docs site!

Also check out:

• [Article] Why we need another form library
• [Benchmark] Fielder vs Formik
• [Video] Getting started with Fielder

Changelog

v2.2.0 (2022-09-12)

Full Changelog

Additions:

• Add support for persisting state #12

Merged pull requests:

• Update docs dependencies #336 (andyrichardson)
• Add "fromState" to docs #335 (andyrichardson)
• Fix formatting #334 (andyrichardson)
• Move to Github Actions #333 (andyrichardson)
• Fix e2e tests #321 (andyrichardson)
• Add value restoration (optional) #320 (andyrichardson)