brcarey / chillisource.web.forms

:memo: Form and form elements built in React

ChilliSource.Web.Forms

This project is part of the ChilliSource framework developed by BlueChilli.

Summary

ChilliSource.Web.Forms is a collection of React form components, helpers and abstractions that are shared across all React-based ChilliSource.Web frameworks.

Main Features

Reusable Components

Standard components like input, button and the rest are already available to use directly in React projects. Our components build upon these standard components to provide React-style way of using them. The list:

• CheckBox
• DatePicker
• DropZone
• Form
• Input
• Number
• Radio
• Select
• Switch (base component for CheckBox & Radio)
• TextArea

State Retention

The state of the form is stored within the Form itself. Although this framework can be used with Redux, not having it within your stack will not prevent you from using it.

Validations

All the components can have their own validation(even custom validation is allowed) with custom validation messages as your project requires. The Validation component provides the necessary implementation so that you can directly start using them.

<Input name="sample-input" required maxLength="6">
  <Validation isFor="required">This input can not be blank.</Validation>
  <Validation isFor="maxLength">You can only enter a max of 50 characters</Validation>
</Input>

Installation

The library is available via NPM here

npm install --save cs.forms

Releases

See the releases.

Contribution

Please see the contribution guide.

License

ChilliSource.Web.Forms is licensed under the MIT license.

Feedback and Contact

For questions or feedback, please contact us at [email protected]