mirror of
https://github.com/Alfresco/alfresco-ng2-components.git
synced 2025-07-24 17:32:15 +00:00
[ADF-4713] Add new DecimalNumber Pipe to transform and localize numbers (#4926)
* [ADF-4713] Add new DecimalNumber Pipe to transform and localize numbers * Unsubscribe from userPreference service * Make Pipe impure * Add documentation in localization page
This commit is contained in:
committed by
Eugenio Romano
parent
8ee5cd1908
commit
a0d4160c11
53
docs/core/pipes/decimal-number.pipe.md
Normal file
53
docs/core/pipes/decimal-number.pipe.md
Normal file
@@ -0,0 +1,53 @@
|
||||
# [Decimal Number Pipe](../../../lib/core/pipes/decimal-number.pipe.ts "Defined in multi-value.pipe.ts")
|
||||
|
||||
Transforms a number to have a certain amount of digits in its integer part and also in its decimal part.
|
||||
|
||||
## Basic Usage
|
||||
|
||||
### Properties
|
||||
|
||||
| Name | Type | Default value | Description |
|
||||
| ---------- | ---------------------------------------------------------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------- |
|
||||
| digitsInfo | [DecimalNumberModel](../../../lib/core/models/decimal-number.model.ts) | | A format to apply to the date value. [Date Pipe Formats.](https://angular.io/api/common/DatePipe#custom-format-options) |
|
||||
| locale | string | 'en-US' | A locale id for the locale format rules to use. |
|
||||
|
||||
## Details
|
||||
|
||||
This pipe transforms a given number so it follows the set configuration for the pipe. You can change this configuration by changing the parameters in your `app.config.json`.
|
||||
|
||||
```json
|
||||
"decimalValues": {
|
||||
"minIntegerDigits": 1,
|
||||
"minFractionDigits": 0,
|
||||
"maxFractionDigits": 2
|
||||
}
|
||||
```
|
||||
|
||||
You can also overwrite this config by passing a [DecimalNumberModel](../../../lib/core/models/decimal-number.model.ts) as an argument for this pipe.
|
||||
|
||||
The number can be also localized so it applies commas and dots in the right place depending on the locale id in use.
|
||||
|
||||
#### Result
|
||||
|
||||
```ts
|
||||
decimalNumberPipe.transform(1234.567);
|
||||
//Returns '1,234.57'
|
||||
|
||||
decimalNumberPipe.transform(1234.567, digitsConfig, "it");
|
||||
//Returns '1.234,57'
|
||||
```
|
||||
|
||||
And now with a different config:
|
||||
|
||||
```ts
|
||||
digitsConfig = {
|
||||
minIntegerDigits: 6,
|
||||
minFractionDigits: 4,
|
||||
maxFractionDigits: 4
|
||||
};
|
||||
|
||||
decimalNumberPipe.transform(1234.567, digitsConfig);
|
||||
//Returns '001,234.5670'
|
||||
```
|
||||
|
||||
More info: [Angular DecimalPipe](https://angular.io/api/common/DecimalPipe)
|
Reference in New Issue
Block a user