Amber
  • Introduction

Administrator Guide

  • Installation
  • Configuration

Studio User Guide

  • Introduction
  • Content
    • Studies
    • Forms
    • Form Items
      • Auto Complete
      • Dropdown
        • Preview
        • Design
      • Image Select
      • Multiple Choices
      • Single Choice
      • Date
      • Date and Time
      • Time
      • Geographic data
      • Number
      • Rating
      • Slider
      • Paragraph
      • Short Answer
      • Group
      • Section
      • Toggle
      • Computed
    • Case Report Forms
    • Interviews
    • Records
  • Administration
  • Cookbook

Collect User Guide

  • Introduction

Visit User Guide

  • Introduction
Amber
  • Content
  • Form Items
  • Dropdown
  • View page source

Dropdown

The dropdown field captures a text or a list of texts. It has some “options”, i.e. possible values that are proposed in a dropdown menu.

This is the appropriate field for a compact rending of choices (as opposed to Single Choice or Multiple Choices fields), and when there are not too much options (see the Auto Complete field).

Preview

../../../_images/dropdown.png

The dropdown field proposes a list of choices to select in a menu.

Design

Definition

The standard properties apply:

Property

Definition

Type

The type of item (see above).

Name

The name of the item is not visible. It is a “variable” name that will be associated to the data collected. You will refer to this variable name when writing condition and/or validation scripts.

Label

The label is usually a question or a title.

Description

The description gives some guidance about how to enter data, what are their meaning etc.

Required

Whether an input is mandatory.
Note that this does not apply when the visibility Condition is not satisfied.

The following dynamic properties apply:

Property

Definition

Condition

The condition makes an item visible or not, depending of other data. It is a small script which returns a logical value: true when item is visible.
When no condition is specified (which is the default), the item is visible.
See How to make fields conditional?

Validation

The validation specifies whether the data entry is correct. It is a small script which returns a logical value: true when item value is valid.
Note that this validation script is not evaluated when the visibility Condition is not satisfied.
See How to validate field values?

Validation error message

The validation error message to be displayed when validation fails.

Settings

Property

Definition

Hint

Help text below the input field.

Default

The default value. Only a single value can be specified, even when Multiple choices is set.

Multiple choices

When selected, the captured data is a list of texts. Default is false, i.e. a single value is captured.

Options

The list of predefined values, either to be selected or used as suggestions. For provisioning a lot of options, see How to make a select with a lot of options?

Style

Property

Definition

Label class

CSS class to apply to the field label. See How to style a form item?

Previous Next

© Copyright 2022, OBiBa.

Built with Sphinx using a theme provided by Read the Docs.