This tutorial is for the new, online project designer. The tutorial for the Desktop Designer is available
here
.
The Drop List point can be used to display a list of items in a drop down interface. This point is similar to the Selection point but is more suitable for displaying a large list of items. This point is highly customisable and can be configured to allow single or multiple values to be selected and can optionally display an empty item to allow deselection. The list of options can contain values that have a different value to what is displayed and can optionally provide the user with the ability to create new options, while a session is being created.
The Drop List point can be configured in the designer to set the data for the list of items and to choose how the point functions within a session on the mobile application. See below for details on each of this point's properties.
The items section allows you to create the list of options that will be presented to the user when a session
is being created on the mobile application. The items editor window allows you to manually add, edit, delete, re-order items.
To easily create multiple items you paste a list of text items or use the import button. When the
code-based
feature is enabled, the list will provide you with options for each item's value and display text.
.
This allows you to select an item(s) that will be selected by default when a new session is created on a mobile device.
When enabled, an empty item will be automatically included as the first entry in the list of items. This is useful for allowing de-selection of entries.
The size of the point can be adjusted to either a set character size or to use the full width of the screen.
These options control how the point will function on the mobile application. These can be configured using
the list of
Preset Style
options or by manually toggling the checkboxes for particular features. The
Preset Styles
are explained below:
Similar to the
Single Selection
option except that the list of items can contain
code-based items
.
Similar to the
Multiple Selection
option except that the list of items can contain
code-based items
.
A powerful feature of the Drop List point is that it can provide the user with the ability to add a custom
item to the list while creating a session. When this point is configured with either of the style options;
Single selection, editable
or
Single selection, edit & save
, the user will be able to tap on the point and type a custom value which will be saved to the session's data
when the session is finished. Additionally, when the point is configured to use the
edit & save
style, the custom entry will be saved to the point's list of items. The item can then be re-used
on any new sessions created in the same project, on the same mobile device. Custom entries that are created
this way can also be removed from the point's item list by doing the following:
Apple iOS Devices | When the point is displaying the list of options, swipe the custom item from right to left to reveal the delete button. Tap the delete button to remove this item from the list. |
Google Android Devices | When the point is displaying the list of options, tap and hold on the custom item to bring up the prompt to delete the item. |
A Drop List point can easily be converted to a
Selection point
which can be useful for displaying a smaller list of items on screen at the same time. This can be done
by clicking the
Convert to Selection Point
button. Similarly a
Selection point
can be converted to a Drop List point.
The
Basic Points Sample
project contains examples of how to use many of the various points that are available. This project also contains a
page that demonstrates some of the ways that this point can be used in your projects.