lion/packages/input-amount/README.md
Thomas Allmer ec8da8f12c feat: release inital public lion version
Co-authored-by: Mikhail Bashkirov <mikhail.bashkirov@ing.com>
Co-authored-by: Thijs Louisse <thijs.louisse@ing.com>
Co-authored-by: Joren Broekema <joren.broekema@ing.com>
Co-authored-by: Gerjan van Geest <gerjan.van.geest@ing.com>
Co-authored-by: Erik Kroes <erik.kroes@ing.com>
Co-authored-by: Lars den Bakker <lars.den.bakker@ing.com>
2019-04-26 10:37:57 +02:00

42 lines
1.1 KiB
Markdown

# Input Amount
[//]: # (AUTO INSERT HEADER PREPUBLISH)
`lion-input-amount` component is based on the generic text input field. Its purpose is to provide a way for users to fill in an amount.
## Features
- based on [lion-input](../input)
- makes use of [formatNumber](../localize/docs/number.md) for formatting and parsing.
- option to show currency as a suffix
- option to override locale to change the formatting and parsing
- option to provide additional format options overrides
- default label in different languages
- can make use of number specific [validators](../validate/docs/DefaultValidators.md) with corresponding error messages in different languages
- isNumber (default)
- minNumber
- maxNumber
- minMaxNumber
## How to use
### Installation
```
npm i --save @lion/input-amount
```
```js
import '@lion/input-amount/lion-input-amount.js';
// validator import example
import { minNumberValidator } from '@lion/validate';
```
### Example
```html
<lion-input-amount
name="amount"
currency="USD"
.errorValidators="${[['required'], minNumberValidator(100)]}"
></lion-input-amount>
```