Git Product home page Git Product logo

reactidate's Introduction

Reactidate

Issues Forks Stars Pull Request Stats

React form validator.

Installation

To install, run:

npm install reactidate --save

Usage

Using reactidate in react applications is super following the code sample below

    import { useRef, useState } from "react";
    import {useValidate, Required, Email, minLength}  from "reactidate";

    function App(){
        const $validate = useValidate({multiple: true})
  
        const rules = { 
            email: {Required, Email},
            password: {Required, minLength: minLength(6)},
        }

        const formdata = useRef({email: "", password: ""});

        const [formRules, setFormRules] = useState(rules);

        const Submit = (ev: any) =>{
            ev.preventDefault()
            let valid = $validate(setFormRules, formRules, formdata.current);
            if(!valid){
                return;
            }
            // other process and api request code
        }

    }

Note: that the code sample above implements the useRef Hook to store the state of the form data. useState can also be used.

The template will look like the code below

    <div >
        <input onChange={(e) => formdata.current.email = e.currentTarget.value} type="email" className={formRules.email?.$error ? 'red': ''}  />
        { !!formRules.email?.$error  && <span>{formRules.email?.$message}</span> }
    </div>

useValidate hook and the $validate function call are the two important aspect of the code above.

useValidate takes an options with the following params

Params type description
multiple boolean (default: true) Specifies if validator should stop on error seen for a single form element

License

The MIT License (MIT). Please see License File for more information.

reactidate's People

Contributors

samuelhenshaw2020 avatar pragmahomes avatar

Stargazers

 avatar

Watchers

 avatar

reactidate's Issues

Bug: `valueState` error when a rule is not passed (keys are not same)

when the rules is

const rule_list = {
    email: {Requied},
    name: {Requied}
}
const [rules, setRules] = useState(rule_list)

and form state is

const [state, setState] = useState({
  email: "",
  name: "",
  address: "" 
})

it throws error since valueStates (state) keys, (Object.keys(valueStates)) is used to loop all fields.

suggestion: use Object.keys(rulesState) to loop so that only fields withing the rules will be checked

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.