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

# control.ZoomControl

Расширяет [IControl](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md), [ICustomizable](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md).

Элемент управления масштабом карты. Ключ элемента управления в хранилище [control.storage](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/control.storage.md) — "zoomControl".

[Конструктор](#constructor-summary) | [Поля ](#properties-summary) | [События ](#events-summary) | [Методы ](#methods-summary)

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

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

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

#|
|| **Параметр** | **Значение по умолчанию** | **Описание**  ||
|| [`parameters`](#param-parameters) | — | Тип: Object

Параметры элемента управления. ||
|| [`parameters.data`](#param-parameters.data) | — | Тип: Object

Данные элемента управления. ||
|| [`parameters.options`](#param-parameters.options) | — | Тип: Object

Опции элемента управления. ||
|| [`parameters.options.adjustMapMargin`](#param-parameters.options.adjustMapMargin) | false | Тип: Boolean

Регистрирует ли элемент управления свои размеры в менеджере отступов карты [map.margin.Manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.margin.Manager.md). ||
|| [`parameters.options.layout`](#param-parameters.options.layout) | — | Тип: [IZoomControlLayout](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IZoomControlLayout.md)|String

Конструктор макета элемента управления или его ключ в хранилище [layout.storage](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/layout.storage.md). В конструктор макета передается объект, содержащий поля:
- control - ссылка на элемент управления;
- options - менеджер опций элемента управления control.ZoomControl.options;
- data - менеджер данных элемента управления control.ZoomControl.data;
- state - менеджер состояния элемента управления control.ZoomControl.state. ||
|| [`parameters.options.position`](#param-parameters.options.position) | — | Тип: Object

Объект, описывающий позицию элемента управления. ||
|| [`parameters.options.position.bottom`](#param-parameters.options.position.bottom) | 'auto' | Тип: Number\|String

Положение относительно нижнего края карты. ||
|| [`parameters.options.position.left`](#param-parameters.options.position.left) | 10 | Тип: Number\|String

Положение относительно левого края карты. ||
|| [`parameters.options.position.right`](#param-parameters.options.position.right) | 'auto' | Тип: Number\|String

Положение относительно правого края карты. ||
|| [`parameters.options.position.top`](#param-parameters.options.position.top) | 108 | Тип: Number\|String

Положение относительно верхнего края карты. ||
|| [`parameters.options.size`](#param-parameters.options.size) | 'auto' | Тип: String

Параметр, отвечающий за внешний вид элемента управления. Может принимать значения:
- 'small' — всегда показывать маленький элемент управления масштабом карты;
- 'large' — всегда показывать большой элемент управления масштабом карты;
- 'auto' — производить автоматический выбор размера элемента управления в зависимости от высоты контейнера карты. ||
|| [`parameters.options.visible`](#param-parameters.options.visible) | true | Тип: Boolean

Признак того, что элемент управления отображается. ||
|| [`parameters.options.zoomDuration`](#param-parameters.options.zoomDuration) | 200 | Тип: Number

Время анимации при смене уровня масштабирования. ||
|| [`parameters.options.zoomStep`](#param-parameters.options.zoomStep) | 1 | Тип: Number

Шаг изменения уровня масштабирования карты. ||
|| [`parameters.state`](#param-parameters.state) | — | Тип: Object

Объект, описывающий состояние элемента управления. ||
|#


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

**1.**

```javascript
// Пример 1.
// Создадим элемент управления масштабом маленького размера и добавим его на карту.
var zoomControl = new ymaps.control.ZoomControl({
        options: {
            size: "small"
        }
    });
myMap.controls.add(zoomControl);
```

**2.**

```javascript
// Пример 2
// Добавление большого элемента управления масштабом карты по ключу из   control.storage.
myMap.controls.add('zoomControl', {
    size: "large"
});
```

## Поля {#properties-summary}

#|
|| **Имя** | **Тип** | **Описание** ||
|| [events](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events) | [IEventManager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventManager.md) | Менеджер событий.

Унаследовано от [IEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventEmitter.md#events). ||
|| [options](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md#options) | [IOptionManager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IOptionManager.md) | Менеджер опций.

Унаследовано от [IControl](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md#options). ||
|#

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

#|
|| **Имя** | **Описание** ||
|| [optionschange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/ICustomizable.md#event-optionschange) | Изменение в опциях объекта.

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

Поля данных:

- oldParent - старый родитель;
- newParent - новый родитель.

Унаследовано от [IChild](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChild.md#event-parentchange). ||
|#

## Методы {#methods-summary}

#|
|| **Имя** | **Возвращает** | **Описание** ||
|| [getMap](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/control.ZoomControl.md#getMap)() | [Map](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md) | Возвращает ссылку на карту. ||
|| [getParent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md#getParent)() | [IControlParent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControlParent.md)\|null | Возвращает ссылку на родительский объект или null, если родительский элемент не был установлен.

Унаследован от [IControl](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md#getParent). ||
|| [setParent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md#setParent)([parent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IControl.md#setParent-param-parent)) | [IChildOnMap](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IChildOnMap.md) | Устанавливает родительский объект. Если передать значение null, то элемент управления будет только удален из текущего родительского объекта.

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

## Описание методов {#method_detail}

### getMap {#getMap}

```javascript
{Map} getMap()
```

**Возвращает** ссылку на карту.

<!-- XLIFF_FARM_Nzg5NTU2_CACHING -->