formio

Simple React library that accepts and manages form inputs and values.

View the Project on GitHub mxdi9i7/formio

formio-inputs

3kb compressed form component that takes care of everything for you.

formio stands for form input and output.

NPM JavaScript Style Guide

Install

yarn add formio-inputs
npm install --save formio-inputs

Basic Usage

import React, { Component } from 'react'

import Formio from 'formio-inputs'

const inputs = [
 {
   key: 'email', 
   type: 'email',
   label: 'Email:',
   placeholder: 'Enter your email here'
 },
 {
   key: 'password',
   type: 'password',
   label: 'Password',
   placeholder: 'Enter your password here'
 }
]

class Example extends Component {
  render () {
    return (
      <Formio 
        inputs={inputs}
        change={this.handleFormChange}
        submit={this.handleFormSubmit}
        theme={'bootstrap'}
      />
    )
  }
}

Props

Props with a asterisk (*) is required

Props Type Description
input* array a list of input objects to generate
change function Callback function triggers upon input change and returns the entire form state
submit function Callback function triggers upon clicking on the submit button
theme string Form theme bootstrap (default), material, classic
buttonStyle object Style object that customizes the submit button design

Todo

  1. Support for select options and checkbox inputs
  2. Support for file input
  3. Support for multi file input
  4. Test coverage

Issues

For all bug related issue please refer to the issues page and submit an issue

Contributions

If you would like a feature implemented consider submitting a PR yourself! All contributions welcomed.

License

MIT © mxdi9i7