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

# YMaps.IToolBarItem

Интерфейс элемента управления, добавляемого на тулбар.
## Конструктор

Имя | Описание
----- | -----
[YMaps.IToolBarItem](itoolbaritem.md#constructor)() | Интерфейс элемента управления, добавляемого на тулбар.

## Методы

Имя | Описание
----- | -----
[onAddToToolBar](itoolbaritem.md#onAddToToolBar)(toolBar, parentContainer, group) | Вызывается при добавлении элемента управления на тулбар.
[onRemoveFromToolBar](itoolbaritem.md#onRemoveFromToolBar)() | Вызывается при удалении элемента управления с тулбара.


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

```javascript
YMaps.IToolBarItem()
```

Интерфейс элемента управления, добавляемого на тулбар.

**Пример:**

```javascript
// Создает пользовательскую кнопку тулбара в виде раскрывающегося списка городов.
// При выборе города из списка центр карты перемещается в соответствующую точку.
var MyButton = function () {
    var element = document.createElement('select'),
        toolBar;

    var option1 = document.createElement('option');
    option1.value = '37.511553,55.749288';
    option1.selected = 'selected';
    option1.innerHTML = 'Москва';
    element.appendChild(option1);

    var option2 = document.createElement('option');
    option2.value = '30.260577,59.888582';
    option2.innerHTML = 'Санкт-Петербург';
    element.appendChild(option2);

    function showSelection () {
        toolBar.getMap().setCenter(YMaps.GeoPoint.fromString(element.options[element.selectedIndex].value));
    }

    this.onAddToToolBar = function (oToolBar, parentContainer) {
        toolBar = oToolBar;
        parentContainer.appendChild(element);
        element.onchange = showSelection;
    }

    this.onRemoveFromToolBar = function () {
        element.onchange = null;
        element.parentNode.removeChild(element);
    }
}

var map = new YMaps.Map(document.getElementById('YMapsID')),
    toolbar = new YMaps.ToolBar(new MyButton());
map.setCenter(new YMaps.GeoPoint(37.632404, 55.749288), 9);
map.addControl(toolbar);
```
## Подробное описание методов {#method_detail}

### onAddToToolBar {#onAddToToolBar}

```javascript
onAddToToolBar(toolBar, parentContainer, group)
```

Вызывается при добавлении элемента управления на тулбар.

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

Имя | Тип | Описание
----- | ----- | -----
`toolBar` | [YMaps.ToolBar](toolbar.md) | Указатель на тулбар.
`parentContainer` | HTMLElement | Родительский элемент для элемента управления.
`group` | [YMaps.Group](group.md) | Группа-контейнер элементов тулбара, в которую добавлен элемент управления. Если элемент добавляется в раскрывающийся список, то параметр group будет содержать ссылку на объект [YMaps.ListBox](listbox.md), в остальных случаях - ссылку на тулбар.

### onRemoveFromToolBar {#onRemoveFromToolBar}

```javascript
onRemoveFromToolBar()
```

Вызывается при удалении элемента управления с тулбара.