---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ListBoxItem.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/llms.txt

# control.ListBoxItem

Расширяет [ICustomizable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md), [ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md).

Элемент раскрывающегося списка.

## Конструктор {#constructor}

```javascript
control.ListBoxItem([params[, options]])
```

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `params` | — | Тип: Object\|String

Параметры элемента либо строка - контент элемента. ||
|| `params.data` | — | Тип: Object

Данные элемента. ||
|| `params.data.content` | — | Тип: String

Содержимое элемента. ||
|| `options` | — | Тип: Object

Опции элемента управления. ||
|| `options.checkbox` | false | Тип: Boolean

Опция, которая определяет внешний вид стандартного макета. 
• true - слева от содержимого элемента отображается чекбокс;

• false - элемент выделяется галочкой справа от содержимого. ||
|| `options.layout` | — | Тип: Function\|String

Макет элемента управления. В конструктор макета передается объект, содержащий поля: 
• control - ссылка на элемент управления;

• options - менеджер опций элемента управления control.ListBoxItem.options;

• data - менеджер данных элемента управления [control.ListBoxItem.data](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ListBoxItem.md#data);

• state - менеджер состояния элемента управления [control.ListBoxItem.state](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ListBoxItem.md#state).

Макет меняет свой внешний вид на основе данных, состояния и опций элемента управления. Элемент управления, в свою очередь, реагирует на интерфейсные события макета и меняет значения полей [control.ListBoxItem.state](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ListBoxItem.md#state) в зависимости от полученных команд. (Тип: конструктор объекта с интерфейсом [ISelectableControlLayout](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControlLayout.md) или ключ макета). ||
|| `options.selectOnClick` | false | Тип: Boolean

Флаг, разрешающий автоматическое выделение элемента списка по клику. 
• true - элемент списка выделяется после клика;

• false - элемент списка не меняет свой внешний вид после клика. ||
|| `options.visible` | true | Тип: Boolean

Признак того, что элемент управления отображается. ||
|#

## Поля {#fields}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [data](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ListBoxItem.md#data) | [data.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/data.Manager.md) | Данные элемента списка. Имена полей, доступных через метод data.Manager.get: 
• content - cодержимое элемента списка в виде HTML. ||
|| [events](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventManager.md) | Менеджер событий.

Унаследовано от [IEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventEmitter.md#events). ||
|| [options](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#options) | [IOptionManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IOptionManager.md) | Менеджер опций.

Унаследовано от [ICustomizable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#options). ||
|| [state](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ListBoxItem.md#state) | [data.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/data.Manager.md) | Состояние элемента списка. Имена полей, доступных через метод data.Manager.get:
• selected - признак, выбран ли элемент списка;

• enabled - признак, активен ли элемент списка. ||
|#

## События {#events}

#|
|| **Имя** | **Описание** ||
|| [click](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ListBoxItem.md#event-click) | Выбор элемента списка. ||
|| [deselect](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#event-deselect) | Элемент управления не выбран.

Унаследовано от [ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#event-deselect). ||
|| [disable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#event-disable) | Элемент управления стал недоступным.

Унаследовано от [ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#event-disable). ||
|| [enable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#event-enable) | Элемент управления стал доступным.

Унаследовано от [ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#event-enable). ||
|| [mapchange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#event-mapchange) | Сменилась карта. Поля данных: 
• oldMap - старая карта;

• newMap - новая карта.

Унаследовано от [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#event-mapchange). ||
|| [optionschange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#event-optionschange) | Изменение в опциях объекта.

Унаследовано от [ICustomizable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#event-optionschange). ||
|| [parentchange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChild.md#event-parentchange) | Сменился родительский объект.

Поля данных:

• oldParent - старый родитель;

• newParent - новый родитель.

Унаследовано от [IChild](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChild.md#event-parentchange). ||
|| [select](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#event-select) | Элемент управления выбран.

Унаследовано от [ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#event-select). ||
|#

## Методы {#method}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [deselect](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#deselect)() |  | Отменяет выбор элемента управления (выключает).

Унаследован от [ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#deselect). ||
|| [disable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#disable)() |  | Делает элемент управления недоступным (запрещены пользовательские действия).

Унаследован от [ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#disable). ||
|| [enable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#enable)() |  | Делает элемент управления доступным (разрешены пользовательские действия).

Унаследован от [ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#enable). ||
|| [getParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControl.md#getParent)() | [IControlParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControlParent.md) | Returns ссылку на родительский объект.

Унаследован от [IControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControl.md#getParent). ||
|| [isEnabled](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#isEnabled)() | Boolean | Returns true - элемент управления доступен, false - недоступен.

Унаследован от [ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#isEnabled). ||
|| [isSelected](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#isSelected)() | Boolean | Returns true - элемент управления выбран, false - не выбран.

Унаследован от [ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#isSelected). ||
|| [select](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#select)() |  | Выбирает (включает) элемент управления.

Унаследован от [ISelectableControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ISelectableControl.md#select). ||
|| [setParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControl.md#setParent)([parent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControl.md#setParent-param-parent)) | [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md) | Устанавливает родительский объект.

Унаследован от [IControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControl.md#setParent). ||
|#

## Описание полей {#description-fields}

### data

```javascript
{data.Manager} data
```

Данные элемента списка. Имена полей, доступных через метод data.Manager.get:

• content - cодержимое элемента списка в виде HTML.

### state

```javascript
{data.Manager} state
```

Состояние элемента списка. Имена полей, доступных через метод data.Manager.get:

• selected - признак, выбран ли элемент списка;

• enabled - признак, активен ли элемент списка.

## Описание событий {#description-events}

### click

Выбор элемента списка.