Info Window

InfoWindow class

google.maps.InfoWindow corso

Un overlay che ha la forma di una bolla ed è spesso collegato a un indicatore.

Questa classe estende MVCObject.

Accedi chiamando const {InfoWindow} = await google.maps.importLibrary("maps") o const {InfoWindow} = await google.maps.importLibrary("streetView"). Consulta la sezione Librerie nell'API Maps JavaScript.
InfoWindow
InfoWindow([opts])
Parametri: 
Crea una finestra informativa con le opzioni specificate. Un riquadro informativo può essere posizionato su una mappa in una posizione specifica o sopra un indicatore, a seconda di quanto specificato nelle opzioni. A meno che la panoramica automatica non sia disattivata, un riquadro informativo eseguirà la panoramica della mappa per rendersi visibile quando viene aperto. Dopo aver creato un InfoWindow, devi chiamare open per visualizzarlo sulla mappa. L'utente può fare clic sul pulsante di chiusura nella finestra informativa per rimuoverla dalla mappa oppure lo sviluppatore può chiamare close() per ottenere lo stesso effetto.
isOpen
Tipo:  boolean
Controlla se la finestra informativa è aperta.
close
close()
Parametri: nessuno
Valore restituito:nessuno
Chiude questa finestra informativa rimuovendola dalla struttura DOM.
focus
focus()
Parametri: nessuno
Valore restituito:nessuno
Imposta lo stato attivo su questo InfoWindow. Ti consigliamo di utilizzare questo metodo insieme a un evento visible per assicurarti che InfoWindow sia visibile prima di impostare il relativo stato attivo. Un InfoWindow non visibile non può essere messo a fuoco.
getContent
getContent()
Parametri: nessuno
Valore restituito:  string|Element|Text|null|undefined i contenuti di questa finestra informativa. Lo stesso impostato in precedenza come contenuto.
getHeaderContent
getHeaderContent()
Parametri: nessuno
Valore restituito:string|Element|Text|null|undefined i contenuti dell'intestazione di questa finestra informativa. Consulta InfoWindowOptions.headerContent.
getHeaderDisabled
getHeaderDisabled()
Parametri: nessuno
Valore restituito:  boolean|undefined indica se l'intera riga di intestazione è disattivata o meno. Consulta InfoWindowOptions.headerDisabled.
getPosition
getPosition()
Parametri: nessuno
Valore restituito:  LatLng|null|undefined la posizione LatLng di questa finestra informativa.
getZIndex
getZIndex()
Parametri: nessuno
Valore restituito:  number l'indice z di questa finestra informativa.
open
open([options, anchor])
Parametri: 
  • options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional un oggetto InfoWindowOpenOptions (consigliato) o la mappa/il panorama su cui eseguire il rendering di questa finestra informativa.
  • anchor:  MVCObject|AdvancedMarkerElement optional l'ancora a cui verrà posizionata questa finestra informativa. Se l'ancora non è null, la finestra informativa verrà posizionata in alto al centro dell'ancora. La finestra informativa verrà visualizzata sulla stessa mappa o nello stesso panorama dell'ancora (se disponibile).
Valore restituito:nessuno
Apre questa finestra informativa sulla mappa specificata. Facoltativamente, una finestra informativa può essere associata a un'ancora. Nell'API di base, l'unico ancoraggio è la classe Marker. Tuttavia, un'ancora può essere qualsiasi MVCObject che esponga una proprietà LatLng position e, facoltativamente, una proprietà Point anchorPoint per il calcolo del pixelOffset (vedi InfoWindowOptions). anchorPoint è l'offset dalla posizione dell'ancora alla punta della finestra informativa. Ti consigliamo di utilizzare l'interfaccia InfoWindowOpenOptions come unico argomento per questo metodo. Per impedire la modifica dell'attenzione del browser all'apertura, imposta InfoWindowOpenOptions.shouldFocus su false.
setContent
setContent([content])
Parametri: 
  • content:  string|Element|Text optional i contenuti da visualizzare in questa finestra informativa.
Valore restituito:nessuno
setHeaderContent
setHeaderContent([headerContent])
Parametri: 
Valore restituito:nessuno
setHeaderDisabled
setHeaderDisabled([headerDisabled])
Parametri: 
Valore restituito:nessuno
setOptions
setOptions([options])
Parametri: 
Valore restituito:nessuno
setPosition
setPosition([position])
Parametri: 
  • position:  LatLng|LatLngLiteral optional la posizione LatLng in cui visualizzare questa finestra informativa.
Valore restituito:nessuno
setZIndex
setZIndex(zIndex)
Parametri: 
  • zIndex:  number l'indice z per questa finestra informativa. Una finestra informativa con un indice z maggiore viene visualizzata davanti a tutte le altre finestre informative con un indice z inferiore.
