Selector: General Information

A selector control that consists of a box to hold a selected value and a lookup table where a user can select a value, as shown in the following screenshot.

Figure 1. The Selector controls


A selector control is defined by PXSelector in the Classic UI. In the Modern UI, a selector control is defined by the field tag (whose control type is automatically defined as a selector from the backend code). In rare cases, a selector control in the Modern UI is defined explicitly by the qp-selector control.

Learning Objectives

In this chapter, you will learn the following about a selector control:

  • The design guidelines for the selector control, including the naming conventions and layout recommendations
  • The proper configuration of the selector control for specific cases, such as when it should display a link to a record
  • A detailed description of each property of the selector control
  • Differences between the selector control in the Classic UI and in the Modern UI

Applicable Scenarios

You configure a selector control in the following cases:

  • A user needs to select a record from a list of possible records.
  • You need to display a box or a column with a record identifier.
  • You need to display the unique identifier of the existing record or the new record.
  • A user needs to be able to open the record by clicking on the link.

UI Naming Conventions

The following table shows the UI naming conventions for a selector control.

Naming Convention Example
For the label before the selector control:

use a noun or noun phrase that describes the content of the element.

Preferably, this label should consist of no more than two words.
Note: Use ID in this name according to the following guidelines:
  • You use ID in the name if in this element, only the identifier of the entity can be selected and displayed (as shown in the Customer ID box in the second screenshot).
  • You do not use ID in the name if in this element, the identifier and the name of the entity (separated by a hyphen) is displayed (as shown in the Customer box in the first screenshot).