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

# YMaps.BalloonOptions

Класс содержит опции объекта балуна.

Данный класс не имеет конструктора. Экземпляры создаются как обычные объекты JavaScript.

**Пример:**

```javascript
// Открывает балун с помощью метода карты openBallon. Максимальная ширина балуна 50 пикселов, кнопки закрытия нет.
map.openBalloon(new YMaps.GeoPoint(37.64, 55.76), 'Проверка', {hasCloseButton:false, maxWidth:50})
```

## Поля

Имя | Описание
----- | -----
[hasCloseButton](balloonoptions.md#hasCloseButton) | Флаг, указывающий, должна ли быть у балуна кнопка закрытия.
[mapAutoPan](balloonoptions.md#mapAutoPan) | Флаг, указывающий, что при открытии балуна требуется автоматически сдвигать карту так, чтобы балун был виден целиком.
[margin](balloonoptions.md#margin) | Величина минимального отступа балуна от границ карты (в пикселах).
[maxHeight](balloonoptions.md#maxHeight) | Максимальная высота балуна (в пикселах).
[maxWidth](balloonoptions.md#maxWidth) | Максимальная ширина балуна (в пикселах).
[style](balloonoptions.md#style) | Объект стиля балуна.

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

### hasCloseButton {#hasCloseButton}

```javascript
Boolean hasCloseButton
```

Флаг, указывающий, должна ли быть у балуна кнопка закрытия. По умолчанию true. Опция влияет только на отображение и общее поведение балуна не изменяет.
### mapAutoPan {#mapAutoPan}

```javascript
Boolean mapAutoPan
```

Флаг, указывающий, что при открытии балуна требуется автоматически сдвигать карту так, чтобы балун был виден целиком. По умолчанию true.
### margin {#margin}

```javascript
Number|Number[] margin
```

Величина минимального отступа балуна от границ карты (в пикселах).

Задается либо одним числом (одинаковый отступ от всех границ карты), либо массивом, который может содержать до 4-х элементов: (marginTop, marginRight, marginBottom, marginLeft).

По умолчанию имеет значение [33, 10, 20, 33].

**Примеры:**

**1.**

```javascript
// Устанавливает одинаковый отступ 10 пикселов от всех границ карты.
map.openBalloon(map.getBounds().getLeftTop(), text, {margin: 10});
```

**2.**

```javascript
// Устанавливает вертикальные отступы 10, горизонтальные - 20 пикселов.
map.openBalloon(map.getBounds().getLeftTop(), text, {margin: [10, 20]});
// Устанавливает отступ от верхней границы карты 10, от левой и правой - по 20, от нижней - 30 пикселов.
map.openBalloon(map.getBounds().getRightBottom(), text, {margin: [10, 20, 30]});
// Устанавливает отступ от верхней границы карты 10, от правой - 20, от нижней - 30, от левой - 40 пикселов.
map.openBalloon(map.getBounds().getRightBottom(), text, {margin: [10, 20, 30, 40]});
```
### maxHeight {#maxHeight}

```javascript
Number maxHeight
```

Максимальная высота балуна (в пикселах). Если 0 или null, то максимальную высоту определяет макет. Макет по умолчанию выставляет значение в зависимости от высоты карты, но не меньше 100px.
### maxWidth {#maxWidth}

```javascript
Number maxWidth
```

Максимальная ширина балуна (в пикселах). Если 0 или null, то максимальную ширину определяет макет. Макет по умолчанию выставляет значение в зависимости от ширины карты, но не меньше 520px.
### style {#style}

```javascript
YMaps.BalloonStyle style
```

Объект стиля балуна. По умолчанию используется стиль балуна из системного стиля по умолчанию [YMaps.Styles.DefaultStyleKey](https://yandex.ru/dev/jsapi-v1-1/doc/ru/ref/reference/styles.md#DefaultStyleKey).