3.5.3.8. «Выпадающий список»

Описание компонента выглядит следующим образом

Выпадающий список с системным справочником в качестве элементов

{
    "id": "listbox-cmp",
    "type": "listbox",
    "style": {},
    "config": {
        "read-only": false,
        "depends": "listbox-linked",  // связь с компонентом
        "script": ""
    },
    "required": false,
    "dataSource": {                 // источник данных компонента (только для справочника)
        "type": "dict",               // тип данных
        "dict": "year",               // код справочника
        "key": "title",               // код поля справочника для наименования элемента
        "value": "value",             // код поля справочника для значения элемента
        "filter": "value",            // код поля справочника для фильтра элемента
        "locale": "ru"                // локаль справочника
        }
}

Выпадающий список со встроенным справочником

{
    "id": "listbox-linked",
    "type": "listbox",
    "style": {},
    "config": {
        "read-only": false,
        "script": ""
    },
    "required": false,
    "elements": [
        {              // элементы справочника
            "value": "2016",          // значение элемента
            "label": "Обезьяна",      // наименование элемента
            "filter": ""              // фильтр элемента
        }, {
            "value": "2015",
            "label": "Коза",
            "filter": ""
        }, {
            "value": "2014",
            "label": "Лошадь",
            "filter": ""
        }, {
            "value": "2013",
            "label": "Змея",
            "filter": ""
        }
    ]
}

Модель данных компонента

{
    "id": "listbox-cmp",
    "type": "listbox",
    "value": "2014 год",  // наименование выбранного элемента
    "key": "2014"         // значение выбранного элемента
}
class AS.FORMS.ComboBoxModel()

Модель компонента, наследует AS.FORMS.Model()

AS.FORMS.ComboBoxModel.listElements

[{value : «value1», key : «key1»}, …] массив всех элементов компонента не зависимо от фильтра

AS.FORMS.ComboBoxModel.listCurrentElements

[{value : «value1», key : «key1»}, …] массив элементов компонента согласно фильтру, если таковой имеется, либо массив всех элементов

AS.FORMS.ComboBoxModel.getTextValue()

Получить наименования выбранных элементов

Результат:String наименование выбранного компонента
AS.FORMS.ComboBoxModel.getValue()

Получить значения выбранных элементов

Результат:[String] массив из одного элемента с выбранным значением
AS.FORMS.ComboBoxModel.setValue(newValue)

Вставить значение

Аргументы:
  • newValue (Array) – значение
AS.FORMS.ComboBoxModel.updateModelData()

Обновить данные текущих элементов компонента согласно фильтрам

class AS.FORMS.ComboBoxView()

Отображение компонента, наследует AS.FORMS.View()