---
metadata:
  - name: generator
    content: Diplodoc Platform v5.37.1
alternate:
  - https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/listboxitem.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v1-1/doc/ru/llms.txt

# YMaps.ListBoxItem

Расширяет [YMaps.IToolBarItem](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/itoolbaritem.md).

Элемент раскрывающегося списка [YMaps.ListBox](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/listbox.md).
## Конструктор

Имя | Описание
----- | -----
[YMaps.ListBoxItem](listboxitem.md#constructor)(caption) | Создает элемент раскрывающегося списка [YMaps.ListBox](listbox.md).


## Поля

Имя | Описание
----- | -----
[Events](listboxitem.md#Events) | Список событий элемента раскрывающегося списка.

## События

Имя | Описание
----- | -----
[Click](listboxitem.md#event-Click) | Щелчок по элементу раскрывающегося списка.

## Методы

Имя | Возвращает | Описание
----- | ----- | -----
[getCaption](listboxitem.md#getCaption)() | String | Возвращает текущий заголовок элемента раскрывающегося списка.
[getListBox](listboxitem.md#getListBox)() | [YMaps.ListBox](listbox.md) | Возвращает объект раскрывающегося списка [YMaps.ListBox](listbox.md), в который добавлен элемент.
[setCaption](listboxitem.md#setCaption)(caption) |  | Устанавливает новый заголовок для элемента раскрывающегося списка.

## Наследуемые методы

Из [YMaps.IToolBarItem](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/itoolbaritem.md): 
: [onAddToToolBar](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/itoolbaritem.md#onAddToToolBar), [onRemoveFromToolBar](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/itoolbaritem.md#onRemoveFromToolBar)

## Подробное описание конструктора {#constructor}

```javascript
YMaps.ListBoxItem(caption)
```

Создает элемент раскрывающегося списка [YMaps.ListBox](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/listbox.md).

**Параметры:**

Имя | Тип | Описание
----- | ----- | -----
`caption` | String | Заголовок элемента.

## Подробное описание полей {#field_detail}

### Events {#Events}

```javascript
Object Events
```

Список событий элемента раскрывающегося списка.

## Подробное описание событий {#event_detail}

### Click {#Click}

```javascript
Click
```

Щелчок по элементу раскрывающегося списка. В callback-функцию передается ссылка на элемент списка, для которого был вызван обработчик.
## Подробное описание методов {#method_detail}

### getCaption {#getCaption}

```javascript
{String} getCaption()
```

Возвращает текущий заголовок элемента раскрывающегося списка.

**Возвращает:**

Тип | Описание
----- | -----
String | Текущий заголовок элемента списка.

### getListBox {#getListBox}

```javascript
{YMaps.ListBox} getListBox()
```

Возвращает объект раскрывающегося списка [YMaps.ListBox](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/listbox.md), в который добавлен элемент.

**Возвращает:**

Тип | Описание
----- | -----
[YMaps.ListBox](listbox.md) | Родительский элемент. тулбара.

### setCaption {#setCaption}

```javascript
setCaption(caption)
```

Устанавливает новый заголовок для элемента раскрывающегося списка.

**Параметры:**

Имя | Тип | Описание
----- | ----- | -----
`caption` | String | Новый заголовок элемента списка.