---
metadata:
  - name: generator
    content: Diplodoc Platform v5.39.1
alternate:
  - https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Cluster.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/llms.txt

# Cluster

Расширяет [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md).

Кластер геообъектов. Используется по умолчанию в [Clusterer](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Clusterer.md).

## Конструктор {#constructor}

```javascript
Cluster(geometry, properties[, options])
```

**Параметры:**

#|
|| **Заголовок1** | **Заголовок2** | **Заголовок2** ||
|| `geometry`[*](*parametr)  | — | Тип: [IPointGeometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IPointGeometry.md)

Геометрия кластера. ||
|| `properties`[*](*parametr) | — | Тип: [IDataManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDataManager.md)

Данные кластера. ||
|| `properties.geoObjects`[*](*parametr) | — | Тип: [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md)[]

Массив геообъектов, которые находятся в данном кластере. ||
|| `options` | — | Тип: Object

Опции кластера. Помимо частных опций, балун кластера поддерживает те же опции, что и {@link.Balloon}. Опции для балуна кластера указываются с префикcом 'balloon'. ||
|| `options.balloonContentBodyLayout` | 'cluster#balloonContentBody' | Тип: Function\|String

Макет балуна кластера. Можно передать конструктор объекта с интерфейсом [ILayout](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILayout.md) или ключ одного из стандартных макетов. Каждый стандартный макет имеет некоторые собственные опции.

• 'cluster#balloonContentBody' - Макет с двумя колонками. В левой колонке (sidebar) находится список геообъектов. В правой колонке информация о геообъекте. **Опции макета**

— balloonMainContentLayout Макет отображения данных о геообъекте в балуне кластера. (Тип: конструктор объекта с интерфейсом [ILayout](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILayout.md) или ключ макета) Значение по умолчанию: 'cluster#balloonMainContent'

— balloonSidebarWidth Ширина поля со списком объектов в балуне кластера в пикселях. Значение по умолчанию: 125

• 'cluster#balloonCarouselContent' - Макет с тремя колонками. В центральной колонке представлена информация о геобъекте. В боковых колонках располагаются стрелки перехода на следующий и предыдущий геообъект. В нижней части балуна находится меню навигации (pager). **Опции макета**

— balloonContentItemLayout Макет отображения данных геообъекта в балуне кластера. (Тип: конструктор объекта с интерфейсом [ILayout](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILayout.md) или ключ макета) Значение по умолчанию: 'cluster#balloonCarouselContentItem'

— balloonCycling Цикличность списка при навигации боковыми стрелками. Значение по умолчанию: true

— balloonPagerSize Количество элементов навигации в нижней панели. Значение по умолчанию: 9

— balloonPagerType Тип нижней панели навигации. Может принимать значения 'numeric' и 'marker'.
  — numeric - отображение номера геообъекта в списке;

  — marker - отображение маркеров без номеров. Рекомендуется использовать при количестве элементов в кластере меньшем или равном значению options.balloonPagerSize.
Значение по умолчанию: numeric

— balloonPagerVisible Отображать ли панель навигации. Значение по умолчанию: true
    
• 'cluster#balloonAccordionContent' - Информация о геообъектах в виде списка. После клика по элементу под ним разворачивается информация о геообъекте. **Опции макета**

— balloonAccordionItemTitleLayout Макет заголовка элемента списка. По клику разворачивается детальная информация о геообъекте. (Тип: конструктор объекта с интерфейсом [ILayout](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILayout.md) или ключ макета) Значение по умолчанию: 'cluster#balloonAccordionItemTitle'

— balloonAccordionItemContentLayout Макет информации о геообъекте. Отображается после клика по элементу списка. (Тип: конструктор объекта с интерфейсом [ILayout](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILayout.md) или ключ макета) Значение по умолчанию: 'cluster#balloonAccordionItemContent'

— balloonAccordionShowIcons Опция, которая определяет отображается ли иконка геообъекта в макете 'cluster#balloonAccordionItemTitle'. Значение по умолчанию: true ||
|| `options.balloonHeight` | — | Тип: Number

Высота балуна кластера. Стандартное значение зависит от макета. 
• 'cluster#balloonContentBody' - 210 пикселей

• 'cluster#balloonCarouselContent' - 177 пикселей

• 'cluster#balloonAccordionContent' - 283 пикселей ||
|| `options.balloonWidth` | — | Тип: Number

Ширина балуна кластера. Стандартное значение зависит от макета.
• 'cluster#balloonContentBody' - 475 пикселей

• 'cluster#balloonCarouselContent' - 308 пикселей

• 'cluster#balloonAccordionContent' - 305 пикселей

Обратите внимание, что если ширина балуна кластера будет больше максимально допустимой ширины балуна (опция maxWidth [Balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Balloon.md)), то макет будет обрезан. ||
|| `options.cursor` | 'pointer'  | Тип: String

