Skip to main content
CYPEX Documentation
Support
v2.0.0 Latest stable release View changelog ->
Various Referencegenerated

Static Select

Choose from a fixed list of options

Technical id
default_static_select
Translation keys
labelemptyValueLabel

A dropdown whose options are typed into the configuration rather than loaded from the database.

When to use

  • A short, stable list that is not worth a database view — a status, a priority, a yes/no/unknown.

Examples

  • Priority: Low, Medium, High.

Avoid

  • Hard-coding a list that already exists as a table, which then has to be maintained in two places.
  • Using it for long lists; without search the user has to scroll.

Use instead

  • Autocomplete Input — Use instead when the options come from data, or when the list is long enough to need searching.
  • Radio Input — Use instead for a handful of options that should all be visible without opening a dropdown.

Editor properties

Configure these in the Application Designer property panel. Group headings mirror the editor where possible. Data Source is where the element gets its rows or field binding (a view/query, a connector operation, or a parent form field). References appear only for view-backed sources and map foreign-key ID columns to readable labels from another view.

Required
OptionsrequiredList of Not set (null)
Configuration for options.
Default: none
Optional
Data SourceoptionalSettings group
Where this element loads its data (view, query, connector, or element).
Default: none
Default ValueoptionalNot set (null)
Configuration for default Value.
Default: none
DisabledoptionalYes / no or Custom expression (yes/no)
When true, the control cannot be edited.
Default: none
NullableoptionalYes / no or Custom expression (yes/no)
Whether the field may be left empty.
Default: none

Inside dataSource: (dataSource)

Element IDrequiredNumber or Text
Another element on the page whose data backs this field.
Default: none
Field PathrequiredList of Text or Number
Path into the source element’s data (property segments).
Default: none
LabelrequiredText
Configuration for label.
Default: none
ValuerequiredText or Number
Configuration for value.
Default: none

Sizing

  • No size of its own: dropped at the platform default of 1 × 1 grid cells and resized on the page.

Values you can read in expressions

Other parts of your app can read live values from this element in custom expressions:

elements.myStaticSelect.<property>

value string Current input value of this control. elements.myStaticSelect.value

When The chosen option's stored value — commonly the condition behind a Conditional Container.

To use one of these, open the property you want to drive on the other element, switch it to expression mode in the Expression Editor, and enter:

1
elements.myStaticSelect.value

Replace myStaticSelect with this element’s unique id. Select the element in Application Designer and copy the id chip at the top of the right-hand property panel.

Where you can place it

Drag this element into one of these containers:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
{
  "config": {
    "options": [
      {
        "value": "value",
        "label": "Name"
      }
    ]
  }
}
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
{
  "config": {
    "dataSource": {
      "elementId": "myElement",
      "fieldPath": [
        "fieldPath"
      ]
    },
    "defaultValue": "defaultValue",
    "disabled": false,
    "nullable": false,
    "options": [
      {
        "value": "value",
        "label": "Name"
      }
    ]
  }
}