simple-redux-form

0.1.0 • Public • Published

Simplest Redux Form

Higher order component for React Redux forms (inspired by redux-form)

Note

Idea of this library is 100% inspired from redux-form (v5).

This library is subset of redux-form for small / few forms. If your application is form heavey with large / complex form please use redux-form.

I have implemented this libray for following reasons :-

  • redux-form is great way of managing forms within application with react and redux.
  • For small forms using large library will add up unnecessary bundle size increase, this library focus on simple and small version of redux-from
  • Scope of this library will be very minimal, if you want full fledge library please use redux-form.

Installation

$ npm install --save simple-redux-form

Usage

Step #1

The first thing, you have to mount simple-redux-form reducer to your redux reducers. Configure this inside your rootReducers.

import {reducer as simpleFormReducer} from 'simple-redux-form';
const reducers = {
  // your other reducers
  form: simpleFormReducer  
}

Step #2

You need to decorate your component with simpleReduxForm.

import simpleReduxForm from 'simple-redux-form'
const fields = ['firstName', 'lastName'];
function validate(values) {
  const errors = {};
  if (!values.firstName) {
    errors.firstName = 'Required';
  }
  if (!values.lastName) {
    errors.lastName = 'Required';
  }
  return errors;
}
 
const MyNewForm = ({ fields: {firstName, lastName } }) => (
  <form>
    <input {...firstName} />
    <input {...lastName} />
  </form>
)
 
export default simpleReduxForm({
  fields: fields,
  validate: validate,
})(MyNewForm)
 

Each field in the fields prop contains the value a onChange, error , touched as sugger props to each field.

You can also pass fields as props.

For custom Input components this library expose , setValue function with each field for setting vlaues manually.

Todo

  • Docs
  • Examples
  • Test Cases

License

MIT

Dependents (0)

Package Sidebar

Install

npm i simple-redux-form

Weekly Downloads

4

Version

0.1.0

License

MIT

Last publish

Collaborators

  • mihir