YMaps.BalloonOptions

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

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

Пример:

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

Поля

hasCloseButton

Boolean hasCloseButton

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

mapAutoPan

Boolean mapAutoPan

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

margin

Number|Number[] margin

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

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

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

Примеры:

1.

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

2.

// Устанавливает вертикальные отступы 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

Number maxHeight

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

maxWidth

Number maxWidth

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

style

YMaps.BalloonStyle style

Объект стиля балуна. По умолчанию используется стиль балуна из системного стиля по умолчанию YMaps.Styles.DefaultStyleKey.