Dropdown list

To add a dropdown list to the task, use the {{#field type="select" name="<output field name>"}}... {{/field}}. The entries in the dropdown list are created using the nested expression {{select_item}}. Example:

{{#field type="select" name="colour" placeholder="Choose the color" width="200px"}}
  {{select_item value="red" text="Red"}}
  {{select_item value="green" text="Green"}}
{{/field}}

Add a string field to the output data description:

{
  "colour": {
    "type": "string",
    "required": true
  }
}
Full list of parameters

Parameter

Description

Required

Default value

type

Field type: select — Dropdown list.

yes

no

name

Attribute for the output data field. Contains the output field name.

yes

no

placeholder

The name of the dropdown list in the interface.

no

no

width

Width of the field. Set in the following units:

  • Pixels. For example, width="100px".

  • Percentage of the size of the parent element. For example, width="100%".

You can also use a formula for setting the width. For example, width="calc(100%-30px)".

no

depends on the length of the signature

validation-show

The position of popup hints (displayed if the response didn't pass validation). The position is relative to the input field.

Supported values:

  • Above the input field: "top-left", "top-center", "top-right".

  • Below the input field: "bottom-left", "bottom-center", "bottom-right".

  • To the left of the input field: "left-top", "left-center", "left-bottom".

  • To the right of the input field: "right-top", "right-center", "right-bottom".

  • Don't display the message ("false").

no

"top-left"
size

Size of the field.

Supported values: "S", "M", "L".

no

"L"
class

The CSS class for the field. For example, class="annotation".

no

".field" ".field_type_select"
disabled

Whether data can be edited:

  • disabled=true — Non-editable field.

  • disabled=false — Editable field.

no

false
mode

Direction in which the list expands:

  • mode="dropdown" — Down.

  • mode="dropup" — Up.

no

"dropdown"
value

Text to write to the output data file if the item is selected.

no

no
text

The name of the list item.

no

no

selected

The item selected by default:

  • selected=true — Make item selected by default.

  • selected=false — Leave item deselected by default.

no

false