Skip to main content

Dropdown

What is the Form Dropdown?​

With the dropdown form type you can select a single item from a dropdown list.

dropdown.png

Options​

Specifies the selections that will be rendered. Selections are separated by new lines, each new line (enter press) is a new entry. Clear entries won't show up. Each entry can be specified by a tag to be ‘selected’, ‘correct’ or both at the same time. The tags that are used to specify the entry are cut off, the rendered label won’t contain it.
Specifying tags:

  • [!] - Correct entry
  • [*] - Selected entry
  • [!*] or [*!] - Selected entry that is also correct

Some examples:

  • [*]Large will be rendered as: Large and it'll also be selected.
  • [!*]Small will be rendered as: Small and it'll also be selected and correct selection at the same time

Setting Mock field and own value​

The Dropdown sets its own value and tries to write to mock, when:

  • the Dropdown is rendered,
  • every selection made,
  • when an external message tells it to change value.

Validation​

If validation is enabled, and when a selection is made, the form will evaluate the selections. If the selection is correct, then the field is evaluated to be valid, when a wrong option's selected the dropdown is evaluated to be invalid.

Note

There may be more than one or even no correct options available. The validity is according to the selected options correctness.

Sensor Events​

The dropdown only sends out one external message; when it's validity is evaluated.

{FORM-NAME}-valid value: [true/false]

  • The {FORM-NAME} is what we gave to the dropdown.
  • The value of this sensor event is either true or false, according to the validity of the validation result.

For Example: example-dropdown-valid is a possible sensor event with the value of true.

External Messages​

The dropdown listens to all three basic external messages

  • Set Form: Takes the value from the message, splits it up exactly like the Values option in the editor, and replaces the selections with the new options. Updates the Mock and own value. Please note that if the messages value results in no select option, the message is ignored, the mock and own value won't update.
  • Clear Form: Removes the selections that is made, sets it to the first option, updates the mock and the own value accordingly.
  • Reset Form: Restores the dropdown to how it would first appear, updates the mock and own value accordingly, also updates the validity.

Value from Datasource​

If an external datasource's array has been given to the dropdown, it takes the arrays elements converts them to select options the same way with the Values options from the editor, and places it after them.

Last updated on