dynamic-form-json

v1.0.9

Published

2 years ago

dynamic-form-json is a tiny library to generate a Form in React automatically based on certain array of object that passed as a props

Downloads

0High
0Medium
0Low

ridoansalehnasution

react form dynamic-form formik yup styled-component

Dynamic Form Json

dynamic-form-json is a tiny library to generate a Form in React automatically based on certain array of object that passed as a props. This library use regular css created from scratch, so user can customize it in the future. On top of it, i use Formik and Yup for form's skeleton and validations. Credit goes to vijayranghar for the inspiration how to create dynamic validation on Yup from this link.

Installation

npm install dynamic-form-json or yarn add dynamic-form-json

Peer Dependencies

Remember you also need to install the peer dependencies of this package. They are formik, yup, and styled-components.

How to Use

Incase you are curious to try this library, you can implement it as the source code below.

index.js

import React from "react";
import ReactDOM from "react-dom";
import App from "./App";

ReactDOM.render(<App />, document.getElementById("root"));

App.js

import DynamicForm from 'dynamic-form-json';
import { formData } from './data/formData';

function App() {
  const handleSubmission = val => {
    console.log('Values : 'val)
  }
  return (
    <div>
      <h2>My Amazing Form</h2>
      <DynamicForm fields={formData} cbSubmit={handleSubmission} />
    </div>
  )
}

export default App;

formData.js

export const formData = [
  {
    id: "name",
    label: "Full name",
    placeholder: "Enter full name",
    type: "text",
    validationType: "string",
    value: "",
    validations: [
      {
        type: "required",
        params: ["name is required"],
      },
      {
        type: "min",
        params: [5, "name cannot be less than 5 characters"],
      },
      {
        type: "max",
        params: [10, "name cannot be more than 10 characters"],
      },
    ],
  },
];

Supported Fields

Currently this library supports form input types such as:

[x] text
[x] select
[x] textarea
[x] radio
[x] checkbox
[x] upload

API

DynamicFormJSON - `DynamicForm(fields: Array[Object], cbSubmit: Func)`

This library could be imported by any name you like because we export it by default approach. It also accepts two parameters which are named fields and cbSubmit. All params are required.

import DynamicForm from "dynamic-form-json";

fields is a property that accepts array of object to create the inputs element inside a Form. The last one is cbSumbit, which will handle the submission for you. It accepts a callback function.

TextField

These are the properties you can pass to an Object in formData array to create TextField component. Not all of them are required. The properties required are id, and type.

SelectField

These are the properties you can pass to an Object in formData array to create SelectField component.

TextArea

These are the properties you can pass to an Object in formData array to create TextArea component.

Radio

These are the properties you can pass to an Object in formData array to create Radio component.

Checkbox

These are the properties you can pass to an Object in formData array to create Checkbox component.

UploadField

These are the properties you can pass to an Object in formData array to create UploadField component.

Info

This package is still on development. Not ready yet to use in production.