--- metadata: - name: generator content: Diplodoc Platform v5.39.1 alternate: - https://yandex.ru/dev/jsapi-v2-1/doc/en/v2-1/ref/reference/map.Container.md - https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/jsapi-v2-1/doc/ru/llms.txt # map.Container Расширяет [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md). Менеджер контейнера карты. У каждой карты уже есть свой собственный менеджер контейнера, доступный как map.container. Не инстанцируйте экземпляры этого класса без необходимости. **См.:** [Map.container](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Map.md#container) [Конструктор](#constructor-summary) | [Поля ](#properties-summary) | [События ](#events-summary) | [Методы ](#methods-summary) ## Конструктор {#constructor-summary} ```javascript map.Container(parentElement) ``` **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`parentElement`](#param-parentElement)[*](*star) | — | Тип: String\|HTMLElement HTML-элемент, в котором будет создана карта или его id. || |# \* Обязательный параметр/опция. ## Поля {#properties-summary} #| || **Имя** | **Тип** | **Описание** || || [events](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#events) | [IEventManager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IEventManager.md) | Менеджер событий. Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#events). || |# ## События {#events-summary} #| || **Имя** | **Описание** || || [beforefullscreenexit](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#event-beforefullscreenexit) | Событие, предшествующее событию fullscreenexit. Если у данного события вызвать метод [Event.preventDefault](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#preventDefault), то последующее событие "fullscreenexit" будет отменено. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). || || [click](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-click) | Однократное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-click). || || [contextmenu](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-contextmenu) | Вызов контекстного меню на элементе. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-contextmenu). || || [dblclick](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-dblclick) | Двойное нажатие левой кнопки мыши на объекте. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-dblclick). || || [fullscreenenter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#event-fullscreenenter) | Карта переключена в полноэкранный режим. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). || || [fullscreenexit](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#event-fullscreenexit) | Карта вышла из полноэкранного режима. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). || || [mousedown](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousedown) | Нажатие кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousedown). || || [mouseenter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseenter) | Наведение курсора на объект. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseenter). || || [mouseleave](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseleave) | Вывод курсора за пределы объекта. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseleave). || || [mousemove](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousemove) | Перемещение курсора над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mousemove). || || [mouseup](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseup) | Отпускание кнопки мыши над объектом. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-mouseup). || || [multitouchend](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchend) | Окончание мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent. Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchend). || || [multitouchmove](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchmove) | Повторящееся событие при мультисенсорном управлении. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Определяет свойство touches, которое содержит список прикосновений. Каждое прикосновение описано объектом, которое содержит поля: - clientX - координата касания X относительно видимой области браузера; - clientY - координата касания Y относительно видимой области браузера; - pageX - координата касания X касания относительно начала документа; - pageY - координата касания Y касания относительно начала документа. Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchmove). || || [multitouchstart](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchstart) | Начало мультисенсорного управления. Данное событие доступно только на устройствах, которые поддерживают множественные сенсорные прикосновения. Возвращает реализацию интерфейса IMultiTouchEvent c информацией о прикосновениях. Определяет свойство touches, которое содержит список прикосновений. Каждое прикосновение описано объектом, которое содержит поля: - clientX - координата касания X относительно видимой области браузера; - clientY - координата касания Y относительно видимой области браузера; - pageX - координата касания X касания относительно начала документа; - pageY - координата касания Y касания относительно начала документа. Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-multitouchstart). || || [sizechange](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#event-sizechange) | Изменение размера контейнера карты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - oldSize: Number[]; - newSize: Number[]; - oldOffset: Number[]; - newOffset: Number[]; - preservePixelPosition: Boolean. || || [wheel](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-wheel) | Скролл мышкой. При использовании следует иметь в виду, что при сенсорном вводе события мыши будут эмулироваться. Экземпляр класса [MapEvent](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/MapEvent.md). Более детальное описание доступно в [domEvent.manager](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/domEvent.manager.md). Унаследовано от [IDomEventEmitter](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/IDomEventEmitter.md#event-wheel). || |# ## Методы {#methods-summary} #| || **Имя** | **Возвращает** | **Описание** || || [enterFullscreen](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#enterFullscreen)() | | Позволяет переводить карту в полноэкранный режим. || || [exitFullscreen](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#exitFullscreen)() | | Позволяет вывести карту из полноэкранного режима. || || [fitToViewport](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#fitToViewport)(\[[preservePixelPosition](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#fitToViewport-param-preservePixelPosition)]) | | Вызывается при изменении размера контейнера карты для того, чтобы карта применила новый размер. || || [getElement](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#getElement)() | HTMLElement | Возвращает HTML-элемент карты. || || [getOffset](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#getOffset)() | Number[] | Возвращает смещение контейнера карты в пикселях относительно левого верхнего угла документа. || || [getParentElement](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#getParentElement)() | HTMLElement | Возвращает пользовательский HTML-элемент, в котором была создана карта. || || [getSize](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#getSize)() | Number[] | Возвращает размеры контейнера карты в пикселях. || || [isFullscreen](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/map.Container.md#isFullscreen)() | Boolean | Возвращает признак находится ли карта в полноэкранном режиме. || |# ## Описание событий {#event_detail} ### beforefullscreenexit {#beforefullscreenexit} Событие, предшествующее событию fullscreenexit. Если у данного события вызвать метод [Event.preventDefault](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#preventDefault), то последующее событие "fullscreenexit" будет отменено. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ### fullscreenenter {#fullscreenenter} Карта переключена в полноэкранный режим. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ### fullscreenexit {#fullscreenexit} Карта вышла из полноэкранного режима. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). ### sizechange {#sizechange} Изменение размера контейнера карты. Экземпляр класса [Event](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md). Имена полей, доступных через метод [Event.get](https://yandex.ru/dev/jsapi-v2-1/doc/ru/v2-1/ref/reference/Event.md#get): - oldSize: Number[]; - newSize: Number[]; - oldOffset: Number[]; - newOffset: Number[]; - preservePixelPosition: Boolean. ## Описание методов {#method_detail} ### enterFullscreen {#enterFullscreen} ```javascript {} enterFullscreen() ``` Позволяет переводить карту в полноэкранный режим. ### exitFullscreen {#exitFullscreen} ```javascript {} exitFullscreen() ``` Позволяет вывести карту из полноэкранного режима. ### fitToViewport {#fitToViewport} ```javascript {} fitToViewport([preservePixelPosition]) ``` Вызывается при изменении размера контейнера карты для того, чтобы карта применила новый размер. **Параметры:** #| || **Параметр** | **Значение по умолчанию** | **Описание** || || [`preservePixelPosition`](#fitToViewport-param-preservePixelPosition) | — | Тип: Boolean Сохранять положение центра карты. || |# **Пример:** ```javascript // Изменим размеры контейнера карты. map.container.getElement().style.width = '300px'; // Инициируем пересчет размеров. map.container.fitToViewport(); ``` ### getElement {#getElement} ```javascript {HTMLElement} getElement() ``` **Возвращает** HTML-элемент карты. ### getOffset {#getOffset} ```javascript {Number[]} getOffset() ``` **Возвращает** смещение контейнера карты в пикселях относительно левого верхнего угла документа. ### getParentElement {#getParentElement} ```javascript {HTMLElement} getParentElement() ``` **Возвращает** пользовательский HTML-элемент, в котором была создана карта. ### getSize {#getSize} ```javascript {Number[]} getSize() ``` **Возвращает** размеры контейнера карты в пикселях. ### isFullscreen {#isFullscreen} ```javascript {Boolean} isFullscreen() ``` **Возвращает** признак находится ли карта в полноэкранном режиме. [*star]: Обязательный параметр.