YMaps.BalloonOptions

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

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

Пример:

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

Поля

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

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

maxHeight Максимальная высота балуна (в пикселах).
maxWidth Максимальная ширина балуна (в пикселах).
style Объект стиля балуна.

Подробное описание полей

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.Styles.DefaultStyleKey.