Currency input allows a user to enter a monetary value that will be auto-formatted to match a particular currency, such as pounds sterling, euros, dollars, etc.
The currency component will only allow a user to enter numerical data, and any other characters will be ignored.
Usage
The currency component can be configured to have a prefix, suffix, or both (e.g., $, USD). It can be displayed prefilled with a value, in which the default is set to “0.00”, or the international equivalent.
The formatting for the currency (e.g., separators, decimals), as well as any numerical formatting necessary for a particular locale, will be applied as a user types. All numeric fields (including currency, integer, decimal, and percentage fields) always include thousands separators.
For best practices on building forms with inputs in the design system, visit the Forms page under Patterns.
Display options
Required
This will prevent any form submission until the required selection is made.
Readonly
Readonly inputs are typically recommended to use when they provide information that a user shouldn’t edit, but makes sense in the logical order of the form. (e.g. A state input may be readonly based on certain business restrictions, but the street and province or state are freely editable.) This is different than statically rendered text within the UI.
Disabled
Not recommended, has serious accessibility implications.
Configuration
To learn how to configure this component in a Pega application, visit Pega Documentation.
All information on this site is for Pega’s UX design system, also known as Constellation (from 8.8 and onwards). If you have questions, concerns, or any other feedback, please reach to us on Pega Support and include the capability ‘User Experience’ and ‘Constellation’ in your request.
Related components