control.MapTools
Расширяет control.ToolBar.
Тулбар со стандартными кнопками.
Конструктор
control.MapTools([params[, options]])
Параметры:
Параметр |
Значение по умолчанию |
Описание |
|
— |
Тип: Object|IControl[]|String[] Параметры тулбара или список кнопок, которые будут добавлены по умолчанию. |
|
— |
Тип: IControl[]|String[] Кнопки которые будут добавленны в тулбар. Могут задаваться экземплярами класса, реализующего интерфейс IControl, либо ключами. Для этих кнопок будет созданна специальная группа. Можно использовать следующие ключи: • "drag" - кнопка "Навигация"; • "magnifier" - кнопка "Выделение"; • "ruler" - кнопка "Линейка". По умолчанию автоматически добавляются стандартные кнопки "Навигация", "Выделение" и "Линейка". Получить ссылку на группу, содержащую эти объекты, можно будет через метод getDefaultGroup. |
|
— |
Тип: Object Опции элемента управления. |
|
{ top: 5, right: 5 } |
Тип: Object Положение элемента управления над картой. Задается в виде объекта со следующими полями: • right - отступ от правого края контейнера карты в пикселах; • bottom - отступ от нижнего края контейнера карты в пикселах; • left - отступ от левого края контейнера карты в пикселах. Если при этом заданы одновременно и top, и bottom, то значение bottom игнорируется. Аналогично, если заданы одновременно и left, и right, то значение right игнорируется. Если элемент управления добавляется в группу элементов (например, в тулбар или раскрывающийся список), то значение position не применяется. |
|
true |
Тип: Boolean Признак того, что элемент управления отображается. |
Пример:
var mapTools = new ymaps.control.MapTools({ items: ["drag", "magnifier"]});
// получаем доступ к кнопке, добавленной по умолчанию
mapTools.getDefaultGroup().get("drag");
Поля
Имя |
Тип |
Описание |
Данные тулбара. Унаследовано от control.ToolBar. |
||
Менеджер событий. Унаследовано от IEventEmitter. |
||
Менеджер опций. Унаследовано от ICustomizable. |
||
Состояние элемента управления. Имена полей, доступных через метод data.Manager.get: Унаследовано от control.ToolBar. |
События
Имя |
Описание |
Произошло добавление дочернего объекта. Унаследовано от ICollection. |
|
Изменение дом-элемента, в который добавляются дочерние элементы группы. Экземпляр класса Event. Имена полей, доступных через метод Event.get: • newChildContainerElement - новый дом-элемент для дочерних элементов; • oldChildContainerElement - старый элемент для дочерних элементов. Унаследовано от control.Group. |
|
Сменилась карта. Поля данных: • newMap - новая карта. Унаследовано от IParentOnMap. |
|
Изменение в опциях объекта. Унаследовано от ICustomizable. |
|
Сменился родительский объект. Поля данных: • oldParent - старый родитель; • newParent - новый родитель. Унаследовано от IChild. |
|
Произошло удаление дочернего объекта. Унаследовано от ICollection. |
Методы
Имя |
Возвращает |
Описание |
add(item[, positionIndex]) |
Добавляет элемент управления в группу. Элемент можно добавлять, Возожные значения ключей: • "mapTools" - стандартный тулбар с кнопками "Навигация", "Выделение" и "Линейка" control.MapTools; • "miniMap" - обзорная карта control.MiniMap; • "scaleLine" - масштабный отрезок control.ScaleLine; • "searchControl" - панель поиска control.SearchControl; • "trafficControl" - панель пробок control.TrafficControl; • "typeSelector" - панель переключения типа карты control.TypeSelector; • "zoomControl" - ползунок масштаба control.ZoomControl; • "smallZoomControl" - простой ползунок масштаба control.SmallZoomControl. Унаследован от control.Group. |
|
Перебирает все элементы коллекции, вызывая для каждого функцию-обработчик. Унаследован от control.Group. |
||
Функция для выборки дочерних элементов по условию. Унаследован от control.Group. |
||
get() |
Returns ссылку на объект контрола, добавленного по ключу или по индексу. Унаследован от control.Group. |
|
getAll() |
Returns массив дочерних элементов контрола. Унаследован от control.Group. |
|
HTMLElement |
Возвращает для своего дочернего объекта HTML-элемент, в котором он должен размещаться. Унаследован от IControlParent. |
|
HTMLElement |
Returns контейнер, в который добавляются дочерние элементы контрола. Унаследован от control.Group. |
|
Returns ссылку на группу стандартных элементов управления картой. |
||
Returns итератор по коллекции. Унаследован от ICollection. |
||
Number |
Returns количество дочерних элементов. Унаследован от control.Group. |
|
getMap() |
Map](Map.md) |
Returns ссылку на карту. Унаследован от IParentOnMap. |
Returns ссылку на родительский объект. Унаследован от IControl. |
||
Integer |
Returns индекс дочернего элемента в группе. Унаследован от control.Group. |
|
Удаляет элемент управления из группы. Унаследован от control.Group. |
||
Удаляет все дочерние элементы из группы. Унаследован от control.Group. |
||
Устанавливает родительский объект. Унаследован от IControl. |
Описание методов
getDefaultGroup
{control.RadioGroup} getDefaultGroup()
Returns ссылку на группу стандартных элементов управления картой.