control.ZoomControl

Расширяет IControl, ICustomizable.

Элемент управления масштабом карты. Ключ элемента управления в хранилище control.storage — "zoomControl".

Конструктор | Поля | События | Методы

Конструктор

control.ZoomControl([parameters])

Параметры:

Параметр

Значение по умолчанию

Описание

parameters

Тип: Object

Параметры элемента управления.

parameters.data

Тип: Object

Данные элемента управления.

parameters.options

Тип: Object

Опции элемента управления.

parameters.options.adjustMapMargin

false

Тип: Boolean

Регистрирует ли элемент управления свои размеры в менеджере отступов карты map.margin.Manager.

parameters.options.layout

Тип: IZoomControlLayout

String

Конструктор макета элемента управления или его ключ в хранилище layout.storage. В конструктор макета передается объект, содержащий поля:

  • control - ссылка на элемент управления;
  • options - менеджер опций элемента управления control.ZoomControl.options;
  • data - менеджер данных элемента управления control.ZoomControl.data;
  • state - менеджер состояния элемента управления control.ZoomControl.state.

parameters.options.position

Тип: Object

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

parameters.options.position.bottom

'auto'

Тип: Number|String

Положение относительно нижнего края карты.

parameters.options.position.left

10

Тип: Number|String

Положение относительно левого края карты.

parameters.options.position.right

'auto'

Тип: Number|String

Положение относительно правого края карты.

parameters.options.position.top

108

Тип: Number|String

Положение относительно верхнего края карты.

parameters.options.size

'auto'

Тип: String

Параметр, отвечающий за внешний вид элемента управления. Может принимать значения:

  • 'small' — всегда показывать маленький элемент управления масштабом карты;
  • 'large' — всегда показывать большой элемент управления масштабом карты;
  • 'auto' — производить автоматический выбор размера элемента управления в зависимости от высоты контейнера карты.

parameters.options.visible

true

Тип: Boolean

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

parameters.options.zoomDuration

200

Тип: Number

Время анимации при смене уровня масштабирования.

parameters.options.zoomStep

1

Тип: Number

Шаг изменения уровня масштабирования карты.

parameters.state

Тип: Object

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

Примеры:

1.

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

2.

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

Поля

Имя

Тип

Описание

events

IEventManager

Менеджер событий.

Унаследовано от IEventEmitter.

options

IOptionManager

Менеджер опций.

Унаследовано от IControl.

События

Имя

Описание

optionschange

Изменение в опциях объекта.

Унаследовано от ICustomizable.

parentchange

Сменился родительский объект.

Поля данных:

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

Унаследовано от IChild.

Методы

Имя

Возвращает

Описание

getMap()

Map

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

getParent()

IControlParent|null

Возвращает ссылку на родительский объект или null, если родительский элемент не был установлен.

Унаследован от IControl.

setParent(parent)

IChildOnMap

Устанавливает родительский объект. Если передать значение null, то элемент управления будет только удален из текущего родительского объекта.

Унаследован от IControl.

Описание методов

getMap

{Map} getMap()

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

Предыдущая
Следующая