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

# map.Balloon

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

Менеджер балуна карты. У каждой карты уже есть собственный менеджер балуна, доступный как map.balloon. В один момент на карте может быть открыт только один балун, управляемый менеджером. Не создавайте экземпляры этого класса без необходимости.

**См.:** [Map.balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md#balloon)

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

```javascript
map.Balloon(map)
```

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `map`[*](*parametr) | — | Тип: [Map](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md)

Ссылка на объект карты. ||
|#


\* Обязательный параметр/опция.

## Поля {#fields}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [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). ||
|#

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

#|
|| **Имя** | **Описание** ||
|| [close](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Balloon.md#close) | Произошло закрытие балуна. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). ||
|| [open](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Balloon.md#open) | Произошло открытие балуна. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

- balloon - ссылка на экземпляр класса [Balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Balloon.md). ||
|#

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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [close](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Balloon.md#close)() |  | Закрывает балун. ||
|| [isOpen](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Balloon.md#isOpen)() | Boolean | Проверяет состояние балуна на карте. ||
|| [open](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Balloon.md#open)([position](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Balloon.md#open-param-position)[, [data](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Balloon.md#open-param-data)[, [options](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/map.Balloon.md#open-param-options)]]) | [Balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Balloon.md) | Открывает балун на карте в заданной точке. Возвращает экземпляр класса [Balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Balloon.md). ||
|#

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

### close

Произошло закрытие балуна. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md).

### open

Произошло открытие балуна. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• balloon - ссылка на экземпляр класса [Balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Balloon.md).

## Описание методов {#description-methods}

### close

```javascript
{} close()
```

Закрывает балун.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `callback`[*](*parametr) | — | Тип: ||
|#


\* Обязательный параметр/опция.

### isOpen

```javascript
{Boolean} isOpen()
```

Проверяет состояние балуна на карте.

**Returns** true, если балун на карте открыт, false - в обратном случае.

**Пример:**

```javascript
// Открываем балун при двойном щелчке на карте
// или просто обновляем содержимое (случайное число),
// если балун уже был открыт.
var balloon = null;

myMap.events.add('dblclick', function () {
    if (myMap.balloon.isOpen()) {
        balloon.setData({ content: Math.random() });
    } else {
        balloon = myMap.balloon.open(myMap.getCenter(), Math.random());
    }
});
```

### open

```javascript
{Balloon} open(position[, data[, options]])
```

Открывает балун на карте в заданной точке. Возвращает экземпляр класса [Balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Balloon.md).

**Returns** балун.

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `position`[*](*parametr) | — | Тип: Number[]

Позиция балуна. Указывается в гео-координатах текущей проекции. ||
|| `data` | — | Тип: Object\|String

Данные для отображения. ||
|| `options` | — | Тип: Object

Опции. ||
|#


\* Обязательный параметр/опция.

**Пример:**

```javascript
// Открываем балун на карте, через 1 секунду меняем его содержимое, еще через 5 секунд закрываем.
var balloon = myMap.balloon.open(myMap.getCenter(), { content: 'Hello Yandex!' }, { closeButton: true });

setTimeout(function () {
    balloon.setData({ content: 'Этот балун закроется через 3 секунды.' })
    setTimeout(function () { myMap.balloon.close(); }, 3000);
}, 1000)
```

[*parametr]:Обязательный параметр/опция.