Text input
The text input component allows users to enter and edit a single line of free-form text.
Usage
Text is the default input type. Any keyboard text may be entered, including numbers and symbols.
For best practices on building forms with inputs in Constellation, visit Pega Academy.
Example
Display options
Required
This will prevent any form submission until the required input is complete.
Disabled
You may wish to disable an input field in order to prevent a user from entering or editing any information while some task is being completed, or to restrict a user's access.
Readonly
The user will not be able to edit the text input if it is readonly.
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.