react-controlled-inputs v1.3.3

react-controlled-inputs

Controlled react inputs with built-in formatting and auto-validations. Currently handles localized formatting for:

• numbers
• percentage
• currency

The inputs are set to behave more like Excel cells do. When an input is focused, it will initially select the entire range.

TODOs

• Implement the ability to add validations to any input.
• Implement more UI knobs to play around with the inputs in the playground (./www)
• Add visual buttons on the right side of a number input (to mimic the actual input type="text")
• Adapt the API and document the API to be more user-friendly (the API is still a wip)
• And more...

Supported locales

For now, supported locales are:

• English
• French

If there is need for more, feel free to report an issue on the matter.

Usage

Any prop passed to the input will be forwarded to the actual input HTML element. You can refer to https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input for possible attributes.

Possible locale props: ["EN", "FR"] (case insensitive)

Normal text input:

import { Input } from 'react-controlled-inputs';

<Input value={myValue} locale="FR" onChange={myFunc} />

Currency input:

import { CurrencyInput } from 'react-controlled-inputs';

<CurrencyInput value={myValue} locale="EN" onChange={myFunc} />

Percentage input:

import { PercentageInput } from 'react-controlled-inputs';

<PercentageInput value={myValue} locale="FR" onChange={myFunc} />

Styling

input's container:

id: if passed to the Input, the container will have the same id with -container appended.

className: react-input-container

actual input:

Any className or id passed as prop is forwarded to the input HTML element. In addition, the input will have the type of input as class in lower case separated by -.

• ex: for a CurrencyInput the class currency-input will be added to the input element

Formatting

To use the same formatter as used by the inputs elsewhere in your application (i.e. for a non-input numeric label):

import { formatter } from 'react-controlled-inputs';

class ExampleComponent extends React.Component {
    constructor(props) {
        super(props);

        this.f = new formatter(formatter.getSupportedLocales().EN);
    }

    changeLocale() {
        this.f.locale = formatter.getSupportedLocales().FR;
    }
}