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



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

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

.. code-block:: js

    {
        "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"                // локаль справочника
            }
    }

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

.. code-block:: js

    {
        "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": ""
            }
        ]
    }


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

.. code-block:: js

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



--------------------------------------------------------------------------------

.. js:class:: AS.FORMS.ComboBoxModel

    Модель компонента, наследует :js:class:`AS.FORMS.Model`

    .. js:data:: listElements

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

    .. js:data:: listCurrentElements

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

    .. js:function:: getTextValue()

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

        :returns: ``String`` наименование выбранного компонента

    .. js:function:: getValue()

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

        :returns: ``[String]`` массив из одного элемента с выбранным значением

    .. js:function:: setValue(newValue)

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

        :param Array newValue: значение

    .. js:function:: updateModelData()

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




--------------------------------------------------------------------------------


.. js:class:: AS.FORMS.ComboBoxView

    Отображение компонента, наследует :js:class:`AS.FORMS.View`