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])
参数： 
  • options：InfoWindowOpenOptions|Map|StreetViewPanorama optional 要呈现此 InfoWindow 的 InfoWindowOpenOptions 对象（推荐）或地图/全景。
  • anchor：MVCObject|AdvancedMarkerElement optional此信息窗口将定位到的锚点。如果锚点不为 null，InfoWindow 将位于锚点的顶部中心位置。InfoWindow 将在与锚点相同的地图或全景图片上呈现（如果可用）。
返回值：无
在指定地图上打开此 InfoWindow。您可以选择将信息窗口与锚点相关联。在核心 API 中，唯一的锚点是 Marker 类。不过，锚点可以是任何公开 LatLng position 属性的 MVCObject，也可以选择性地公开用于计算 pixelOffset 的 Point anchorPoint 属性（请参阅 InfoWindowOptions）。anchorPoint 是从锚点位置到信息窗口尖端的偏移量。建议使用 InfoWindowOpenOptions 接口作为此方法的唯一实参。如需防止在打开时更改浏览器焦点，请将 InfoWindowOpenOptions.shouldFocus 设置为 false。
setContent
setContent([content])
参数： 
  • content：string|Element|Text optional此信息窗口要显示的内容。
返回值：无
setHeaderContent
setHeaderContent([headerContent])
参数： 
返回值：无
setHeaderDisabled
setHeaderDisabled([headerDisabled])
参数： 
返回值：无
setOptions
setOptions([options])
参数： 
返回值：无
setPosition
setPosition([position])
参数： 
返回值：无
setZIndex
setZIndex(zIndex)
参数： 
  • zIndex：number 此信息窗口的 z-index。Z-index 值较大的信息窗口将显示在所有其他 z-index 值较小的信息窗口前面。
返回值：无
继承自： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
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
是否应在信息窗口打开后将焦点移至其中。如果未设置此属性，或将其设置为 null 或 undefined，系统会使用启发式方法来决定是否应移动焦点。建议您根据自己的需求显式设置此属性，因为启发式方法可能会发生变化，并且可能无法很好地适用于所有使用情形。