InfoWindow.
Clase google.maps.InfoWindow
Es una superposición que parece una burbuja y, a menudo, se conecta 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 en la API de Maps JavaScript.
Constructor | |
---|---|
InfoWindow |
InfoWindow([opts]) Parámetros:
Crea una ventana de información con las opciones determinadas. Una InfoWindow se puede colocar en un mapa en una posición determinada o encima de un marcador, según lo que se especifique en las opciones. A menos que la función de desplazamiento lateral automático esté inhabilitada, una ventana de información se desplazará lateralmente para mostrar el mapa cuando se abra. Después de construir una ventana de información, debes llamar para abrirla en el mapa. El usuario puede hacer clic en el botón de cierre en la ventana de información para quitarla del mapa, o bien el desarrollador puede llamar a Close() para obtener el mismo efecto. |
Métodos | |
---|---|
close |
close() Parámetros: Ninguno
Valor que se muestra: Ninguno
Para cerrar esta ventana de información, quítala de la estructura del DOM. |
focus |
focus() Parámetros: Ninguno
Valor que se muestra: Ninguno
Establece el foco en este elemento InfoWindow . Te recomendamos que uses este método junto con un evento visible para asegurarte de que InfoWindow sea visible antes de enfocarse en él. No se puede enfocar un objeto 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 esta InfoWindow. |
getZIndex |
getZIndex() Parámetros: Ninguno
Return Value:
number El índice z de esta InfoWindow. |
open |
open([options, anchor]) Parámetros:
Valor que se muestra: Ninguno
Abre esta ventana de información en el mapa correspondiente. De manera opcional, se puede asociar una InfoWindow a 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 el pixelOffset (consulta InfoWindowOptions). anchorPoint es el desplazamiento de la posición del ancla a la punta de la ventana de información. Se recomienda usar la interfaz InfoWindowOpenOptions como el único argumento para este método. Para evitar que el enfoque del navegador esté abierto, establece InfoWindowOpenOptions.shouldFocus en false . |
setContent |
setContent([content]) 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
|
Heredada:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Eventos | |
---|---|
closeclick |
function() Argumentos: Ninguno
Este evento se activa cuando se hace clic en el botón para 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 <div> con el contenido de InfoWindow se adjunta al DOM. Es posible que quieras supervisar este evento si estás compilando el contenido de tu ventana de información de forma dinámica. |
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 objeto InfoWindow es 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
Objeto InfoWindowOptions que se usa para definir las propiedades que se pueden establecer en un elemento InfoWindow.
Propiedades | |
---|---|
ariaLabel optional |
Tipo:
string optional AriaLabel para asignar a la ventana de información. |
content optional |
Contenido para mostrar en la ventana de información Puede ser un elemento HTML, una string de texto sin formato o una string que contenga HTML. El tamaño de la ventana de información se ajustará según el contenido. Para configurar un tamaño explícito para el contenido, configura el contenido como un elemento HTML con ese tamaño. |
disableAutoPan optional |
Tipo:
boolean optional Configuración predeterminada:
false Inhabilita el desplazamiento lateral del mapa para que la ventana de información sea totalmente visible cuando se abre. |
maxWidth optional |
Tipo:
number optional Ancho máximo de la ventana de información, independientemente del 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, open() . |
minWidth optional |
Tipo:
number optional Ancho mínimo de la ventana de información, independientemente del ancho del contenido. Cuando se usa 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, open() . |
pixelOffset optional |
Tipo:
Size optional El desplazamiento, en píxeles, de la punta de la ventana de información desde el punto en el mapa en el que las coordenadas geográficas se fijan. Si se abre una ventana de información con un ancla, se calculará pixelOffset 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 la ventana de información se abre con un ancla, se usará la posición del ancla en su lugar. |
zIndex optional |
Tipo:
number optional Todos los InfoWindows se muestran en el mapa en orden de su zIndex, con valores más altos frente a InfoWindows con valores más bajos. De forma predeterminada, los InfoWindows se muestran según su latitud, y los de Windows son más bajos frente a los de las latitudes más altas. InfoWindows siempre se muestran 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 InfoWindow. Si el ancla no es nula, la InfoWindow se posicionará en la parte superior central. 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 renderizará esta ventana de información. |
shouldFocus optional |
Tipo:
boolean optional Define si se debe mover el foco dentro de la ventana de información cuando se abre. Cuando no se configura 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 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 en todos los casos de uso. |