Skip to content

A small validation component for inputs which you can use everywhere and set any kind of validation you want to!

License

Notifications You must be signed in to change notification settings

Ggayane/react-input-validation

Repository files navigation

react-input-validation

A small validation component for inputs which you can use everywhere and set any kind of validation you want to!

Demo & Examples

Live demo: ggayane.github.io/react-input-validation

To build the examples locally, run:

npm install
npm start

Then open localhost:8000 in a browser.

Installation

The easiest way to use react-input-validation is to install it from NPM and include it in your own React build process (using Browserify, Webpack, etc).

You can also use the standalone build by including dist/react-input-validation.js in your page. If you use this, make sure you have already included React, and it is available as a global variable.

npm install react-input-validation --save

Usage

var FormInput = require('react-input-validation');

<FormInput
	text='Label text here'
	emptyMessage='this field is required'
	errorMessage='Not valid'
	type='number' // default is 'text'
	value={this.state.example || ''}
	onChange={prop => this._onChangeValue({prop})}
	validateType='email'
	onKeyPress={this.handleKeyPress}
	ref='email' />

Notes

You can pass the following props to the component:

  • onChange: function that will give you the value of input
  • onKeyPress: optional, for handling keypress on inputs
  • text: text of label
  • emptyMessage: this will be appeared when input is empty
  • errorMessage: this will be appeared when input is not valid
  • className: optional, give custom class name to input
  • placeholder: optional
  • type: type of input
  • value: value of input
  • validateType: there are built-in types for validating - ['email', 'required', 'onlyPositiveNumbers', 'url', 'password', 're_password', 'positiveNumberWithLimit', 'custom']
  • passwordMinLength: use if your validateType = 'password'
  • limitNumber: use if your validateType = 'positiveNumberWithLimit'
  • validatePattern: use if your validateType = 'custom', this should be valid regular expression
  • relValue: use if your validateType = 're_password'
  • withAddon: optional, text of addon, use in case you want to have bootstrap inputs with addon icons
  • addonPos: position of addon, default is 'right'
  • ref: always use this for validating (must be unique)

To check the validation there is a isValid() function which you can call with component ref. For more details take a look at _isAllValuesTrue() function which is in react-input-validation/example/src/example.js.

Development (src, lib and the build process)

NOTE: The source code for the component is in src. A transpiled CommonJS version (generated with Babel) is available in lib for use with node.js, browserify and webpack. A UMD bundle is also built to dist, which can be included without the need for any build system.

To build, watch and serve the examples (which will also watch the component source), run npm start. If you just want to watch changes to src and rebuild lib, run npm run watch (this is useful if you are working with npm link).

License

MIT

About

A small validation component for inputs which you can use everywhere and set any kind of validation you want to!

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published