position - задает позиционирование раскрывающегося списка. Атрибут может принимать два значения: TOP, BOTTOM. По умолчанию TOP.

Атрибут inline задает отображение списка выбранных значений: вертикально или горизонтально. Значение true соответствует горизонтальному расположению, значение false − вертикальному. Так выглядит компонент с горизонтальным расположением значений:

simple - значение true позволяет убрать компонент выбора, оставляя только кнопку добавления и очистки списка. При нажатии на кнопку добавления Add сразу показывается экран списка экземпляров сущности, тип которой задан контейнером данных. Идентификатор экрана выбора определяется по правилам, описанным для стандартного действия LookupAction для PickerField. Кнопка очистки списка Clear удаляет все элементы из контейнера данных компонента TokenList.

clearEnabled - значение false позволяет скрыть кнопку очистки Clear.

lookup − описатель компонента выбора значений.

addButton − описатель кнопки добавления значений. Может содержать атрибуты caption и icon.

setOptionsList() позволяет программно задать список опций компонента. Для этого объявляем компонент в XML-дескрипторе:

<tokenList id="tokenList"
           dataContainer="orderDc"
           property="items"
           width="320px">
    <lookup/>
</tokenList>

@Inject
private TokenList<OrderItem> tokenList;
@Inject
private CollectionContainer<OrderItem> allItemsDc;

@Subscribe
public void onAfterShow(AfterShowEvent event) {
    tokenList.setOptionsList(allItemsDc.getItems());
}

@Inject
private TokenList<OrderItem> tokenList;
@Inject
private CollectionContainer<OrderItem> allItemsDc;

@Subscribe
public void onAfterShow(AfterShowEvent event) {
    tokenList.setOptions(new ContainerOptions<>(allItemsDc));
}

Декларативно, используя аннотацию @Install в контроллере экрана:

@Inject
private CollectionContainer<Tag> tagsDc;
@Inject
private Metadata metadata;

@Install(to = "tokenList", subject = "newOptionHandler")
private void tokenListNewOptionHandler(String string) {
    Tag newTag = metadata.create(Tag.class);
    newTag.setName(string);
    tagsDc.getMutableItems().add(newTag);
}

Программно с помощью метода setNewOptionHandler():

@Inject
private CollectionContainer<Tag> tagsDc;
@Inject
private Metadata metadata;
@Inject
private TokenList<Tag> tokenList;

@Subscribe
public void onInit(InitEvent event) {
    tokenList.setNewOptionHandler(string -> {
        Tag newTag = metadata.create(Tag.class);
        newTag.setName(string);
        tagsDc.getMutableItems().add(newTag);
    });
}

ItemClickListener позволяет отслеживать клики по элементам tokenList.

ValueChangeListener отслеживает изменения значения`tokenList`, так же как и любого другого компонента, реализующего интерфейс Field. Источник события ValueChangeEvent можно отследить с помощью метода isUserOriginated().