×

Please give details of the problem

Skip to content

User and Lane Picker

The list widget of type "Users" or "Entities or roles" can be configured as a picker that provides suggestions while the user types into the field. It's an option that can be configured to let the users quickly find and select an item from a large list of users for example.

Configuration

To configure a user picker you can simply use the option "Picker" of the List widget (3 above), to use this option you should add a "Value variable" and a "Label variable" (1,3). The "Picker property" lets you specify the property that will be used to filter fetched data when the user starts typing (4).

ScreenHunter_290_Oct_16_16.14

A picker can be multi-selection as you can see above:

ScreenHunter_290_Oct_16_16.14

Since he's based on the List widget, a picker can use all his Javascript functions (getSelectedLabel, getSelectedValue, ...etc). He has a special function that let you set a picked item(s):

1
2
3
4
id_picker_list.setPicked('picked_item_label','picked_item_value');

// set multiple picked items when the picker is multi-selection
id_picker_list.setPicked('["item1_label","item2_label"]','["item1_value","item2_value"]');

You can also configure the minimum input length of the string that end the user will have to fill in for the research to be launched. We recommend to set this configuration to at least 2 characters. If you have hundreds of users on your account, setting it this to 1 character can crash your application.