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 后,您必须调用 open 才能在地图上显示它。用户可以点击信息窗口上的关闭按钮将其从地图中关闭,开发人员也可以调用 close() 函数实现同样的效果。
close
close()
参数:无
返回值:无
关闭此信息窗口,方法是将其从 DOM 结构中删除。
focus
focus()
参数:无
返回值:无
将焦点置于此 InfoWindow。您不妨考虑考虑将此方法与 visible 事件搭配使用,以确保在设置焦点之前显示 InfoWindow。不可见的 InfoWindow 无法聚焦。
getContent
getContent()
参数:无
返回值string|Element|Text|null|undefined此 InfoWindow 的内容。与之前设置为内容的内容相同。
getPosition
getPosition()
参数:无
返回值LatLng|null|undefined此 InfoWindow 的 LatLng 位置。
getZIndex
getZIndex()
参数:无
返回值number此 InfoWindow 的 zIndex。
open
open([options, anchor])
参数
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional InfoWindowOpenOptions 对象(推荐)或渲染此 InfoWindow 的地图/全景图片。
  • anchorMVCObject|AdvancedMarkerElement optional 该 Window 将定位的锚点。如果锚点为非 null,信息窗口将定位在锚点的正中心。信息窗口将与锚点(如果可用)相同的地图或全景图片呈现
返回值:无
打开指定地图上的此 InfoWindow。信息窗口也可以与锚点相关联。在核心 API 中,唯一的锚点是 Marker 类。不过,锚点可以是公开 LatLng position 属性的任何 MVCObject,也可以是用于计算 pixelOffset 的 Point anchorPoint 属性(请参阅 InfoWindowOptions)。anchorPoint 是从锚点位置到信息窗口顶端的偏移量。建议将 InfoWindowOpenOptions 接口用作此方法的单个参数。为防止更改浏览器处于打开状态的焦点,请将 InfoWindowOpenOptions.shouldFocus 设为 false
setContent
setContent([content])
参数
  • contentstring|Element|Text optional要通过此信息窗口显示的内容。
返回值:无
setOptions
setOptions([options])
参数
返回值:无
setPosition
setPosition([position])
参数
返回值:无
setZIndex
setZIndex(zIndex)
参数
  • zIndexnumber此 InfoWindow 的 Z-index。Z-index 值较高的信息窗口将显示在 Z-index 值较低的所有其他信息窗口的前面。
返回值:无
继承addListenerbindTogetnotifysetsetValuesunbindunbindAll
closeclick
function()
参数:None
点击关闭按钮时会触发此事件。
content_changed
function()
参数:None
内容属性更改时会触发此事件。
domready
function()
参数:None
当包含 InfoWindow 内容的 <div> 附加到 DOM 时,会触发此事件。如果您要动态构建信息窗口内容,则可能希望监视此事件。
position_changed
function()
参数:None
位置属性更改时会触发此事件。
visible
function()
参数:None
InfoWindow 完全可见时会触发此事件。当 InfoWindow 平移并随后返回屏幕时,不会触发此事件。
zindex_changed
function()
参数:None
InfoWindow 的 zIndex 发生更改时会触发此事件。

InfoWindowOptions 接口

google.maps.InfoWindowOptions 接口

InfoWindowOptions 对象,用于定义可在 InfoWindow 上设置的属性。

ariaLabel optional
类型string optional
要分配给信息窗口的 AriaLabel。
content optional
类型string|Element|Text optional
要在信息窗口中显示的内容。这可以是 HTML 元素、纯文本字符串或包含 HTML 的字符串。系统会根据内容调整信息窗口的大小。要设置内容的具体大小,请将内容设置为相应大小的 HTML 元素。
disableAutoPan optional
类型boolean optional
默认false
停用平移地图,使 InfoWindow 在打开时完全可见。
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
要显示此 InfoWindow 的 LatLng。如果使用信息窗口打开 InfoWindow,则会改用锚点的位置。
zIndex optional
类型number optional
所有 InfoWindows 都会按其 zIndex 的顺序显示在地图上,值较高的 InfoWindows 会显示在 InfoWindows 前面,数值较低。默认情况下,InfoWindows 会根据纬度显示,而较低纬度的 InfoWindows 则位于 InfoWindows 的较高纬度前。信息窗口始终在标记前面显示。

InfoWindowOpenOptions 接口

google.maps.InfoWindowOpenOptions 接口

用于打开信息窗口的选项

anchor optional
此信息窗口将定位的锚点。如果锚点为非 null,信息窗口将定位在锚点的正中心。信息窗口将与锚点(如果可用)相同的地图或全景图片呈现
map optional
类型Map|StreetViewPanorama optional
要渲染此 InfoWindow 的地图或全景图片。
shouldFocus optional
类型boolean optional
信息窗口在打开时是否应移动到其中。当此属性未设置或设为 nullundefined 时,系统会使用启发法来确定是否应移动焦点。建议您明确设置此属性以满足自己的需求,因为启发法随时可能发生变化,并且可能无法在某些用例中使用。