Clase InfoWindow
google.maps.InfoWindow
class
extends MVCObject
library "maps", "streetView"
Es una superposición que parece un cuadro de diálogo y suele estar conectada a un marcador.
const {InfoWindow} = await google.maps.importLibrary("maps");
const {InfoWindow} = await google.maps.importLibrary("streetView");
Constructor | |
|---|---|
InfoWindow |
InfoWindow([opts])Parámetros:
Crea una ventana de información con las opciones dadas. Un objeto InfoWindow se puede colocar en un mapa en una posición específica o sobre un marcador, según lo que se especifique en las opciones. A menos que se inhabilite el desplazamiento lateral automático, un objeto InfoWindow desplazará lateralmente el mapa para hacerse visible 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 InfoWindow para quitarla del mapa, o bien el desarrollador puede llamar a close() para lograr el mismo efecto. |
Propiedades | |
|---|---|
isOpen
readonly |
Tipo:
booleanVerifica si la ventana de información está abierta. |
Métodos | |
|---|---|
close |
close()Parámetros: Ninguno
Valor de retorno: Ninguno
Cierra esta InfoWindow 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 consideres usar este método junto con un evento visible para asegurarte de que InfoWindow sea visible antes de establecer el foco 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 devuelve:
string|Element|Text|null|undefined El contenido del encabezado de este InfoWindow. Consulta InfoWindowOptions.headerContent. |
getHeaderDisabled |
getHeaderDisabled()Parámetros: Ninguno
Valor de retorno:
boolean|undefined Indica si toda la fila del encabezado está inhabilitada o no. Consulta InfoWindowOptions.headerDisabled. |
getPosition |
getPosition()Parámetros: Ninguno
Valor de retorno:
LatLng|null|undefined La posición LatLng de este InfoWindow. |
getZIndex |
getZIndex()Parámetros: Ninguno
Valor de retorno:
number El zIndex de este InfoWindow. |
open |
open([options, anchor])Parámetros:
Valor de retorno: Ninguno
Abre este InfoWindow en el mapa determinado. De manera opcional, se puede asociar un objeto InfoWindow con un ancla. En la API principal, el único punto 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 punta de la InfoWindow. Se recomienda usar la interfaz InfoWindowOpenOptions como el único argumento para este método. Para evitar que cambie el enfoque del navegador cuando se abre, establece InfoWindowOpenOptions.shouldFocus en false. |
setContent |
setContent([content])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
|
Heredados:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
Eventos | |
|---|---|
close |
function()Argumentos: Ninguno
Este evento se activa cada vez que se cierra el InfoWindow. Por ejemplo, esto podría deberse a que se llamó al método InfoWindow.close, se presionó la tecla Escape para cerrar la InfoWindow, se hizo clic en el botón de cierre o se movió la InfoWindow 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 del InfoWindow se adjunta al DOM. Te recomendamos supervisar este evento si estás creando el contenido de tu 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 es completamente visible. Este evento no se activa cuando se desplaza InfoWindow 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
google.maps.InfoWindowOptions
Es el objeto InfoWindowOptions que se usa para definir las propiedades que se pueden establecer en un InfoWindow.
Propiedades | |
|---|---|
ariaLabel
opcional |
Tipo:
string optionalEs la AriaLabel que se asignará a la InfoWindow. |
content
opcional |
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
opcional |
Tipo:
boolean optionalLa configuración predeterminada es
false.Inhabilita el desplazamiento del mapa para que la ventana de información sea completamente visible cuando se abra. |
headerContent
opcional |
Es el contenido que se mostrará en la fila del encabezado de la InfoWindow. 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
opcional |
Tipo:
boolean optionalInhabilita toda la fila del encabezado en la ventana de información. Cuando se establece como verdadero, se quita el encabezado para que se oculten el contenido del encabezado y el botón de cierre. |
maxWidth
opcional |
Tipo:
number optionalEs el 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 se modifica el contenido, llama a close(), setOptions() y, luego, a open(). |
minWidth
opcional |
Tipo:
number optionalEs el ancho mínimo de la ventana de información, independientemente del ancho del contenido. Cuando uses esta propiedad, te recomendamos que establezcas el valor de 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 se cambia el contenido, llama a close(), setOptions() y, luego, a open(). |
pixelOffset
opcional |
Tipo:
Size optionalEs 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 objeto InfoWindow con un punto de anclaje, el valor de pixelOffset se calculará a partir de la propiedad anchorPoint del punto de anclaje. |
position
opcional |
Tipo:
LatLng|LatLngLiteral optionalEs el LatLng en el que se mostrará esta InfoWindow. Si se abre con un ancla, se usará la posición de esta última. |
zIndex
opcional |
Tipo:
number optionalTodas 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 InfoWindows se muestran según su latitud, y las que tienen latitudes más bajas aparecen delante de las que tienen latitudes más altas. Las ventanas de información siempre se muestran delante de los marcadores. |
Interfaz InfoWindowOpenOptions
Interfaz
google.maps.InfoWindowOpenOptions
Opciones para abrir una InfoWindow
Propiedades | |
|---|---|
anchor
opcional |
Tipo:
MVCObject|AdvancedMarkerElement optionalEs el punto de fijación en el que se posicionará esta ventana de información. Si el punto de anclaje no es nulo, la InfoWindow se posicionará en la parte superior central del punto de anclaje. La InfoWindow se renderizará en el mismo mapa o panorama que el ancla (cuando esté disponible). |
map
opcional |
Tipo:
Map|StreetViewPanorama optionalEs el mapa o la panorámica en la que se renderizará este InfoWindow. |
shouldFocus
opcional |
Tipo:
boolean optionalIndica si el foco debe moverse o no dentro de InfoWindow 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 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. |