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.BalloonStyle style
Объект стиля балуна. По умолчанию используется стиль балуна из системного стиля по умолчанию YMaps.Styles.DefaultStyleKey.