Info Window

Класс InfoWindow

google.maps . InfoWindow

Наложение, похожее на пузырь, часто соединенное с маркером.

Этот класс расширяет MVCObject .

Доступ осуществляется путем вызова const {InfoWindow} = await google.maps.importLibrary("maps") или const {InfoWindow} = await google.maps.importLibrary("streetView") .
См. Библиотеки в Maps JavaScript API .

InfoWindow
InfoWindow([opts])
Параметры:
Создаёт информационное окно с заданными параметрами. InfoWindow можно разместить на карте в определённом месте или над маркером, в зависимости от настроек. Если функция автопанорамирования не отключена, InfoWindow будет панорамировать карту, чтобы стать видимым при открытии. После создания InfoWindow необходимо вызвать метод open для его отображения на карте. Пользователь может нажать кнопку закрытия на InfoWindow, чтобы удалить его с карты, или разработчик может вызвать метод close() для достижения того же эффекта.
isOpen
Тип: boolean
Проверяет, открыто ли информационное окно.
close
close()
Параметры: нет
Возвращаемое значение: нет
Закрывает данное информационное окно, удаляя его из структуры DOM.
focus
focus()
Параметры: нет
Возвращаемое значение: нет
Устанавливает фокус на данное InfoWindow . Рекомендуется использовать этот метод вместе с событием visible , чтобы убедиться, что InfoWindow видимо, прежде чем устанавливать на него фокус. Невидимое окно InfoWindow не может быть сфокусировано.
getContent
getContent()
Параметры: нет
Возвращаемое значение: string| Element | Text |null|undefined Содержимое этого InfoWindow. Совпадает с тем, что было установлено ранее.
getHeaderContent
getHeaderContent()
Параметры: нет
Возвращаемое значение: string| Element | Text |null|undefined Содержимое заголовка этого InfoWindow. См. InfoWindowOptions.headerContent .
getHeaderDisabled
getHeaderDisabled()
Параметры: нет
Возвращаемое значение: boolean|undefined Отключена ли вся строка заголовка. См. InfoWindowOptions.headerDisabled .
getPosition
getPosition()
Параметры: нет
Возвращаемое значение: LatLng |null|undefined Положение LatLng этого InfoWindow.
getZIndex
getZIndex()
Параметры: нет
Возвращаемое значение: number zIndex этого InfoWindow.
open
open([options, anchor])
Параметры:
  • options : InfoWindowOpenOptions | Map | StreetViewPanorama optional Объект InfoWindowOpenOptions (рекомендуется) или карта|панорама, на которой будет отображаться это InfoWindow.
  • anchor : MVCObject | AdvancedMarkerElement optional Якорь, к которому будет прикреплён этот объект InfoWindow. Если якорь не равен нулю, InfoWindow будет расположен по центру вверху якоря. InfoWindow будет отображаться на той же карте или панораме, что и якорь (при наличии) .
Возвращаемое значение: нет
Открывает данное окно InfoWindow на заданной карте. При необходимости окно InfoWindow можно связать с якорем. В базовом API единственным якорем является класс Marker. Однако якорем может быть любой объект MVCObject, предоставляющий свойство LatLng position и, при необходимости, свойство Point anchorPoint для расчета pixelOffset (см. InfoWindowOptions). anchorPoint — это смещение от позиции якоря до края окна InfoWindow. Рекомендуется использовать интерфейс InfoWindowOpenOptions в качестве единственного аргумента для этого метода. Чтобы предотвратить изменение фокуса браузера при открытии, установите для InfoWindowOpenOptions.shouldFocus значение false .
setContent
setContent([content])
Параметры:
  • content : string| Element | Text optional Содержимое, которое будет отображаться этим InfoWindow.
Возвращаемое значение: нет
setHeaderContent
setHeaderContent([headerContent])
Параметры:
Возвращаемое значение: нет
setHeaderDisabled
setHeaderDisabled([headerDisabled])
Параметры:
  • headerDisabled : boolean optional Указывает, следует ли отключить всю строку заголовка. См. InfoWindowOptions.headerDisabled .
Возвращаемое значение: нет
setOptions
setOptions([options])
Параметры:
Возвращаемое значение: нет
setPosition
setPosition([position])
Параметры:
  • position : LatLng | LatLngLiteral optional Позиция LatLng, в которой будет отображаться это информационное окно.
Возвращаемое значение: нет
setZIndex
setZIndex(zIndex)
Параметры:
  • zIndex : number Z-индекс для данного информационного окна. Информационное окно с большим значением z-индекса будет отображаться поверх всех остальных информационных окон с меньшим значением z-индекса.
