Currency input

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 more best practices on building forms with inputs in Constellation, visit Pega Academy.

Example

Enter a numerical value

Displaying non-editable data

There are two methods of displaying non-editable information in Constellation: as a readonly field or a field-value list. The method used depends on the context and purpose of the information.

Readonly

Display a field as readonly to indicate that a user cannot edit a field due to form conditionality or role restrictions. This way, the field can be editable when certain conditions are met.

You can also display a field as readonly when doing so gives the user context, or completes the layout for a set of fields in a form. For example, in a set of address input fields, the “state” field may be readonly, while the “address”, “city”, and “zip code” fields may be editable.

Field-value list

Field-value lists also display non-editable information, but live outside of a form (often in a case's summary panel or details tab card). Display information in a field-value list when users need to reference the information to complete a form or review the information to verify form details.

Previously, in classic Pega, field-value list was referred to as "readonly". This was changed due to "readonly" being an HTML input attribute.

Configuration

To learn how to configure this component in your Constellation application, visit Pega Documentation.

All components shown on this site are supported by the Constellation design system. To learn how to configure Theme Cosmos, visit Pega Documentation.

Related components