Курсор над меткой кластера. ||
|| options.disableClickZoom | false | Тип: Boolean

Флаг, запрещающий увеличение коэффициента масштабирования карты при клике на кластер. ||
|| `options.hideIconOnBalloonOpen` | true | Тип: Boolean

Скрывать иконку при открытии балуна. ||
|| `options.iconContentLayout` | 'cluster#iconContent' | Тип: Function\|String

Макет содержимого метки кластера. (Тип: конструктор объекта с интерфейсом [ILayout](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILayout.md) или ключ макета). ||
|| `options.iconLayout` | 'cluster#icon'  | Тип: Function\|String

Макет метки кластера (Тип: конструктор объекта с интерфейсом [ILayout](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ILayout.md) или ключ макета). ||
|| `options.icons` | — | Тип: Object[]

Массив, описывающий иконки для стандартной реализации кластера. ||
|| `options.interactivityModel` | 'default#geoObject'  | Тип: String

Модель интерактивности кластера. Доступные ключи и их значения перечислены в описании [interactivityModel.storage](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/interactivityModel.storage.md). ||
|| `options.numbers` | [10, 100]  | Тип: Number[]

Массив, описывающий граничные значения для размеров кластеров. ||
|| `options.openBalloonOnClick` | true | Тип: Boolean

Опция, позволяющая запретить открытие балуна при клике на кластере. По умолчанию открытие балуна разрешено. Количество иконок, описанных в опции "icons", должно быть на 1 больше, чем чисел в данном массиве. ||
|#

\* Обязательный параметр/опция.


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

**1.**

```javascript
// Переменная с описанием двух видов иконок кластеров.
var clusterIcons = [
 {
     href: 'small.png',
     size: [40, 40],
     // Отступ, чтобы центр картинки совпадал с центром кластера.
     offset: [-20, -20]
 },
 {
     href: 'big.png',
     size: [60, 60],
     offset: [-30, -30]
 }],
 // При размере кластера до 100 будет использована картинка 'small.jpg'.
 // При размере кластера больше 100 будет использована 'big.png'.
 clusterNumbers = [100],
 // Сделаем макет содержимого иконки кластера,
 // в котором цифры будут раскрашены в белый цвет.
 MyIconContentLayout = ymaps.templateLayoutFactory.createClass(
 '<div style="color: #FFFFFF; font-weight: bold;">$[properties.geoObjects.length]</div>'),
 var clusterer = new ym.Clusterer({
    // Если опции для кластеров задаются через кластеризатор,
    // необходимо указывать их с префиксами "cluster".
    clusterIcons: clusterIcons,
    clusterNumbers: clusterNumbers,
    clusterIconContentLayout: MyIconContentLayout
});
```

**2.**

```javascript
// Создание кластеризатора с макетом-каруселью
 var clusterer = new ymaps.Clusterer({
    clusterDisableClickZoom: true,
    // Используем макет "карусель"
    clusterBalloonContentBodyLayout: "cluster#balloonCarouselContent",
    // Запрещаем зацикливание списка при постраничной навигации
    clusterBalloonCycling: false,
    // Настройка внешнего вида панели навигации. Элементами панели навигации будут маркеры.
    clusterBalloonPagerType: "marker",
    // Количество элементов в панели навигации
    clusterBalloonPagerSize: 6
});
```

**3.**

