Skip to content

This package serves as the entry point to the Formik Form state management library. It is intended to be paired with the generic Fonk package, which is shipped as to npm.

License

Notifications You must be signed in to change notification settings

Lemoncode/fonk-formik

Repository files navigation

fonk-formik

CircleCI NPM Version bundle-size

This package serves as the entry point to the Formik Form state management library (Live example). It is intended to be paired with the generic Fonk package, which is shipped as to npm.

Start by reading this post (Formik + Fonk)

Check our Fonk Documentation site and Formik section.

Adding Fonk to Formik allows you to seamlessly add validation capabilities to Formik.

In order to use Fonk with Formik you will have to install fonk-formik adaptor:

npm install @lemoncode/fonk @lemoncode/fonk-formik --save

The main change to apply when using a fonk-formik comes when you want to instantiate Fonk engine with your form validation schema, instead of calling createFormValidation , just replace that entry with createFormikValidation

- import { createFormValidation, Validators } from '@lemoncode/fonk';
+ import { Validators } from '@lemoncode/fonk';
+ import { createFormikValidation } from '@lemoncode/fonk-formik';

const validationSchema = {
  field: {
    email: [Validators.required.validator],
    password: [Validators.required.validator]
  }
};

- export const formValidation = createFormValidation(validationSchema);
+ export const formValidation = createFormikValidation(validationSchema);

Now you can hook to Formik form validation (example):

    <Formik
      initialValues={{ email: "", password: "" }}
+     validate={values => formValidation.validateForm(values)}
      onSubmit={(values, { setSubmitting }) => {
        setTimeout(() => {
          alert(JSON.stringify(values, null, 2));
          setSubmitting(false);
        }, 400);
      }}
    >

And if you want to hook to Formik field validations (example):

  <form onSubmit={handleSubmit}>
    <Field
      name="email"
+     validate={(value) => formValidation.validateField("email", value)} />

Example: How to display field validation error message:

    <Field name="email"/>
+    {errors &&
+      errors.email &&
+       touched.email &&
+       <div>{errors.email}</div>}

Examples:

Basic example

Using formik Field

Firing validations at field level

Asynchronous validation

Customizing validator's error messages globaly

Customizing validator's error messages just for a given form

Creating custom validators

Validating nested fields

Defining record validations

About Basefactor + Lemoncode

We are an innovating team of Javascript experts, passionate about turning your ideas into robust products.

Basefactor, consultancy by Lemoncode provides consultancy and coaching services.

Lemoncode provides training services.

For the LATAM/Spanish audience we are running an Online Front End Master degree, more info: http://lemoncode.net/master-frontend

About

This package serves as the entry point to the Formik Form state management library. It is intended to be paired with the generic Fonk package, which is shipped as to npm.

Resources

License

Stars

Watchers

Forks

Packages

No packages published