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])
参数
使用指定选项创建一个信息窗口。信息窗口可以放置在地图上的特定位置,也可以放置在标记上方,具体取决于选项中指定的内容。除非停用自动平移,否则信息窗口会在打开时平移地图,以便让自己显示出来。信息窗口构建完毕后,必须调用 open 函数,才能将其显示在地图上。用户可以点击信息窗口上的关闭按钮将其从地图中关闭,开发人员也可以调用 close() 函数实现同样的效果。
isOpen
类型boolean
检查信息窗口是否打开。
close
close()
参数:无
返回值:None
关闭此信息窗口,方法是将其从 DOM 结构中删除。
focus
focus()
参数:无
返回值:None
将焦点设置在此InfoWindow上。您不妨考虑将此方法与 visible 事件结合使用,以确保 InfoWindow 在设置焦点之前可见。不可见的 InfoWindow 无法获得焦点。
getContent
getContent()
参数:无
返回值string|Element|Text|null|undefined此信息窗口的内容。与之前为内容设置的内容相同。
getHeaderContent
getHeaderContent()
参数:无
返回值string|Element|Text|null|undefined此信息窗口的标头内容。请参阅 InfoWindowOptions.headerContent
getHeaderDisabled
getHeaderDisabled()
参数:无
返回值boolean|undefined 是否停用整个标题行。请参阅 InfoWindowOptions.headerDisabled
getPosition
getPosition()
参数:无
返回值LatLng|null|undefined此信息窗口的 LatLng 位置。
getZIndex
getZIndex()
参数:无
返回值number该信息窗口的 zIndex。
open
open([options, anchor])
参数
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional InfoWindowOpenOptions 对象(推荐)或要在其上呈现此信息窗口的地图|全景图片。
  • anchorMVCObject|AdvancedMarkerElement optional信息窗口将放置到的锚点。如果锚点为非空,则信息窗口将定位在锚点的上中心。信息窗口将渲染在与锚点相同的地图或全景上(如果可用)。
返回值:None
在指定的地图上打开此信息窗口。信息窗口可以与锚点相关联(可选)。在核心 API 中,唯一的锚点是 Marker 类。不过,锚点可以是公开 LatLng position 属性以及用于计算 pixelOffset 的 Point anchorPoint 属性的任意 MVCObject(请参见 InfoWindowOptions)。anchorPoint 是从锚点位置到信息窗口顶端的偏移量。建议使用 InfoWindowOpenOptions 接口作为此方法的单个参数。为了防止将浏览器焦点更改为打开时,请将 InfoWindowOpenOptions.shouldFocus 设置为 false
setContent
setContent([content])
参数
  • contentstring|Element|Text optional此信息窗口要显示的内容。
返回值:None
setHeaderContent
setHeaderContent([headerContent])
参数
返回值:None
setHeaderDisabled
setHeaderDisabled([headerDisabled])
参数
返回值:None
setOptions
setOptions([options])
参数
返回值:None
setPosition
setPosition([position])
参数
返回值:None
setZIndex
setZIndex(zIndex)
参数
  • zIndexnumber此信息窗口的 Z-index。Z-index 较高的信息窗口会显示在其他所有 Z-index 较低的信息窗口前面。
返回值:None
已继承addListenerbindTogetnotifysetsetValuesunbindunbindAll
close
function()
参数:None
每当 InfoWindow 关闭时都会触发此事件。例如,调用 InfoWindow.close 方法、按 Esc 键关闭信息窗口、点击关闭按钮或将信息窗口移至其他地图。
closeclick
function()
参数:None
点击关闭按钮时会触发此事件。
content_changed
function()
参数:None
内容属性更改时会触发此事件。
domready
function()
参数:None
当包含 InfoWindow 内容的 <div> 附加到 DOM 时,会触发此事件。如果您要动态构建信息窗口内容,则可能希望监视此事件。
headercontent_changed
function()
参数:None
当 headerContent 属性更改时会触发此事件。
headerdisabled_changed
function()
参数:None
当 headerDisabled 属性更改时会触发此事件。
position_changed
function()
参数:None
位置属性更改时会触发此事件。
visible
function()
参数:None
InfoWindow 完全可见时会触发此事件。当 InfoWindow 平移关闭然后返回到屏幕上时,不会触发此事件。
zindex_changed
function()
参数:None
InfoWindow 的 zIndex 发生更改时会触发此事件。

InfoWindowOptions 接口

google.maps.InfoWindowOptions 接口

InfoWindowOptions 对象,用于定义可在信息窗口上设置的属性。

ariaLabel optional
类型string optional
要分配给信息窗口的 AriaLabel。
content optional
类型string|Element|Text optional
要在信息窗口中显示的内容。这可以是 HTML 元素、纯文本字符串或包含 HTML 的字符串。信息窗口将根据内容调整大小。要设置内容的具体大小,请将内容设置为相应大小的 HTML 元素。
disableAutoPan optional
类型boolean optional
默认值false
停用平移地图的功能,使信息窗口在打开后完全可见。
headerContent optional
类型string|Element|Text optional
要在信息窗口标题行中显示的内容。这可以是 HTML 元素或纯文本字符串。信息窗口将根据内容调整大小。要为标头内容设置明确的尺寸,请将 headerContent 设置为该尺寸的 HTML 元素。
headerDisabled optional
类型boolean optional
停用信息窗口中的整个标题行。如果设为 true,系统会移除页眉,以便隐藏页眉内容和关闭按钮。
maxWidth optional
类型number optional
信息窗口的最大宽度(与内容的宽度无关)。只有在调用 open() 之前设置此值时,系统才会考虑使用此值。如需在更改内容时更改最大宽度,请调用 close()setOptions(),然后调用 open()
minWidth optional
类型number optional
信息窗口的最小宽度(与内容的宽度无关)。使用此属性时,强烈建议将 minWidth 设置为小于地图宽度(以像素为单位)的值。只有在调用 open() 之前设置此值时,系统才会考虑使用此值。如需在更改内容时更改最小宽度,请调用 close()setOptions(),然后调用 open()
pixelOffset optional
类型Size optional
信息窗口的顶端相对于地图上锚定信息窗口的地理坐标点的偏移量(以像素为单位)。如果信息窗口是通过锚点打开的,则系统将根据锚点的 anchorPoint 属性计算 pixelOffset
position optional
类型LatLng|LatLngLiteral optional
用于显示此信息窗口的 LatLng。如果信息窗口通过锚点打开,则系统将使用锚点的位置。
zIndex optional
类型number optional
所有信息窗口都按其 zIndex 的顺序显示在地图上,值较高的信息窗口显示在值较低的信息窗口前面。默认情况下,信息窗口根据纬度显示,纬度较低的信息窗口显示在纬度较高的信息窗口前面。信息窗口始终在标记前面显示。

InfoWindowOpenOptions 接口

google.maps.InfoWindowOpenOptions 接口

用于打开信息窗口的选项

anchor optional
此信息窗口将放置到的锚点。如果锚点为非空,则信息窗口将定位在锚点的上中心。信息窗口将渲染在与锚点相同的地图或全景上(如果可用)。
map optional
类型Map|StreetViewPanorama optional
用来渲染此信息窗口的地图或全景图片。
shouldFocus optional
类型boolean optional
信息窗口打开时是否应将其移动至该窗口内。如果未设置此属性或者将其设置为 nullundefined,系统会使用启发法来确定是否应移动焦点。建议您根据自己的需求明确设置此属性,因为启发法随时可能更改,并且可能不适合所有用例。