Clase InfoWindow
Clase google.maps.InfoWindow
Es una superposición que parece una burbuja y que, a menudo, está conectada a un marcador.
Esta clase extiende MVCObject
.
Accede llamando a const {InfoWindow} = await google.maps.importLibrary("maps")
o const {InfoWindow} = await google.maps.importLibrary("streetView")
.
Consulta Bibliotecas en la API de Maps JavaScript.
Constructor | |
---|---|
InfoWindow |
InfoWindow([opts]) Parámetros:
Crea una ventana de información con las opciones proporcionadas. Se puede colocar una InfoWindow en un mapa en una posición determinada o sobre un marcador, según lo que se especifique en las opciones. A menos que se inhabilite el desplazamiento lateral automático, una InfoWindow desplazará lateralmente el mapa para hacerse 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 bien el desarrollador puede llamar a close() para obtener el mismo efecto. |
Propiedades | |
---|---|
isOpen |
Tipo:
boolean Comprueba si la ventana de información está abierta. |
Métodos | |
---|---|
close |
close() Parámetros: Ninguno
Valor de retorno: Ninguno
Cierra esta ventana de información quitándola de la estructura del DOM. |
focus |
focus() Parámetros: Ninguno
Valor de retorno: Ninguno
Establece el enfoque en este InfoWindow . Te recomendamos que uses este método junto con un evento visible para asegurarte de que InfoWindow esté visible antes de establecer el enfoque en él. No se puede enfocar un InfoWindow que no está visible. |
getContent |
getContent() Parámetros: Ninguno
|
getHeaderContent |
getHeaderContent() Parámetros: Ninguno
Valor de retorno:
string|Element|Text|null|undefined Es el contenido del encabezado de esta ventana de información. Consulta InfoWindowOptions.headerContent . |
getHeaderDisabled |
getHeaderDisabled() Parámetros: Ninguno
Valor de devolución:
boolean|undefined Indica si la fila de encabezado completa está inhabilitada o no. Consulta InfoWindowOptions.headerDisabled . |
getPosition |
getPosition() Parámetros: Ninguno
Valor de retorno:
LatLng|null|undefined La posición de LatLng de esta ventana de información. |
getZIndex |
getZIndex() Parámetros: Ninguno
Valor que se muestra:
number El zIndex de esta ventana de información. |
open |
open([options, anchor]) Parámetros:
Valor de retorno: Ninguno
Abre esta ventana de información en el mapa determinado. De manera opcional, se puede asociar una ventana de información con un ancla. En la API principal, el único elemento de anclaje es la clase Marker. Sin embargo, un ancla puede ser cualquier MVCObject que exponga una propiedad LatLng position y, de manera opcional, una propiedad Point anchorPoint para calcular el pixelOffset (consulta InfoWindowOptions). El anchorPoint es el desplazamiento desde la posición del ancla hasta la esquina de la ventana de información. Se recomienda usar la interfaz InfoWindowOpenOptions como único argumento para este método. Para evitar que se cambie el enfoque del navegador al abrirlo, establece InfoWindowOpenOptions.shouldFocus en false . |
setContent |
setContent([content]) Parámetros:
Valor de retorno: Ninguno
|
setHeaderContent |
setHeaderContent([headerContent]) Parámetros:
Valor de retorno: Ninguno
|
setHeaderDisabled |
setHeaderDisabled([headerDisabled]) Parámetros:
Valor de retorno: Ninguno
|
setOptions |
setOptions([options]) Parámetros:
Valor de retorno: Ninguno
|
setPosition |
setPosition([position]) Parámetros:
Valor de retorno: Ninguno
|
setZIndex |
setZIndex(zIndex) Parámetros:
Valor de retorno: Ninguno
|
Heredado:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventos | |
---|---|
close |
function() Argumentos: Ninguno
Este evento se activa cada vez que se cierra el objeto InfoWindow . Por ejemplo, esto podría deberse a una llamada al método InfoWindow.close , a presionar la tecla Escape para cerrar la ventana de información, a hacer clic en el botón de cierre o a 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 cambia la propiedad content. |
domready |
function() Argumentos: Ninguno
Este evento se activa cuando el <div> que contiene el contenido del InfoWindow se adjunta al DOM. Te recomendamos que supervises este evento si estás creando 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 cambia la propiedad position. |
visible |
function() Argumentos: Ninguno
Este evento se activa cuando el elemento InfoWindow es completamente visible. Este evento no se activa cuando InfoWindow se desplaza fuera de la pantalla y luego vuelve a aparecer. |
zindex_changed |
function() Argumentos: Ninguno
Este evento se activa cuando cambia el zIndex de InfoWindow . |
Interfaz InfoWindowOptions
Interfaz de google.maps.InfoWindowOptions
Objeto InfoWindowOptions que se usa para definir las propiedades que se pueden establecer en un objeto InfoWindow.
Propiedades | |
---|---|
ariaLabel optional |
Tipo:
string optional Es la etiqueta ariaLabel que se asignará a la ventana de información. |
content optional |
Es el 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. El tamaño de la ventana de información se ajustará según el contenido. Para establecer un tamaño explícito para el contenido, configúralo como un elemento HTML con ese tamaño. |
disableAutoPan optional |
Tipo:
boolean optional Predeterminado:
false Inhabilita el desplazamiento panorámico del mapa para que la ventana de información sea completamente visible cuando se abra. |
headerContent optional |
Es el contenido que se mostrará en la fila del encabezado de la ventana de información. Puede ser un elemento HTML o una cadena de texto sin formato. El tamaño de la ventana de información se ajustará según el contenido. Para 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. Cuando se establece como verdadero, se quita el encabezado para que se oculte el contenido del encabezado y el botón de cierre. |
maxWidth optional |
Tipo:
number optional Ancho máximo de la ventana de información, independientemente del ancho del contenido. Este valor solo se tiene en cuenta si se establece antes de una llamada a open() . Para cambiar el ancho máximo cuando cambias el contenido, llama a close() , setOptions() y, luego, open() . |
minWidth optional |
Tipo:
number optional Ancho mínimo de la ventana de información, independientemente del ancho del contenido. Cuando uses esta propiedad, te recomendamos que establezcas minWidth en un valor inferior al ancho del mapa (en píxeles). Este valor solo se tiene en cuenta si se establece antes de una llamada a open() . Para cambiar el ancho mínimo cuando cambias el contenido, llama a close() , setOptions() y, luego, open() . |
pixelOffset optional |
Tipo:
Size optional Es el desplazamiento, en píxeles, de la esquina de la ventana de información desde el punto del mapa en cuyas coordenadas geográficas se fija la ventana de información. Si se abre una ventana de información con un ancla, el pixelOffset se calculará a partir de la propiedad anchorPoint del ancla. |
position optional |
Tipo:
LatLng|LatLngLiteral optional Es el objeto LatLng en el que se mostrará esta ventana de información. Si la ventana de información se abre con un ancla, se usará la posición del ancla. |
zIndex optional |
Tipo:
number optional Todas las ventanas de información se muestran en el mapa en el orden de su zIndex, y los valores más altos se muestran delante de las ventanas de información con valores más bajos. De forma predeterminada, las ventanas de información se muestran según su latitud, y las ventanas de información de latitudes más bajas aparecen delante de las ventanas de información de latitudes más altas. Las ventanas de información siempre se muestran delante de los marcadores. |
Interfaz InfoWindowOpenOptions
Interfaz de google.maps.InfoWindowOpenOptions
Opciones para abrir una ventana de información
Propiedades | |
---|---|
anchor optional |
Tipo:
MVCObject|AdvancedMarkerElement optional Es la posición de anclaje en la que se ubicará esta ventana de información. Si el ancla no es nula, 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 anclaje (cuando esté disponible). |
map optional |
Tipo:
Map|StreetViewPanorama optional Es el mapa o la panorámica en la que se 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 está establecida o cuando se establece en null o undefined , se usa una heurística para decidir si se debe mover el enfoque. Se recomienda que configures esta propiedad de forma explícita para que se ajuste a tus necesidades, ya que la heurística está sujeta a cambios y es posible que no funcione bien para todos los casos de uso. |