Clase InfoWindow
Clase google.maps.InfoWindow
Superposición que parece una burbuja y, a menudo, está conectada a un marcador.
Esta clase extiende MVCObject
.
Para acceder, llama a const {InfoWindow} = await google.maps.importLibrary("maps")
o const {InfoWindow} = await google.maps.importLibrary("streetView")
. Consulta el artículo Bibliotecas de la API de Maps JavaScript.
Constructor | |
---|---|
InfoWindow |
InfoWindow([opts]) Parámetros:
Crea una ventana de información con las opciones determinadas. Las ventanas de información se pueden colocar en el mapa en una posición determinada o encima de un marcador, según lo que se especifique en las opciones. A menos que el desplazamiento lateral automático esté inhabilitado, una ventana de información desplaza el mapa para que sea visible cuando se abra. Después de construir un objeto InfoWindow, debes llamar a open para mostrarlo en el mapa. El usuario puede hacer clic en el botón de cierre de la ventana de información para quitarla del mapa, o el desarrollador puede llamar a cerrar() para obtener el mismo efecto. |
Métodos | |
---|---|
close |
close() Parámetros: Ninguno
Valor que se devuelve: Ninguno
Cierra esta ventana de información quitándola de la estructura del DOM. |
focus |
focus() Parámetros: Ninguno
Valor que se devuelve: Ninguno
Establece el foco en este InfoWindow . Te recomendamos que consideres usar este método junto con un evento visible para asegurarte de que InfoWindow sea visible antes de establecer el enfoque en él. No se puede enfocar un elemento InfoWindow que no es visible. |
getContent |
getContent() Parámetros: Ninguno
|
getPosition |
getPosition() Parámetros: Ninguno
Valor que se muestra:
LatLng|null|undefined : Es la posición LatLng de este InfoWindow. |
getZIndex |
getZIndex() Parámetros: Ninguno
Valor que se muestra:
number : Es el zIndex de esta ventana de información. |
open |
open([options, anchor]) Parámetros:
Valor que se devuelve: Ninguno
Abre esta ventana de información en el mapa determinado. De manera opcional, se puede asociar un elemento InfoWindow con un ancla. En la API principal, el único ancla es la clase Marker. Sin embargo, un ancla puede ser cualquier MVCObject que exponga una propiedad position de LatLng y, opcionalmente, una propiedad anchorPoint de Point para calcular pixelOffset (consulta InfoWindowOptions). anchorPoint es el desplazamiento desde la posición del ancla hasta la punta de la ventana de información. Se recomienda usar la interfaz InfoWindowOpenOptions como argumento único para este método. Para evitar cambiar el enfoque del navegador cuando esté abierto, establece InfoWindowOpenOptions.shouldFocus en false . |
setContent |
setContent([content]) Parámetros:
Valor que se devuelve: Ninguno
|
setOptions |
setOptions([options]) Parámetros:
Valor que se devuelve: Ninguno
|
setPosition |
setPosition([position]) Parámetros:
Valor que se devuelve: Ninguno
|
setZIndex |
setZIndex(zIndex) Parámetros:
Valor que se devuelve: Ninguno
|
Heredado:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventos | |
---|---|
close |
function() Argumentos: Ninguno
Este evento se activa cada vez que se cierra InfoWindow . Por ejemplo, esto podría deberse a llamar al método InfoWindow.close , presionar la tecla Escape para cerrar la ventana de información, hacer clic en el botón para cerrar o mover la ventana de información a otro mapa. |
closeclick |
function() Argumentos: Ninguno
Este evento se activa cuando se hace clic en el botón de cierre. |
content_changed |
function() Argumentos: Ninguno
Este evento se activa cuando la propiedad de contenido cambia. |
domready |
function() Argumentos: Ninguno
Este evento se activa cuando la <div> que contiene el contenido de InfoWindow se adjunta al DOM. Te recomendamos que supervises este evento si creas el contenido de la ventana de información de forma dinámica. |
headercontent_changed |
function() Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad headerContent. |
headerdisabled_changed |
function() Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad headerDisabled. |
position_changed |
function() Argumentos: Ninguno
Este evento se activa cuando la propiedad de posición cambia. |
visible |
function() Argumentos: Ninguno
Este evento se activa cuando InfoWindow está completamente visible. Este evento no se activa cuando InfoWindow se desplaza lateralmente y vuelve a aparecer en la pantalla. |
zindex_changed |
function() Argumentos: Ninguno
Este evento se activa cuando cambia el zIndex de InfoWindow . |
InfoWindowOptions
Interfaz de google.maps.InfoWindowOptions
InfoWindowOptions, que se usa para definir las propiedades que se pueden configurar en un objeto InfoWindow.
Propiedades | |
---|---|
ariaLabel optional |
Tipo:
string optional AriaLabel para asignarla a la ventana de información. |
content optional |
Contenido que se mostrará en la ventana de información. Puede ser un elemento HTML, una cadena de texto sin formato o una cadena que contenga HTML. Se ajustará el tamaño de la ventana de información según el contenido. Para establecer un tamaño explícito en el contenido, configúralo como un elemento HTML con ese tamaño. |
disableAutoPan optional |
Tipo:
boolean optional Valor predeterminado:
false Inhabilita el desplazamiento lateral del mapa para que el elemento InfoWindow sea completamente visible cuando se abra. |
headerContent optional |
El contenido que se mostrará en la fila de encabezado InfoWindow. Puede ser un elemento HTML o una cadena que contenga HTML. Se ajustará el tamaño de la ventana de información según el contenido. A fin de establecer un tamaño explícito para el contenido del encabezado, configura headerContent como un elemento HTML con ese tamaño. |
headerDisabled optional |
Tipo:
boolean optional Inhabilita toda la fila del encabezado en la ventana de información. Si se establece como verdadero, se quitará el encabezado para ocultar el contenido del encabezado y el botón de cierre. |
maxWidth optional |
Tipo:
number optional Es el ancho máximo del elemento InfoWindow, sin importar el ancho del contenido. Este valor solo se considera si se configura antes de una llamada a open() . Para cambiar el ancho máximo cuando cambies el contenido, llama a close() , setOptions() y, luego, a open() . |
minWidth optional |
Tipo:
number optional Es el ancho mínimo del elemento InfoWindow, sin importar el ancho del contenido. Cuando uses esta propiedad, se recomienda establecer minWidth en un valor inferior al ancho del mapa (en píxeles). Este valor solo se considera si se configura antes de una llamada a open() . Para cambiar el ancho mínimo cuando cambies el contenido, llama a close() , setOptions() y, luego, a open() . |
pixelOffset optional |
Tipo:
Size optional Desplazamiento, en píxeles, de la punta de la ventana de información a partir del punto del mapa en cuyas coordenadas geográficas está anclada. Si se abre una InfoWindow con un ancla, el pixelOffset se calculará a partir de la propiedad anchorPoint del ancla. |
position optional |
Tipo:
LatLng|LatLngLiteral optional El objeto LatLng en el que se muestra esta InfoWindow. Si se abre InfoWindow con un ancla, se usará su posición. |
zIndex optional |
Tipo:
number optional Todas las InfoWindows se muestran en el mapa en el orden de su zIndex, y los valores más altos se muestran delante de InfoWindows con valores más bajos. De forma predeterminada, los InfoWindows se muestran según su latitud, y los InfoWindows de latitudes inferiores aparecen delante de InfoWindows en latitudes más altas. Siempre se muestran InfoWindows delante de los marcadores. |
InfoWindowOpenOptions
Interfaz de google.maps.InfoWindowOpenOptions
Opciones para abrir una ventana de información
Propiedades | |
---|---|
anchor optional |
Tipo:
MVCObject|AdvancedMarkerElement optional El anclaje en el que se posicionará esta ventana de información. Si el ancla no es nulo, la ventana de información se posicionará en la parte superior central del ancla. La ventana de información se renderizará en el mismo mapa o panorámica que el ancla (cuando esté disponible). |
map optional |
Tipo:
Map|StreetViewPanorama optional El mapa o la panorámica en los que se debe renderizar esta ventana de información. |
shouldFocus optional |
Tipo:
boolean optional Indica si el foco debe moverse o no dentro de la ventana de información cuando se abre. Cuando esta propiedad no se establece o se establece en null o undefined , se usa una heurística para decidir si el foco se debe mover o no. Se recomienda configurar esta propiedad de forma explícita para que se adapte a tus necesidades, ya que la heurística está sujeta a cambios y es posible que no funcione bien en todos los casos de uso. |