YMaps.Balloon

Расширяет YMaps.IOverlay.

Балун.

Объект балуна создается картой и существует в единственном экземпляре.

Управление балуном осуществляется с помощью методов YMaps.Map.openBalloon и YMaps.Map.closeBalloon.

См.: Балун

Конструктор

Поля

События

Методы

Наследуемые методы

Из YMaps.IOverlay:

onAddToMap, onMapUpdate, onRemoveFromMap

YMaps.Balloon(options)

Создает балун (balloon) с текстом, картинкой или любым другим HTML-содержимым.

Балун состоит из области, в которой показывается HTML-содержимое и клиновидного "хвостика", указывающего определенную точку на карте. Балун, например, всплывает при щелчке мыши по метке. Балун является оверлеем.

См.: Балун

Параметры:

Имя	Тип	Необязательный	По умолчанию	Описание
options	YMaps.BalloonOptions			Опции балуна.

Events

Object Events

Список обрабатываемых событий балуна.

Close

Close

Щелчок по кнопке закрытия балуна. Для подписки на событие закрытия балуна используйте событие карты YMaps.Event.BalloonClose. В callback-функцию передается указатель на балун.

CloseButtonClick

CloseButtonClick

Щелчок по кнопке закрытия балуна. Для подписки на событие закрытия балуна используйте событие карты YMaps.Event.BalloonClose. В callback-функцию передается указатель на балун.

getContent

{String|HTMLElement|YMaps.ILayout} getContent()

Возвращает содержимое балуна, установленное с помощью метода YMaps.Balloon.setContent.

Возвращает:

getContentLayout

{YMaps.ILayout} getContentLayout()

Возвращает макет содержимого балуна. Если балун не добавлен на карту, то возвращает null.

Пример:

var layout = map.getBalloon().getContentLayout();
layout.getRootNodes().css('font-weight', 'bold');

Возвращает:

getCoordPoint

{YMaps.ICoordPoint} getCoordPoint()

Возвращает координаты балуна на карте.

Возвращает:

getGeoPoint

{YMaps.ICoordPoint} getGeoPoint()

То же, что и YMaps.Balloon.getCoordPoint.

Возвращает:

getLayout

{YMaps.IBalloonLayout} getLayout()

Возвращает макет балуна. Если балун не добавлен на карту, то возвращает null.

Пример:

map.openBalloon(map.getCenter(), '<button class="my-button">Hello world</button>');
var layout = map.getBalloon().getLayout();
YMaps.jQuery(layout.getRootNodes()).find('.my-button').click(function() {
    alert('Hello world');
});

Возвращает:

getOptions

{YMaps.BalloonOptions} getOptions()

Возвращает опции балуна.

Возвращает:

mapAutoPan

mapAutoPan(callback)

Сдвигает карту таким образом, чтобы балун было видно целиком. C помощью опции YMaps.BalloonOptions.margin, можно задать минимальный отступ балуна от края карты (в пикселах).

Параметры:

setContent

setContent(content)

Устанавливает содержимое балуна. Если в параметре content передана строка, то контейнером для содержимого балуна станет элемент div. Переданная строка станет значением свойства innerHTML элемента div.

Параметры:

setCoordPoint

setCoordPoint(coordPoint)

Позиционирует балун в точку с заданными координатами.

Параметры:

setGeoPoint

setGeoPoint(coordPoint)

То же, что и YMaps.Balloon.setCoordPoint.

Параметры:

setOptions

setOptions(options, restoreDefault)

Устанавливает опции балуна.

Примеры:

1.

// Передает опции с помощью метода карты openBalloon() и открывает балун.
map.openBalloon(new YMaps.GeoPoint(37, 55), 'Здесь был Я.', {hasCloseButton: false, mapAutoPan: 0});

2.

// Передает опции после открытия балуна, не задействуя метод openBalloon.
map.getBalloon().setOptions({hasCloseButton: false, mapAutoPan: 0});

Параметры:

Имя	Тип	Необязательный	По умолчанию	Описание
options	YMaps.BalloonOptions			Объект опций.
restoreDefault	Boolean		false	Незаданные опции установить в значения по умолчанию.

update

update()

Полностью перестраивает балун. Вызывается, если необходимо обновить балун.