Возвращаемое значение: нет
Унаследовано: addListener , bindTo , get , notify , set , setValues , unbind , unbindAll
close
function()
Аргументы: нет
Это событие вызывается при закрытии окна InfoWindow . Например, это может быть вызвано вызовом метода InfoWindow.close , нажатием клавиши Esc для закрытия окна InfoWindow, нажатием кнопки закрытия или перемещением окна InfoWindow на другую карту.
closeclick
function()
Аргументы: нет
Это событие срабатывает при нажатии кнопки закрытия.
content_changed
function()
Аргументы: нет
Это событие вызывается при изменении свойства содержимого.
domready
function()
Аргументы: нет
Это событие срабатывает при присоединении элемента <div> с содержимым окна InfoWindow к DOM. Вы можете отслеживать это событие, если вы динамически формируете содержимое информационного окна.
headercontent_changed
function()
Аргументы: нет
Это событие возникает при изменении свойства headerContent.
headerdisabled_changed
function()
Аргументы: нет
Это событие возникает при изменении свойства headerDisabled.
position_changed
function()
Аргументы: нет
Это событие срабатывает при изменении свойства позиции.
visible
function()
Аргументы: нет
Это событие срабатывает, когда окно InfoWindow полностью отображается. Оно не срабатывает, когда InfoWindow сворачивается и возвращается на экран.
zindex_changed
function()
Аргументы: нет
Это событие возникает при изменении zIndex окна InfoWindow .

Интерфейс InfoWindowOptions

google.maps . InfoWindowOptions

Объект InfoWindowOptions, используемый для определения свойств, которые можно установить для InfoWindow.

ariaLabel optional
Тип: string optional
AriaLabel для назначения InfoWindow.
content optional
Тип: string| Element | Text optional
Содержимое, отображаемое в InfoWindow. Это может быть HTML-элемент, простая текстовая строка или строка, содержащая HTML. Размер InfoWindow будет изменяться в соответствии с содержимым. Чтобы задать конкретный размер содержимого, укажите в качестве содержимого HTML-элемент с нужным размером.
disableAutoPan optional
Тип: boolean optional
По умолчанию: false
Отключите панорамирование карты, чтобы окно InfoWindow было полностью видно при его открытии.
headerContent optional
Тип: string| Element | Text optional
Содержимое, отображаемое в строке заголовка InfoWindow. Это может быть HTML-элемент или строка обычного текста. Размер InfoWindow будет изменяться в соответствии с содержимым. Чтобы задать явный размер для содержимого заголовка, укажите в headerContent HTML-элемент с нужным размером.
headerDisabled optional
Тип: boolean optional
Отключает всю строку заголовка в InfoWindow. При значении true заголовок будет удалён, а его содержимое и кнопка закрытия будут скрыты.
maxWidth optional
Тип: number optional
Максимальная ширина окна InfoWindow, независимо от ширины содержимого. Это значение учитывается только в том случае, если оно установлено до вызова метода open() . Чтобы изменить максимальную ширину при изменении содержимого, вызовите методы close() , setOptions() , а затем open() .
minWidth optional
Тип: number optional
Минимальная ширина InfoWindow, независимо от ширины содержимого. При использовании этого свойства настоятельно рекомендуется установить значение minWidth меньше ширины карты (в пикселях). Это значение учитывается только в том случае, если оно установлено до вызова метода open() . Чтобы изменить минимальную ширину при изменении содержимого, вызовите методы close() , setOptions() , а затем open() .
pixelOffset optional
Тип: Size optional
Смещение (в пикселях) края информационного окна от точки на карте, к которой оно привязано (в географических координатах). Если InfoWindow открывается с якорем, значение pixelOffset будет рассчитано на основе свойства anchorPoint якоря.
position optional
Тип: LatLng | LatLngLiteral optional
Координаты LatLng, по которым будет отображаться данное информационное окно. Если информационное окно открыто с якорем, вместо него будет использоваться положение якоря.
zIndex optional
Тип: number optional
Все информационные окна отображаются на карте в порядке их zIndex: окна с более высокими значениями отображаются перед окнами с более низкими значениями. По умолчанию информационные окна отображаются в соответствии с их широтой: окна с более низкими значениями отображаются перед окнами с более высокими значениями. Информационные окна всегда отображаются перед маркерами.

Интерфейс InfoWindowOpenOptions

google.maps . InfoWindowOpenOptions

Варианты открытия InfoWindow

anchor optional
Тип: MVCObject | AdvancedMarkerElement optional
Якорь, к которому будет прикреплён этот инфо-окно. Если якорь ненулевой, инфо-окно будет размещено по центру вверху якоря. Инфо-окно будет отображаться на той же карте или панораме, что и якорь (при наличии) .
map optional
Тип: Map | StreetViewPanorama optional
Карта или панорама, на которой будет отображаться это информационное окно.
shouldFocus optional
Тип: boolean optional
Необходимо ли перемещать фокус внутри окна InfoWindow при его открытии. Если это свойство не задано или имеет значение null или undefined , для определения необходимости перемещения фокуса используется эвристический алгоритм. Рекомендуется явно задать это свойство в соответствии с вашими потребностями, поскольку эвристический алгоритм может изменяться и работать не во всех случаях.