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

# control.ZoomControl

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

Элемент управления "Ползунок масштаба".

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

```javascript
control.ZoomControl([options])
```

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание** ||
|| `options` | — | Тип: Object

Опции элемента управления. ||
|| `options.customTips` | — | Тип: Object[]

Массив описаний подсказок. Каждое описание - это объект с двумя полями:

• `index``{Integer}` - коэффициент масштабирования, которому соответствует подсказка;

• `value``{String}` - текст подсказки. ||
|| `options.noTips` | false | Тип: Boolean

Включает/выключает показ всплывающих подсказок: true - подсказки выключены, false - включены.

Подсказки показываются в стороне от шкалы масштаба при наведении на нее курсора мыши. ||
|| `options.visible` | true | Тип: Boolean

Признак того, что элемент управления отображается. ||
|#

**Пример:**

```javascript
map.controls.add('zoomControl', { top: 75, left: 5 });
```
## Поля {#fields}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [data](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ListBoxItem.md#data) | [data.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/data.Manager.md) | Данные элемента управления.

Унаследовано от [control.SmallZoomControl](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.SmallZoomControl.md#data). ||
|| [events](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventManager.md) | Менеджер событий.

Унаследовано от [IEventEmitter](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IEventEmitter.md#events). ||
|| [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). ||
|| [state](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.ListBoxItem.md#state) | [data.Manager](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/data.Manager.md) | Состояние элемента управления. Имена полей, доступных через метод data.Manager.get: 
• zoom - текущий коэффициент масштабирования;

• zoomRange - текущий диапазон коэффициентов масштабирования;

• hints - массив описаний подсказок, применяющийся в макете элемента управления. ||
|#

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

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

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

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

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

Поля данных:

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

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

Унаследовано от [IChild](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IChild.md#parentchange). ||
|| [zoomchange](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/control.SmallZoomControl.md#zoomchange) | Коэффициент масштабирования карты изменен. Экземпляр класса [Event](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/Event.md).

• newZoom - новый коэффициент масштабирования карты;

• oldZoom - старый коэффициент масштабирования карты.

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

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

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [getParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControl.md#getParent)() | [IControlParent](https://yandex.ru/dev/maps/archive/doc/jsapi/2-0/ru/ref/reference/IControlParent.md) | Returns ссылку на родительский объект.

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

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

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

### state

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

Состояние элемента управления. Имена полей, доступных через метод data.Manager.get:

• zoom - текущий коэффициент масштабирования;

• zoomRange - текущий диапазон коэффициентов масштабирования;

• hints - массив описаний подсказок, применяющийся в макете элемента управления.