InfoWindow.
Clase google.maps.InfoWindow
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 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. 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 el desplazamiento automático esté inhabilitado, una ventana de información desplazará el mapa para que se muestre cuando se abra. Después de construir una ventana de información, debes llamar a open para que se muestre en el mapa. El usuario puede hacer clic en el botón de cerrar 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 que se muestra: Ninguno
Cierra esta ventana de información quitándola de la estructura del DOM. |
focus |
focus() Parámetros: Ninguno
Valor que se muestra: 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 configurar el enfoque en él. No se puede enfocar un InfoWindow que no sea visible. |
getContent |
getContent() Parámetros: Ninguno
|
getHeaderContent |
getHeaderContent() Parámetros: Ninguno
Valor que se muestra:
string|Element|Text|null|undefined Es el contenido del encabezado de este período de información. Consulta InfoWindowOptions.headerContent . |
getHeaderDisabled |
getHeaderDisabled() Parámetros: Ninguno
Valor que se muestra:
boolean|undefined Indica si está inhabilitada o no toda la fila del encabezado. Consulta InfoWindowOptions.headerDisabled . |
getPosition |
getPosition() Parámetros: Ninguno
Valor que se muestra:
LatLng|null|undefined Es la posición LatLng de este período de información. |
getZIndex |
getZIndex() Parámetros: Ninguno
Valor que se muestra:
number Es el zIndex de este período de información. |
open |
open([options, anchor]) Parámetros:
Valor que se muestra: 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 LatLng y, opcionalmente, una propiedad anchorPoint de punto para calcular el pixelOffset (consulta InfoWindowOptions). El elemento 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 el único argumento para este método. Para evitar cambiar el enfoque del navegador al abrir, establece InfoWindowOpenOptions.shouldFocus en false . |
setContent |
setContent([content]) Parámetros:
Valor que se muestra: Ninguno
|
setHeaderContent |
setHeaderContent([headerContent]) Parámetros:
Valor que se muestra: Ninguno
|
setHeaderDisabled |
setHeaderDisabled([headerDisabled]) Parámetros:
Valor que se muestra: Ninguno
|
setOptions |
setOptions([options]) Parámetros:
Valor que se muestra: Ninguno
|
setPosition |
setPosition([position]) Parámetros:
Valor que se muestra: Ninguno
|
setZIndex |
setZIndex(zIndex) Parámetros:
Valor que se muestra: Ninguno
|
Heredados:
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 al llamado al método InfoWindow.close , al presionar la tecla Escape para cerrar la ventana de información, al hacer clic en el botón de cerrar o al 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 cerrar. |
content_changed |
function() Argumentos: Ninguno
Este evento se activa cuando cambia la propiedad de contenido. |
domready |
function() Argumentos: Ninguno
Este evento se activa cuando el elemento <div> con el contenido de InfoWindow se adjunta al DOM. Te recomendamos que supervises este evento si estás creando el contenido de tu ventana de información de manera 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 de posición. |
visible |
function() Argumentos: Ninguno
Este evento se activa cuando InfoWindow es completamente visible. Este evento no se activa cuando InfoWindow se desplaza lateralmente y, luego, vuelve a aparecer en la pantalla. |
zindex_changed |
function() Argumentos: Ninguno
Este evento se activa cuando cambia el zIndex de InfoWindow . |
InfoWindowOptions.
Interfaz google.maps.InfoWindowOptions
Es el objeto InfoWindowOptions que se usa para definir las propiedades que se pueden configurar en un objeto InfoWindow.
Propiedades | |
---|---|
ariaLabel optional |
Tipo:
string optional AriaLabel para asignar 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. El tamaño de la ventana de información se ajustará en función del contenido. Para establecer un tamaño explícito para el contenido, configúralo para que sea un elemento HTML con ese tamaño. |
disableAutoPan optional |
Tipo:
boolean optional Valor predeterminado:
false Inhabilita el desplazamiento lateral del mapa para que la ventana de información sea totalmente visible cuando se abre. |
headerContent optional |
El contenido que se mostrará en la fila del encabezado de InfoWindow. Puede ser un elemento HTML o una cadena de texto sin formato. El tamaño de la ventana de información se ajustará en función del contenido. Si deseas establecer un tamaño explícito para el contenido del encabezado, establece headerContent para que sea 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 verdadera, se quitará el encabezado para ocultar su contenido y el botón de cierre. |
maxWidth optional |
Tipo:
number optional Es el ancho máximo de la ventana de información, independientemente del ancho del contenido. Solo se considera este valor si se establece antes de una llamada a open() . Para cambiar el ancho máximo cuando cambias de 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 establecer minWidth en un valor inferior al ancho del mapa (en píxeles). Solo se considera este valor si se establece antes de una llamada a open() . Para cambiar el ancho mínimo cuando cambias de contenido, llama a close() , setOptions() y, luego, open() . |
pixelOffset optional |
Tipo:
Size optional El desplazamiento, en píxeles, de la parte superior de la ventana de información desde el punto del mapa en cuyas coordenadas geográficas se ancla 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 El objeto LatLng en el que se debe mostrar esta ventana de información. Si se abre la ventana de información 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; los valores más altos se muestran frente a InfoWindows con valores más bajos. De manera predeterminada, se muestran InfoWindows según su latitud, y los InfoWindows de latitudes más bajos aparecen frente a InfoWindows en latitudes más altas. InfoWindows siempre se muestra delante de los marcadores. |
InfoWindowOpenOptions.
Interfaz google.maps.InfoWindowOpenOptions
Opciones para abrir una ventana de información
Propiedades | |
---|---|
anchor optional |
Tipo:
MVCObject|AdvancedMarkerElement optional Es el anclaje al que se posicionará esta ventana de información. Si el anclaje no es nulo, se posicionará la ventana de información en la parte central superior 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 Es el mapa o la panorámica en los 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 no se establece esta propiedad o cuando se establece en null o undefined , se usa una heurística para decidir si se debe mover el enfoque o no. Se recomienda configurar explícitamente esta propiedad 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. |