Valore restituito:nessuno
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
Argomenti: nessuno
Questo evento viene attivato ogni volta che InfoWindow si chiude. Ad esempio, può essere causato dall'utilizzo del metodo InfoWindow.close, dalla pressione del tasto Esc per chiudere la finestra informativa, dal clic sul pulsante di chiusura o dal trasferimento della finestra informativa a un'altra mappa.
closeclick
function()
Argomenti: nessuno
Questo evento viene attivato quando viene fatto clic sul pulsante di chiusura.
content_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà dei contenuti cambia.
domready
function()
Argomenti: nessuno
Questo evento viene attivato quando l'elemento <div> contenente i contenuti di InfoWindow viene collegato al DOM. Ti consigliamo di monitorare questo evento se stai creando i contenuti della finestra informativa in modo dinamico.
headercontent_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà headerContent cambia.
headerdisabled_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà headerDisabled cambia.
position_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando la proprietà position cambia.
visible
function()
Argomenti: nessuno
Questo evento viene attivato quando InfoWindow è completamente visibile. Questo evento non viene attivato quando InfoWindow viene allontanato e poi riportato sullo schermo.
zindex_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando l'indice z di InfoWindow cambia.

Interfaccia InfoWindowOptions

google.maps.InfoWindowOptions interfaccia

Oggetto InfoWindowOptions utilizzato per definire le proprietà che possono essere impostate su una finestra informativa.
ariaLabel optional
Tipo:  string optional
AriaLabel da assegnare alla finestra informativa.
content optional
Tipo:  string|Element|Text optional
Contenuti da visualizzare nella finestra informativa. Può essere un elemento HTML, una stringa di testo normale o una stringa contenente HTML. Le dimensioni della finestra informativa verranno adattate ai contenuti. Per impostare una dimensione esplicita per i contenuti, imposta i contenuti come elemento HTML con quella dimensione.
disableAutoPan optional
Tipo:  boolean optional
Valore predefinito: false
Disattiva la panoramica della mappa per rendere la finestra informativa completamente visibile quando si apre.
headerContent optional
Tipo:  string|Element|Text optional
I contenuti da visualizzare nella riga dell'intestazione della finestra informativa. Può essere un elemento HTML o una stringa di testo normale. Le dimensioni della finestra informativa verranno adattate ai contenuti. Per impostare una dimensione esplicita per i contenuti dell'intestazione, imposta headerContent come elemento HTML con quella dimensione.
headerDisabled optional
Tipo:  boolean optional
Disattiva l'intera riga di intestazione nella finestra informativa. Se impostato su true, l'intestazione verrà rimossa in modo che i contenuti dell'intestazione e il pulsante di chiusura vengano nascosti.
maxWidth optional
Tipo:  number optional
Larghezza massima della finestra informativa, indipendentemente dalla larghezza dei contenuti. Questo valore viene preso in considerazione solo se viene impostato prima di una chiamata a open(). Per modificare la larghezza massima quando modifichi i contenuti, chiama close(), setOptions() e poi open().
minWidth optional
Tipo:  number optional
Larghezza minima della finestra informativa, indipendentemente dalla larghezza dei contenuti. Quando utilizzi questa proprietà, ti consigliamo vivamente di impostare minWidth su un valore inferiore alla larghezza della mappa (in pixel). Questo valore viene preso in considerazione solo se viene impostato prima di una chiamata a open(). Per modificare la larghezza minima quando modifichi i contenuti, chiama close(), setOptions() e poi open().
pixelOffset optional
Tipo:  Size optional
L'offset, in pixel, della punta della finestra informativa dal punto sulla mappa alle cui coordinate geografiche è ancorata la finestra informativa. Se viene aperta una finestra informativa con un'ancora, pixelOffset verrà calcolato dalla proprietà anchorPoint dell'ancora.
position optional
Tipo:  LatLng|LatLngLiteral optional
La latitudine e la longitudine a cui visualizzare questa finestra informativa. Se la finestra informativa viene aperta con un'ancora, verrà utilizzata la posizione dell'ancora.
zIndex optional
Tipo:  number optional
Tutti gli infowindow vengono visualizzati sulla mappa in ordine di zIndex, con i valori più alti visualizzati davanti agli infowindow con valori più bassi. Per impostazione predefinita, le finestre informazioni vengono visualizzate in base alla latitudine, con le finestre informazioni di latitudini più basse che appaiono davanti a quelle di latitudini più elevate. Le finestre di informazioni vengono sempre visualizzate davanti agli indicatori.

Interfaccia InfoWindowOpenOptions

google.maps.InfoWindowOpenOptions interfaccia

Opzioni per l'apertura di una finestra informativa
anchor optional
L'ancora a cui verrà posizionata questa finestra informativa. Se l'ancora non è null, la finestra informativa verrà posizionata in alto al centro dell'ancora. La finestra informativa verrà visualizzata sulla stessa mappa o nello stesso panorama dell'ancora (se disponibile).
map optional
Tipo:  Map|StreetViewPanorama optional
La mappa o il panorama su cui eseguire il rendering di questa finestra informativa.
shouldFocus optional
Tipo:  boolean optional
Indica se lo stato attivo deve essere spostato all'interno della finestra informativa quando viene aperta. Quando questa proprietà non è impostata o è impostata su null o undefined, viene utilizzata un'euristica per decidere se spostare o meno lo stato attivo. Ti consigliamo di impostare esplicitamente questa proprietà in base alle tue esigenze, in quanto l'euristica è soggetta a modifiche e potrebbe non funzionare bene per tutti i casi d'uso.