A cell in a layout can present the value of a property, as display-only or as an input field. Follow these instructions to control the presentation of a property value in a Text Input control.
Configure styles for the Text Input control using the Skin rule. See Skin form — Components tab — Controls — Text inputs.
The Text Input control uses the auto-generated control pxTextInput. Its look and behavior are governed by the rule form's Control tab. The Parameters tab is not available and the HTML cannot be edited. As a best practice, do not modify a copy of the rule. Instead, use the Parameters dialog available in the control's Cell Properties panel while designing a section, flow action, or harness. See Completing the Control tab.
As a best practice, use the pxTextInput control in new development, rather than the non-auto-generated Default controls. See About the Input Box control.
The UI Gallery landing page contains a working sample. To view and interact with the sample, select Designer Studio > User Interface > UI Gallery. In the Components area, select Text Input.
Field |
Description |
Property |
Press the down arrow to select a property reference that identifies a single text value. Alternatively, you can drag a property name from the lists of properties visible in the Application Explorer. Typically, this works for Click Open icon to review the property (if the reference is to an existing property in the Applies To class of this rule or a parent of that class). If the property is not found, the New dialog box for the property form appears. You can reference properties on any page identified on the Pages & Classes tab, using the normal notation pagename.propertyname for pages other than the page corresponding to the Applies To class of the rule. If this field is in a cell of a section that includes parameter declarations on the Parameters tab, you can enter the notation param.NAME here, to use a parameter value for the field, where NAME identifies a string parameter. Make sure that the NAME parameter is declared on the Parameters tab, and that your application provides a non-blank value for the parameter value in all possible situations where the section appears. See Sections — Completing the Parameter tab. For a harness, the property generally must be on the primary page of the rule — the page corresponding to the Applies To key part of the rule. However, a section within the harness may have a different Applies To class, and that section can include properties from its own class. If this field is always displayed as read-only, you can enter a linked property reference here, of the form .AAAA.BBBB, where AAAA is the linked property and BBBB is any property reference in the object identified by the value of AAAA as a key. For example, if the property AAAA has a value corresponding to a key of a Data-Admin-Operator-ID instance, then .AAAA.pyUserName presents that Operator ID's full name. This allows values from that object to appear (read-only) in the run-time display, though your processing does not explicitly load the object onto the clipboard. |
Label |
Select to use the default label for the property or specify your own label. select or create a label.Use SmartPrompt to select a field value rule if you plan to localize the text. See About the Localization wizard. |
Default value |
Optional. Enter a constant value for the property value, a property reference, or an expression, to be used only when the user form or flow action form appears in read-write mode rather than read-only mode. Choose a default value that speeds data entry. When the system renders a harness or section in read-only mode (for example because the read-write mode requires a privilege that the current user does not hold), the default value does not appear, because data entry is not permitted. |
Placeholder |
Select None if you do not want to display placeholder text. Select Other if you want to display a hint or instructional text in the field. The text disappears when the user enters a value. If the user does not enter a value, the placeholder text reappears when the field loses focus. |
Tooltip |
Specify a tooltip to display when the user hovers the mouse pointer over the control. You can press the down arrow to select a property value or type the text that you want to display as the tooltip. As a best practice, start the sentence with a verb, either in the imperative ("Enter price of item here") or as an infinitive ("To cancel the order, click here"). Use SmartPrompt to select a field value rule if you plan to localize the text. See About the Localization wizard. |
Visibility |
To control the visibility of the label, select one of the following:
If this section is to become part of navigation in a composite portal, you can make the header visible only when a specific space is the current space. Enter an expression here similar to the following: pyCurrentSpace=="ASpaceName" Then select the Run visibility condition on client check box. |
Disable |
Select to disable the text input:
|
Required |
This box appears only for fields in cells on flow actions and sections. Select to require that (when the form appears at runtime in read-write mode) users cannot successfully submit the form if the field is blank. Selecting Required marks the label for this field with an orange asterisk when the flow action form appears in read-write mode. (The asterisk also appears if the Label control's Value For field is not blank and the Label control's Required box is checked.) For sections, checking this box enables client-side format validation when this section is part of a harness form that has the Enable Client Side Validation box selected on the HTML tab. At runtime, users who leave this field blank and submit the form are notified immediately that the field is required; the form is not transmitted to the server. |
Tour ID | Optional. Provide an ID for use in a guided tour. Use a combination of numbers, letters, and underscores. PRPC uses the Tour ID when it finds an anchor button during a tour stop anchor point. |
Test ID |
Optional. If authorized, you can provide a unique Test ID for use in your test suite in order to support better automated testing against any Pega application. When creating a control that supports Test ID, the Test ID field is initially blank. Use a combination of numbers, letters, and underscores, or click the Generate ID button to create a time stamp as a unique ID. The attribute data-test-id is then generated for the selected element. When you save an existing section, any supported controls that do not have a Test ID will have one automatically generated. You can override these with a custom ID at a later time. Once generated, you can view your Test ID in HTML or display it in the Live UI panel. You also have the option to have all controls that support Test IDs in a ruleset updated in bulk. A standard, out-of-the-box developer role, PegaRULES:SysAdm4, includes the privilege for Test ID. To disable Test ID for this role, modify the pxTestID privilege. |
Field |
Description |
||||||||||||||||||||
Edit Options | Select an edit mode for this control. The edit mode of the control takes precedence over section and harness settings.
|
||||||||||||||||||||
Read-only value | Appears only when you select Read Only in the Edit Options field. Enter or select one of the following:
As a best practice, use the Condition Builder to edit this field. Click the Open condition builder icon to open the tool. See Using the Condition Builder to configure dynamic UI actions. |
||||||||||||||||||||
Specify Size |
Specifies the width of the text input. Select Auto if you want the layout to determine the width of the control area. This is the default. |
||||||||||||||||||||
Min/Max Chars |
Optional.Enter a value that determines the minimum and maximum number of characters that can be entered in the text input. You can designate either value as unlimited by leaving it blank. |
||||||||||||||||||||
Control format | Optional. Specifies the style format applied to the control. You can define multiple formats in the skin rule. Press the down arrow to select another format, if applicable. | ||||||||||||||||||||
Label format | Read-only option. Specifies the format of the control's label. | ||||||||||||||||||||
Editable Format | |||||||||||||||||||||
Type
|
Select a type (editable) used with this property. Your selection filters the format options.
|
||||||||||||||||||||
Text Alignment |
Select left, right, or center alignment. |
||||||||||||||||||||
Advanced Options |
Note: As a best practice, define custom styles in the skin.
|
||||||||||||||||||||
Read-only format | |||||||||||||||||||||
Type |
Select a format (read-only) used with this property. Your selection filters the format options.
|
||||||||||||||||||||
DateTime Format
or Date Format |
Appears if Type is Select one of the following:
|
||||||||||||||||||||
Text Alignment |
Appears if Type is Select left, right, or center alignment. |
||||||||||||||||||||
Decimal Places |
Appears if Type is A non-negative integer to control the number of digits presented after the decimal place. The default is |
||||||||||||||||||||
Use native control on mobile |
Enables the use of native rendering on mobile devices. At runtime, the date and time pickers display using the mobile browsers native calendar date and time pickers. To enable native browser support, check the Use native control on mobile. The native control option only appears for the Date Time control types. |
||||||||||||||||||||
Display Read-only formatting |
At runtime, read-only formatting displays when the editable field is not in focus. When the editable field is in focus, it behaves as normal input. The actual value gets submitted although the formatted value is displayed. Editable formatting does not appear when there are client-side and server-side validations. To enable read-only formatting, check the Display value using read-only formatting check box. The read-only formatting option only appears for the Currency, Date Time, Integer, Number and Percentage control types when the Editable Format is Number. |
||||||||||||||||||||
Scale |
Appears if Type is Select a label indicating the scaling you wish to apply to the number. The scales are K for thousands, M for millions, B for billions, and T for trillions. For instance, if you select |
||||||||||||||||||||
Negative Format |
Appears if the Type is Select a format (minus sign or parenthesis) for displaying negative numbers. You can also specify a CSS class if you select one of the |
||||||||||||||||||||
Show validation messages in read-only mode |
Check this option to display validation errors to users at runtime. When enabled for auto-generated controls in read-only mode, if the control's validation fails, the validation message displays to the user. This option is available in the Presentation tab under Read-only Format. It is also available in the control ruleform. When enabled on the control ruleform, all controls using that ruleform will have the option enabled. Show validation messages in read-only mode is disabled by default. |
||||||||||||||||||||
Symbol |
Appears if Type is Select an option for representing the number as
|
||||||||||||||||||||
Rounding Method |
Specifies how halfway values are handled:
|
||||||||||||||||||||
Separators |
Appears if Type is Select to use a thousands' separator. Depending upon the default locale, a comma or period is used. |
||||||||||||||||||||
Obfuscated |
Appears if the Read-only format Type is Text. Select |
||||||||||||||||||||
Auto Prepend |
Appears if Type is Select a property or constant that you want to add either before the displayed property value. For example, when the user name appears, the system can automatically prepend the user's title. |
||||||||||||||||||||
Auto Append |
Appears if Type is Select a property or constant that you want to add after the displayed property value. For example, when the user name appears, the system can automatically append the full mail extension to the name. |
||||||||||||||||||||
Show Value As |
Appears if the Type is Select to label either outcome using Text or an Image. |
||||||||||||||||||||
True Image
False Image |
Appears if the Type is Select an image to label either outcome. Used with a boolean type. |
||||||||||||||||||||
True Text
False Text |
Appears if the Type is Enter a text string to label either outcome. Used with a boolean type. If the Localize? check box is selected on the section's HTML tab, a SmartPrompt Appears in the Constant field in the Parameters dialog. Select a field value rule if you plan to localize the text. If this text is to be localized, enter no more than 64 characters. A field value rule with pyCaption as the second key part and this text as the final key part is needed for each locale. |
Use these Windows operations to speed development: