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 才能在地图上显示它。用户可以点击信息窗口上的关闭按钮将其从地图中关闭,开发人员也可以调用 close() 函数实现同样的效果。
isOpen
类型:  boolean
检查 InfoWindow 是否已打开。
close
close()
参数:无
返回值:无
关闭此信息窗口,方法是将其从 DOM 结构中删除。
focus
focus()
参数:无
返回值:无
将焦点设置到此 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 要呈现此 InfoWindow 的 InfoWindowOpenOptions 对象(推荐)或地图/全景。
  • anchorMVCObject|AdvancedMarkerElement optional此信息窗口将定位到的锚点。如果锚点不为 null,InfoWindow 将位于锚点的顶部中心位置。InfoWindow 将在与锚点相同的地图或全景图片上呈现(如果可用)
返回值:无
在指定地图上打开此 InfoWindow。您可以选择将信息窗口与锚点相关联。在核心 API 中,唯一的锚点是 Marker 类。不过,锚点可以是任何公开 LatLng position 属性的 MVCObject,也可以选择性地公开用于计算 pixelOffset 的 Point anchorPoint 属性(请参阅 InfoWindowOptions)。anchorPoint 是从锚点位置到信息窗口尖端的偏移量。建议使用 InfoWindowOpenOptions 接口作为此方法的唯一实参。如需防止在打开时更改浏览器焦点,请将 InfoWindowOpenOptions.shouldFocus 设置为 false
setContent
setContent([content])
参数: 
  • contentstring|Element|Text optional此信息窗口要显示的内容。
返回值:无
setHeaderContent
setHeaderContent([headerContent])
参数: 
返回值:无
setHeaderDisabled
setHeaderDisabled([headerDisabled])
参数: 
返回值:无
setOptions
setOptions([options])
参数: 
返回值:无
setPosition
setPosition([position])
参数: 
返回值:无
setZIndex
setZIndex(zIndex)
参数: 
  • zIndexnumber 此信息窗口的 z-index。Z-index 值较大的信息窗口将显示在所有其他 z-index 值较小的信息窗口前面。
返回值:无
继承自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 接口

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

ariaLabel optional
类型:  string optional
要分配给信息窗口的 AriaLabel。
content optional
类型:  string|Element|Text optional
要在 InfoWindow 中显示的内容。可以是 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 接口

用于打开 InfoWindow 的选项

anchor optional
类型:  MVCObject|AdvancedMarkerElement optional
此 InfoWindow 将定位到的锚点。如果锚点不为 null,InfoWindow 将位于锚点的顶部中心位置。InfoWindow 将在与锚点相同的地图或全景图片上呈现(如果可用)
map optional
类型:  Map|StreetViewPanorama optional
用于渲染相应信息窗口的地图或全景。
shouldFocus optional
类型:  boolean optional
是否应在信息窗口打开后将焦点移至其中。如果未设置此属性,或将其设置为 nullundefined,系统会使用启发式方法来决定是否应移动焦点。建议您根据自己的需求显式设置此属性,因为启发式方法可能会发生变化,并且可能无法很好地适用于所有使用情形。