React-AutoNumeric: [AutoNumeric][]-Powered React Components


[AutoNumeric][] is a powerful library that automatically format numbers and currencies.
React-AutoNumeric brings that power to React.

Install

``
npm install --save react-autonumeric
`

Usage

$3

`tsx

`

creates an [input component][] that is automatically formatted by AutoNumeric.

$3

`tsx
inputProps={{ defaultValue: "99.99" }}
autoNumericOptions={{ suffixText: "%" }}
/>
`

$3

`tsx
inputProps={{ defaultValue: "10000" }}
autoNumericOptions={
AutoNumeric.getPredefinedOptions().commaDecimalCharDotSeparator
}
/>
`

$3

`tsx
const [controlledInputState, setControlledInputState] = useState("100000");

valueState={{
state: controlledInputState,
stateSetter: setControlledInputState,
}}
/>
onClick={() => {
setControlledInputState(
(
Number(AutoNumeric.unformat(controlledInputState)) + 1
).toString(),
);
}}
>
Add one

`

$3

For more detailed usage, check out the {@link AutoNumericInput} in the [API References][].

$3

If you would like a component other than input that is automatically formatted by AutoNumeric,
please consult {@link AutoNumericComponent} in the [API References][].

Demo

There is a publicly available live demo.

Related Project

If you use [Material UI][], check out [material-ui-autonumeric][].

License

`text
Copyright 2024 8 Hobbies, LLC

Licensed under the Apache License, Version 2.0(the "License");
you may not use files in this project except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
``

[AutoNumeric]: https://autonumeric.org/
[input component]: https://react.dev/reference/react-dom/components/input
[API References]: https://react-autonumeric.8hob.io
[Material UI]: https://mui.com/material-ui/
[material-ui-autonumeric]: https://material-ui-autonumeric.8hob.io/