```javascript
// Создание кластеризатора с макетом-аккордеоном
 var clusterer = new ymaps.Clusterer({
    clusterDisableClickZoom: true,
    // Используем макет "аккордеон"
    clusterBalloonContentBodyLayout: "cluster#balloonAccordionContent"
});
```
## Поля {#fields}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Cluster.md#balloon) | [cluster.Balloon](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/cluster.Balloon.md) | Балун кластера. ||
|| [events](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#events) | [IEventManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventManager.md) | Менеджер событий.

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#events). ||
|| [geometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#geometry) | [IGeometry](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeometry.md) | Геометрия геообъекта.

Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#geometry). ||
|| [options](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#options) | [IOptionManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IOptionManager.md) | Менеджер опций.

Унаследовано от [ICustomizable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#options). ||
|| [properties](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#properties) | [IDataManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDataManager.md) | Менеджер данных геообъекта.

Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#properties). ||
|| [state](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Cluster.md#state) | [data.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/data.Manager.md) | Состояние кластера. Определяется следующими полями:
• activeObject - Cсылка на активный объект кластера. Активным объектом является тот, который в данный момент выбран в балуне кластера. ||
|#

## События {#events}

#|
|| **Имя** | **Описание** ||
|| [addtomap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Cluster.md#event-addtomap) | Добавление кластера на карту. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). ||
|| [click](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-click) | Однократное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-click). ||
|| [contextmenu](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-contextmenu) | Однократное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-click). ||
|| [contextmenu](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-contextmenu) | Вызов контекстного меню на элементе. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-contextmenu). ||
|| [dblclick](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-dblclick) | Двойное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-dblclick). ||
|| [geometrychange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-geometrychange) | Изменение геометрии геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• originalEvent - оригинальное событие геометрии.

Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-geometrychange). ||
|| [mapchange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#event-mapchange) | Сменилась карта. Поля данных: 
• oldMap - старая карта;

• newMap - новая карта.

Унаследовано от [IParentOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#event-mapchange). ||
|| [mousedown](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mousedown) | Нажатие кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mousedown). ||
|| [mouseenter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mouseenter) | Наведение курсора на объект. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mouseenter). ||
|| [mouseleave](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mouseleave) | Вывод курсора за пределы объекта. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mouseleave). ||
|| [mousemove](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mousemove) | Перемещение курсора над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mousemove). ||
|| [mouseup](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mouseup) | Отпускание кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-mouseup). ||
|| [multitouchend](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-multitouchend) | Окончание мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях.

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-multitouchend). ||
|| [multitouchmove](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-multitouchmove) | Повторящееся событие при мультисенсорном управлении. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях.

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-multitouchmove). ||
|| [multitouchstart](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-multitouchstart) | Начало мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях.

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-multitouchstart). ||
|| [optionschange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#event-optionschange) | Изменение в опциях объекта.

Унаследовано от [ICustomizable](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/ICustomizable.md#event-optionschange). ||
|| [overlaychange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-overlaychange) | Изменение оверлея геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• newOverlay - новый оверлей, либо null, если оверлея нет;

• oldOverlay - старый оверлей, либо null, если оверлея нет.

Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-overlaychange). ||
|| [parentchange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChild.md#event-parentchange) | Сменился родительский объект.

Поля данных:

• oldParent - старый родитель;

• newParent - новый родитель.

Унаследовано от [IChild](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChild.md#event-parentchange). ||
|| [pixelgeometrychange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-pixelgeometrychange) | Изменение пиксельной геометрии геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• newPixelGeometry - новая пиксельная геометрия;

• oldPixelGeometry - старая пиксельная геометрия.

Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-pixelgeometrychange). ||
|| [propertieschange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-propertieschange) | Изменение данных геообъекта. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). Имена полей, доступных через метод Event.get:

• originalEvent - оригинальное событие менеджера данных.

Унаследовано от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#event-propertieschange). ||
|| [removefrommap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Cluster.md#event-removefrommap) | Удаление кластера с карты. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md). ||
|| [wheel](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-wheel) | Скролл мышкой. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Более детально описание в [domEvent.manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/domEvent.manager.md).

Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IDomEventEmitter.md#event-wheel). ||
|#

## Методы {#method}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [getBounds](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Cluster.md#getBounds)() | Number[][]\|null | Returns географические координаты прямоугольной области, охватывающей все элементы кластера. ||
|| [getGeoObjects](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Cluster.md#getGeoObjects)() | [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md)[] | Returns массив геообъектов, образующих кластер. ||
|| [getMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#getMap)() | [Map](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Map.md) | Returns ссылку на карту.

Унаследован от [IParentOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md#getMap). ||
|| [getOverlay](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#getOverlay)() | [IOverlay](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IOverlay.md)\|null | Returns оверлей геообъекта, либо null.

Унаследован от [IGeoObject](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IGeoObject.md#getOverlay). ||
|| [getParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#getParent)() | [IParentOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IParentOnMap.md) | Returns ссылку на родительский объект.

Унаследован от [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#getParent). ||
|| [setParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#setParent)([parent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#setParent-param-parent)) | [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md) | Устанавливает родительский объект.

Унаследован от [IChildOnMap](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChildOnMap.md#setParent). ||
|#

## Описание полей {#description-fields}

### balloon

```javascript
{cluster.Balloon} balloon
```

Балун кластера.

### state

```javascript
{data.Manager} state
```

Состояние кластера. Определяется следующими полями:

• activeObject - Cсылка на активный объект кластера. Активным объектом является тот, который в данный момент выбран в балуне кластера.

**Пример:**

```javascript
var geoObjects = cluster.properties.get('geoObjects');
// При открытии балуна кластера будет выбран третий объект в списке.
cluster.state.set('activeObject', geoObjects[2]);
```
## Описание событий {#event-description}

### addtomap

Добавление кластера на карту. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md).

### removefrommap

Удаление кластера с карты. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md).

## Описание методов {#description-methods}

### getBounds

```javascript
{Number[][]|null} getBounds()
```

**Returns** географические координаты прямоугольной области, охватывающей все элементы кластера.
# getGeoObjects

```javascript
{IGeoObject[]} getGeoObjects()
```

**Returns** массив геообъектов, образующих кластер.

[*parametr]:Обязательный параметр/опция.