Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


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.


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.


npm install --save passable-react


// ./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"/>

// ./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', () => {
                largerThanOrEquals: 5,
                smallerThanOrEquals: 10

        test('password', 'can either be a number, or empty', () => {

        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


Make Passable and React work together






No releases published


No packages published