Skin form — Components tab — Controls — Autocomplete
Styles set here apply to text that the user enters in an Autocomplete input field.
An Autocomplete input field on a form supports user selection of a text value from a large list of candidate values. After the user types one or more characters, a filtered list of qualifying text values is displayed below the input field. The user can then select a value from this list.
The styles set here apply to both the standard and legacy Autocomplete controls. However, some styling elements are available only for the standard Autocomplete control. As a best practice, update legacy Autocomplete controls to standard Autocomplete controls. See Upgrading deprecated and outdated controls on the Pega Community.
You can modify the Standard style in the skin or create custom button formats.
A preview of the currently selected format displays to the right. You can also preview formats by selecting Run Process, Open Portal, Harness Preview, UI Gallery Preview, Skin Preview.in the toolbar and then selecting one of the following preview options:
Settings that you specify in this section apply to the text that the user enters in the Autocomplete input box.
Select this check box to define a custom text format:
Settings in this section apply to the border of the Autocomplete input box.
You can specify the Top , Left , Right , or Bottom border as none, solid, dashed, or dotted, rather than inheriting the style from the selected mixin.
You can specify a custom border by selecting or clearing the Apply to all sides check box:
The following border styles are available:
Settings in this section apply to the background of the Autocomplete input box.
Select this check box to define a custom background:
Select the background Type:
Use the options in this section to style the control based on its state. You can style the control differently when it is in one of the following states:
- :hover – State of the control when a user points to the control or rests the pointer on the control.
- :focus – State of the control when the field is in focus, for example, the state of a text field when it is ready to accept inputs.
- :active – State of the control when the field is ready to be activated, for example, when a user has clicked the control but has not yet released the mouse button.
- Auto – Select this option to apply auto-generated styles for the control in this state. These styles are generated based on the applied control format and the mixins defined within the format.
- Default – Select this option to apply the default browser styles for the states instead of generating the styles based on a skin or defined CSS in the application.
- Custom – Select this option to define your own styles for the element in this state.
Creating a custom Autocomplete format
- Click Add a format.
- In the Create a new format dialog box, enter the Format name by using only alphanumeric characters (a-z and 0-9) and spaces. The name cannot begin with a number. The format name that you enter is converted into the name CSS class or classes.
- Optional: Provide a Usage annotation.
- Click OK. The new format is populated with default values.
Applying a custom Autocomplete format
- In the cell containing the Autocomplete control, click the View properties icon to open the Cell Properties panel.
- On the Presentation tab, press the down arrow in the Style field to select the custom format that you want to use.
- Source of autocomplete field values
Autocomplete controls save time and ensure accuracy by supplying a list of possible values for an input field, based on characters that the user enters.