Info Window

Класс инфоокна

google.maps . 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 необходимо вызвать open, чтобы отобразить его на карте. Пользователь может нажать кнопку закрытия в InfoWindow, чтобы удалить его с карты, или разработчик может вызвать close() для того же эффекта.
close
close()
Параметры: Нет
Возвращаемое значение: Нет
Закрывает это информационное окно, удаляя его из структуры DOM.
focus
focus()
Параметры: Нет
Возвращаемое значение: Нет
Устанавливает фокус на этом InfoWindow . Возможно, вы захотите использовать этот метод вместе с visible событием, чтобы убедиться, что InfoWindow видим, прежде чем устанавливать на него фокус. Невидимое InfoWindow не может быть сфокусировано.
getContent
getContent()
Параметры: Нет
Возвращаемое значение: string| Element | Text |null|undefined Содержимое этого информационного окна. То же, что ранее было установлено в качестве содержимого.
getPosition
getPosition()
Параметры: Нет
Возвращаемое значение: LatLng |null|undefined Позиция LatLng этого InfoWindow.
getZIndex
getZIndex()
Параметры: Нет
Возвращаемое значение: number Индекс zIndex этого информационного окна.
open
open([options, anchor])
Параметры:
  • options : InfoWindowOpenOptions | Map | StreetViewPanorama optional Либо объект InfoWindowOpenOptions (рекомендуется), либо карта|панорама, на которой будет отображаться это InfoWindow.
  • anchor : MVCObject | AdvancedMarkerElement optional Привязка, на которой будет расположено это информационное окно. Если привязка не равна нулю, InfoWindow будет расположен в верхней центральной части привязки. InfoWindow будет отображаться на той же карте или панораме, что и привязка (если она доступна) .
Возвращаемое значение: Нет
Открывает это информационное окно на данной карте. При желании InfoWindow может быть связан с привязкой. В базовом API единственной привязкой является класс Marker. Однако привязкой может быть любой объект MVCObject, который предоставляет свойство position LatLng и, при необходимости, свойство anchorPoint для расчета pixelOffset (см. InfoWindowOptions). anchorPoint — это смещение от позиции привязки до кончика InfoWindow. Рекомендуется использовать интерфейс InfoWindowOpenOptions в качестве единственного аргумента этого метода. Чтобы предотвратить изменение фокуса браузера при открытии, установите для InfoWindowOpenOptions.shouldFocus значение false .
setContent
setContent([content])
Параметры:
  • content : string| Element | Text optional Содержимое, которое будет отображаться в этом информационном окне.
Возвращаемое значение: Нет
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 , нажатие клавиши Escape, чтобы закрыть InfoWindow, нажатие кнопки закрытия или перемещение InfoWindow на другую карту.
closeclick
function()
Аргументы: Нет
Это событие вызывается при нажатии кнопки закрытия.
content_changed
function()
Аргументы: Нет
Это событие вызывается при изменении свойства содержимого.
domready
function()
Аргументы: Нет
Это событие вызывается, когда <div> содержащий содержимое InfoWindow , прикрепляется к DOM. Возможно, вы захотите отслеживать это событие, если вы динамически формируете содержимое своего информационного окна.
Beta headercontent_changed
function()
Аргументы: Нет
Это событие вызывается при изменении свойства headerContent.
Beta headerdisabled_changed
function()
Аргументы: Нет
Это событие вызывается при изменении свойства headerDisabled.
position_changed
function()
Аргументы: Нет
Это событие вызывается при изменении свойства позиции.
visible
function()
Аргументы: Нет
Это событие вызывается, когда InfoWindow становится полностью видимым. Это событие не запускается, когда InfoWindow выключается, а затем снова отображается на экране.
zindex_changed
function()
Аргументы: Нет
Это событие вызывается при изменении zIndex InfoWindow .

Интерфейс InfoWindowOptions

google.maps . 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
Отключите панорамирование карты, чтобы информационное окно было полностью видно при его открытии.
Beta headerContent optional
Тип: string| Element | Text optional
Содержимое, отображаемое в строке заголовка InfoWindow. Это может быть элемент HTML или строка, содержащая HTML. Размер InfoWindow будет зависеть от содержимого. Чтобы задать явный размер содержимого заголовка, задайте headerContent как элемент HTML с этим размером.
Beta 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 для отображения этого информационного окна. Если InfoWindow открывается с помощью привязки, вместо этого будет использоваться позиция привязки.
zIndex optional
Тип: number optional
Все информационные окна отображаются на карте в порядке их индекса zIndex, при этом более высокие значения отображаются перед информационными окнами с более низкими значениями. По умолчанию InfoWindows отображаются в соответствии с их широтой, при этом InfoWindows из более низких широт появляются перед InfoWindows из более высоких широт. Информационные окна всегда отображаются перед маркерами.

Интерфейс InfoWindowOpenOptions

google.maps . InfoWindowOpenOptions Интерфейс google.maps . InfoWindowOpenOptions

Варианты открытия информационного окна

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