Clase InfoWindow
Clase google.maps.InfoWindow
Es una 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 Bibliotecas de 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 ventana de información en un mapa en una posición particular o sobre un marcador, según lo que se especifique en las opciones. A menos que se inhabilite el desplazamiento automático, una ventana de información desplazará el mapa para que se vea cuando se abra. Después de construir un 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 lograr el mismo efecto. |
Propiedades | |
---|---|
isOpen |
Tipo:
boolean Verifica si el InfoWindow está abierto. |
Métodos | |
---|---|
close |
close() Parámetros: Ninguno
Valor que se muestra: Ninguno
Cierra este InfoWindow quitándolo de la estructura del DOM. |
focus |
focus() Parámetros: Ninguno
Valor que se muestra: Ninguno
Enfoque en este InfoWindow . Te recomendamos que uses 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 InfoWindow que no es 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 InfoWindow. Consulta InfoWindowOptions.headerContent . |
getHeaderDisabled |
getHeaderDisabled() Parámetros: Ninguno
Valor que se muestra:
boolean|undefined Indica si toda la fila del encabezado está inhabilitada o no. Consulta InfoWindowOptions.headerDisabled . |
getPosition |
getPosition() Parámetros: Ninguno
Valor que se muestra:
LatLng|null|undefined La posición LatLng de este InfoWindow. |
getZIndex |
getZIndex() Parámetros: Ninguno
Valor que se muestra:
number El z-index de este InfoWindow. |
open |
open([options, anchor]) Parámetros:
Valor que se muestra: Ninguno
Abre este InfoWindow en el mapa determinado. De manera opcional, se puede asociar una ventana de información 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 LatLng position y, de manera opcional, una propiedad Point anchorPoint para calcular el 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 el único argumento de este método. Para evitar que se cambie el enfoque del navegador cuando se abre, 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
|
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 puede deberse a que se llamó al método InfoWindow.close , se presionó la tecla Escape para cerrar la ventana de información, se hizo clic en el botón de cierre o se movió 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 de contenido. |
domready |
function() Argumentos: Ninguno
Este evento se activa cuando el <div> que contiene el contenido de InfoWindow se adjunta al DOM. Te recomendamos que supervises este evento si compilas 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 de posición. |
visible |
function() Argumentos: Ninguno
Este evento se activa cuando el InfoWindow está completamente visible. Este evento no se activa cuando se desplaza InfoWindow y luego se vuelve a mostrar en la pantalla. |
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 InfoWindow.
Propiedades | |
---|---|
ariaLabel optional |
Tipo:
string optional Es la etiqueta Aria 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 contiene HTML. El tamaño de InfoWindow se ajustará según el contenido. Para establecer un tamaño explícito para el contenido, configura el contenido como un elemento HTML con ese tamaño. |
disableAutoPan optional |
Tipo:
boolean optional Predeterminado:
false Inhabilita el desplazamiento del mapa para que el InfoWindow sea completamente visible cuando se abra. |
headerContent optional |
Es 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 InfoWindow se ajustará según el contenido. Para establecer un tamaño explícito para el contenido del encabezado, establece headerContent como un elemento HTML con ese tamaño. |
headerDisabled optional |
Tipo:
boolean optional Inhabilita toda la fila del encabezado en el InfoWindow. Cuando se establece como verdadero, se quita el encabezado para que se oculten el contenido del encabezado 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. Este valor solo se considera 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, a open() . |
minWidth optional |
Tipo:
number optional Es el ancho mínimo de la ventana de información, independientemente del ancho del contenido. Cuando uses esta propiedad, te recomendamos que configures minWidth en un valor inferior al ancho del mapa (en píxeles). Este valor solo se considera 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, a open() . |
pixelOffset optional |
Tipo:
Size optional Es el desplazamiento, en píxeles, de la punta 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 un InfoWindow con un ancla, el pixelOffset se calculará a partir de la propiedad anchorPoint del ancla. |
position optional |
Tipo:
LatLng|LatLngLiteral optional Es la LatLng en la que se mostrará esta ventana de información. Si se abre la ventana de información con un ancla, se usará la posición de la ancla. |
zIndex optional |
Tipo:
number optional Todas las ventanas de información se muestran en el mapa en 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 de latitudes más bajas aparecen delante de las de latitudes más altas. Las ventanas de información siempre se muestran frente a los marcadores. |
Interfaz InfoWindowOpenOptions
Interfaz de google.maps.InfoWindowOpenOptions
Opciones para abrir un InfoWindow
Propiedades | |
---|---|
anchor optional |
Tipo:
MVCObject|AdvancedMarkerElement optional Es el ancla a la 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 de la ancla. La ventana de información se renderizará en el mismo mapa o panorama que la 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 esta propiedad no se establece o se establece en null o undefined , se usa una heurística para decidir si se debe mover el enfoque 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 puede no funcionar bien para todos los casos de uso. |