Skip to content

Repository files navigation

react-amount-field

npm versionBuild StatuscodecovCode Climate

React component for displaying input field transforming decimal value to cent value. It will by example transform 3.56 to 356.

Demo & Examples

Live demo: jtassin.github.io/react-amount-field

To build the examples locally, run:

npm install
npm start

Then open localhost:3000 in a browser.

Installation

The easiest way to use react-amount-field 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/ReactAmountField.min.js in your page. If you use this, make sure you have already included React, and it is available as a global variable. If you want to use the redux-form/material-ui connector, you also need to include material-ui in your dependencies.

npm install react-amount-field --save

or

yarn add react-amount-field

Usage

One installed, just require and use the component:

importReactfrom `react`;import ReactDOM from `react-dom`;importAmountFieldfrom'react-amount-field';ReactDOM.render(<AmountFieldvalue="1337"><inputtype="text"/></AmountField>,document.querySelector('#main'));

Properties

PropsOptionsDefaultDescription
valueString/NumbernullThe value of the field in cents

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.

License

MIT, see LICENSE for details.

Contributors

Julien TASSIN
Julien TASSIN

Copyright (c) 2016 Julien TASSIN.

About

React component for displaying input field handling currencies

Topics

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages