Документация
Справочник JavaScript API
2.1.64 (текущая версия)
collection
interactivityModel
Интерфейсы

collection.Item

Расширяет IChildOnMap, ICustomizable, IEventEmitter, IParentOnMap.

Базовый класс элемента коллекции объектов карты.

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

Конструктор

collection.Item([options])

Параметры:

ПараметрЗначение по умолчаниюОписание
options

Тип: Object

Опции объекта.

Пример:

// Пример реализации собственного элемента управления на основе наследования от collection.Item.
// Элемент управления отображает название объекта, который находится в центре карты.
var map = new ymaps.Map('map', {
        center: [55.819543, 37.611619],
        zoom: 6
    }),
// Создаем собственный класс.
    CustomControl = function (options) {
        CustomControl.superclass.constructor.call(this, options);
    };
// И наследуем его от collection.Item.
ymaps.util.defineClass(CustomControl, ymaps.collection.Item, {
    onAddToMap: function (map) {
        CustomControl.superclass.onAddToMap.call(this, map);
        // Создаем HTML-элемент с текстом.
        this.getParent().getChildElement(this).then(this._onChildElementGet, this);
    },

    onRemoveFromMap: function (oldMap) {
        CustomControl.superclass.onRemoveFromMap.call(this, oldMap);
    },

    _onChildElementGet: function(parentElementContainer) {
        // Здесь можно создать dom-отображение для элемента управления
        // и добавить его дочерним элементом в parentElementContaner.
        // ...
    }
});

var customControl = new CustomControl();
map.controls.add(customControl, {top: 10, left: 10});

Поля

ИмяТипОписание
events IEventManager

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

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

options IOptionManager

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

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

События

ИмяОписание
mapchange

Сменилась карта. Поля данных:

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

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

optionschange

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

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

parentchange

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

Поля данных:

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

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

Методы

ИмяВозвращаетОписание
getMap()

Map

Возвращает карту, которой принадлежит элемент коллекции.

getParent()

IParentOnMap

Возвращает родительский объект.

onAddToMap(map)

Функция, которая вызывается при добавлении элемента на карту. Для выполнения дополнительных действий при добавлении объекта на карту переопределите эту функцию.

onRemoveFromMap(oldMap)

Функция, которая вызывается при удалении элемента с карты. Для выполнения дополнительных действий при удалении объекта с карты переопределите эту функцию.

setParent(parent)

collection.Item

Устанавливает родителя для заданного элемента коллекции.

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

getMap

{Map} getMap()

Возвращает карту, которой принадлежит элемент коллекции.

getParent

{IParentOnMap} getParent()

Возвращает родительский объект.

onAddToMap

{} onAddToMap(map)

Функция, которая вызывается при добавлении элемента на карту. Для выполнения дополнительных действий при добавлении объекта на карту переопределите эту функцию.

Параметры:

ПараметрЗначение по умолчаниюОписание
map *
[no-highlight[

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

]no-highlight]

Тип: Map

Карта, на которую добавлен объект.

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

onRemoveFromMap

{} onRemoveFromMap(oldMap)

Функция, которая вызывается при удалении элемента с карты. Для выполнения дополнительных действий при удалении объекта с карты переопределите эту функцию.

Параметры:

ПараметрЗначение по умолчаниюОписание
oldMap *
[no-highlight[

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

]no-highlight]

Тип: Map

Карта, с которой удален объект.

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

setParent

{collection.Item} setParent(parent)

Устанавливает родителя для заданного элемента коллекции.

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

Параметры:

ПараметрЗначение по умолчаниюОписание
parent *
[no-highlight[

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

]no-highlight]

Тип: IParentOnMap

Родительский объект.

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