Neanderthal Pudding Mix

    passable-react

    0.7.6 • Public • Published

    Passable-React

    Greenkeeper badge

    Passable-React is a package that allows easy integration with passable validations. It manages the form state itself, leaving you to only care about writing the validations and hooking it all together.

    Philosophy

    When using passable-react, you let its core component PassableProvider take control over the state of the form and supply you with different functions and values that allow you connect it to your state. PassableProvider uses the children as a function pattern both for familiarity and flexibility.

    Installation

    npm install --save passable-react

    Usage

    // ./App.js
    import React, {Component} from 'react';
    import PassableProvider from 'passable-react';
    import passes from './passes.js';
     
    class App extends Component {
        initiaFormState = {
            username: 'initial value',
            password: '',
            spam: {
                checked: true
            }
        }
     
        render() {
            return (
                <PassableProvider passes={passes} initialFormState={this.initialFormState}>
                {(setTouchedOnEvent, validateOnEvent, validateOne, validateAll, fields, errors, warnings) => {
                    <form name="myform" onBlur={setTouchedOnEvent} onChange={validateOne} onSubmit={validateAll}>
                        <input type="text" name="username" value={fields.username.value}/>
                        {errors[username] && <span>{fields.username.errors}</span>}
                        <input type="password" name="password" value={fields.password.value}/>
                        {errors[password] && <span>{fields.password.errors}</span>}
                        <input type="checkbox" name="spam" value={fields.spam.value} checked={fields.spam.checked}/>
                        {errors[spam] && <span>{fields.spam.errors}</span>}
                        <input type="submit" value="Submit"/>
                    </form>
                }}
                </PassableProvider>
            );
        }
    }
     
    // ./passes.js
    import passable, { enforce } from 'passable';
     
    export default function passes({ specific = [], data }) {
        return passable('myform', (test) => {
            test('username', 'should be a string between 3 and 10 chars', () => {
                enforce(data.username.value).allOf({
                    largerThanOrEquals: 5,
                    smallerThanOrEquals: 10
                });
            });
     
            test('password', 'can either be a number, or empty', () => {
                enforce(data.password.value).isNotEmpty();
            });
     
            test('spam', 'must be checked', () => !!data.password.checked);
        }, specific);
    }

    And that's all there is to it. Here is what we did:

    • We set our initial form state. It contains the default values for our form fields, including dirty and touched.
    • We created a passes file which holds our validation logic.
    • We attached both our initial form state and the passes to PassableProvider
    • We grabbed the functions supplied by provider and used them for our onChange and onBlur for the form.
    • We used the fields object to grab the current value and connect the inputs to the current state.
    • We added conditional rendering of errors next to each input. They will automatically get added once validation of a field fails.

    What else happens here?

    • The validateOnEvent function both validates a field, and marks it as dirty.
    • setTouchedOnEvent marks the field as touched

    The fields object:

    Here is an example of a fields object

    fields: {
        checkbox: {
            errors: []
            value: true
            warnings: []
        },
        radio_input: {
            checked: true,
            errors: [],
            value: "yo",
            warnings: []
        },
        username: {
            dirty: true,
            errors: Array["should be a string between 3 and 10 chars"],
            hasError: true,
            hasWarning: false,
            touched: true,
            value: "An",
            warnings: []
        }
    }

    The errors and warnings objects

    The errors and warnings objects are simply counters of the amount of errors in each field, saving you the hassle of traversing down the fields object and counting each field manually:

    errors: {
        phone: 1
        username: 1
    }

    Keywords

    none

    Install

    npm i passable-react

    DownloadsWeekly Downloads

    4

    Version

    0.7.6

    License

    ISC

    Unpacked Size

    217 kB

    Total Files

    34

    Last publish

    Collaborators

    • ealush