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() 参数:无
|
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]) 参数:
返回值:None
在指定的地图上打开此信息窗口。信息窗口可以与锚点相关联(可选)。在核心 API 中,唯一的锚点是 Marker 类。不过,锚点可以是公开 LatLng position 属性以及用于计算 pixelOffset 的 Point anchorPoint 属性的任意 MVCObject(请参见 InfoWindowOptions)。anchorPoint 是从锚点位置到信息窗口顶端的偏移量。建议使用 InfoWindowOpenOptions 接口作为此方法的单个参数。为了防止将浏览器焦点更改为打开时,请将 InfoWindowOpenOptions.shouldFocus 设置为 false 。 |
setContent |
setContent([content]) 返回值:None
|
setHeaderContent |
setHeaderContent([headerContent]) 参数:
返回值:None
|
setHeaderDisabled |
setHeaderDisabled([headerDisabled]) 参数:
返回值:None
|
setOptions |
setOptions([options]) 参数:
返回值:None
|
setPosition |
setPosition([position]) 参数:
返回值:None
|
setZIndex |
setZIndex(zIndex) 参数:
返回值:None
|
已继承:
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
接口
InfoWindowOptions 对象,用于定义可在信息窗口上设置的属性。
属性 | |
---|---|
ariaLabel optional |
类型:
string optional 要分配给信息窗口的 AriaLabel。 |
content optional |
要在信息窗口中显示的内容。这可以是 HTML 元素、纯文本字符串或包含 HTML 的字符串。信息窗口将根据内容调整大小。要设置内容的具体大小,请将内容设置为相应大小的 HTML 元素。 |
disableAutoPan optional |
类型:
boolean optional 默认值:
false 停用平移地图的功能,使信息窗口在打开后完全可见。 |
headerContent 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 |
类型:
MVCObject|AdvancedMarkerElement optional 此信息窗口将放置到的锚点。如果锚点为非空,则信息窗口将定位在锚点的上中心。信息窗口将渲染在与锚点相同的地图或全景上(如果可用)。 |
map optional |
类型:
Map|StreetViewPanorama optional 用来渲染此信息窗口的地图或全景图片。 |
shouldFocus optional |
类型:
boolean optional 信息窗口打开时是否应将其移动至该窗口内。如果未设置此属性或者将其设置为 null 或 undefined ,系统会使用启发法来确定是否应移动焦点。建议您根据自己的需求明确设置此属性,因为启发法随时可能更改,并且可能不适合所有用例。 |