Info Window

InfoWindow class

google.maps.InfoWindow classe

Un overlay che sembra una bolla e spesso è collegato a un indicatore.

Questo corso si estende MVCObject.

Accesso tramite chiamata al numero const {InfoWindow} = await google.maps.importLibrary("maps") o const {InfoWindow} = await google.maps.importLibrary("streetView").
Consulta Librerie nell'API Maps JavaScript.
InfoWindow
InfoWindow([opts])
Parametri: 
Crea una finestra informativa con le opzioni specificate. Una finestra informativa può essere posizionata su una mappa in una posizione specifica o sopra un indicatore, a seconda di quanto specificato nelle opzioni. A meno che lo spostamento automatico non sia disattivato, una finestra informativa sposta la mappa per rendersi visibile quando viene aperta. Dopo aver creato una finestra informativa, devi chiamare open per visualizzarla sulla mappa. L'utente può fare clic sul pulsante di chiusura della finestra informativa per rimuoverla dalla mappa oppure lo sviluppatore può chiamare close() per ottenere lo stesso risultato.
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 lo 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. Uguale a ciò che era stato impostato in precedenza come contenuto.
getHeaderContent
getHeaderContent()
Parametri: nessuno
Valore restituito:  string|Element|Text|null|undefined i contenuti dell'intestazione di questa finestra informativa. Vedi InfoWindowOptions.headerContent.
getHeaderDisabled
getHeaderDisabled()
Parametri: nessuno
Valore restituito:  boolean|undefined Indica se l'intera riga di intestazione è disattivata o meno. Vedi 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 zIndex 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 rispetto alla quale verrà posizionata questa finestra informativa. Se l'ancora non è nulla, la finestra informativa verrà posizionata nella parte superiore centrale dell'ancora. La finestra informativa verrà visualizzata sulla stessa mappa o panorama dell'ancora (se disponibile).
Valore restituito:nessuno
Apre questa finestra informativa sulla mappa specificata. Facoltativamente, una finestra informativa può essere associata a un ancoraggio. Nell'API principale, l'unico ancoraggio è la classe Marker. Tuttavia, un ancoraggio può essere qualsiasi MVCObject che espone una proprietà LatLng position e, facoltativamente, una proprietà Point anchorPoint per il calcolo di 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 il cambio di focus 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 di questa finestra informativa. Una finestra informativa con un indice z maggiore verrà 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, potrebbe essere dovuto alla chiamata del metodo InfoWindow.close, alla pressione del tasto Esc per chiudere la finestra informativa o al clic sul pulsante di chiusura o allo spostamento della finestra informativa in 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à content cambia.
domready
function()
Argomenti: nessuno
Questo evento viene attivato quando <div> contenente i contenuti di InfoWindow viene collegato al DOM. Ti consigliamo di monitorare questo evento se stai creando dinamicamente i contenuti della finestra informativa.
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 spostato fuori e poi di nuovo sullo schermo.
zindex_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando cambia lo zIndex di InfoWindow.

Interfaccia InfoWindowOptions

google.maps.InfoWindowOptions interfaccia

Oggetto InfoWindowOptions utilizzato per definire le proprietà che possono essere impostate in una finestra informativa.
ariaLabel optional
Tipo:  string optional
Etichetta ARIA da assegnare alla finestra informativa.
content optional
Tipo:  string|Element|Text optional
Contenuti da visualizzare nella finestra informativa. Può trattarsi di un elemento HTML, di una stringa di testo normale o di una stringa contenente HTML. Le dimensioni della finestra informativa verranno regolate in base ai contenuti. Per impostare una dimensione esplicita per i contenuti, imposta i contenuti in modo che siano un elemento HTML con quella dimensione.
disableAutoPan optional
Tipo:  boolean optional
Predefinito: false
Disattiva lo spostamento 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 di intestazione della finestra informativa. Può essere un elemento HTML o una stringa di testo normale. Le dimensioni della finestra informativa verranno regolate in base ai contenuti. Per impostare una dimensione esplicita per i contenuti dell'intestazione, imposta headerContent in modo che sia un elemento HTML con quella dimensione.
headerDisabled optional
Tipo:  boolean optional
Disattiva l'intera riga di intestazione nella finestra informativa. Se il valore è true, l'intestazione viene rimossa in modo che i contenuti dell'intestazione e il pulsante Chiudi vengano nascosti.
maxWidth optional
Tipo:  number optional
La 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 durante la modifica dei contenuti, chiama close(), setOptions() e poi open().
minWidth optional
Tipo:  number optional
La 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 durante la modifica dei 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 ancoraggio, il valore di pixelOffset verrà calcolato dalla proprietà anchorPoint dell'ancoraggio.
position optional
Tipo:  LatLng|LatLngLiteral optional
Il LatLng in cui visualizzare questa finestra informativa. Se la finestra informativa viene aperta con un ancoraggio, verrà utilizzata la posizione dell'ancoraggio.
zIndex optional
Tipo:  number optional
Tutte le finestre informative vengono visualizzate sulla mappa in base al relativo zIndex, con i valori più alti visualizzati davanti alle finestre informative con valori più bassi. Per impostazione predefinita, le finestre informative vengono visualizzate in base alla latitudine, con le finestre informative delle latitudini più basse che appaiono davanti a quelle delle latitudini più alte. Le finestre informative vengono sempre visualizzate davanti ai marcatori.

Interfaccia InfoWindowOpenOptions

google.maps.InfoWindowOpenOptions interfaccia

Opzioni per aprire una finestra informativa
anchor optional
L'ancora rispetto alla quale verrà posizionata questa finestra informativa. Se l'ancora non è nulla, la finestra informativa verrà posizionata nella parte superiore centrale dell'ancora. La finestra informativa verrà visualizzata sulla stessa mappa o 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. Se 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.