Info Window

Classe InfoWindow

google.maps.InfoWindow corso

Un overlay a forma di bolla spesso collegato a un indicatore.

Questo corso è valido per MVCObject.

Accedi chiamando il 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 particolare o sopra un indicatore, a seconda di ciò che è specificato nelle opzioni. A meno che la panoramica automatica non sia disattivata, una InfoWindow esegue la panoramica della mappa per rendersi visibile all'apertura. Dopo aver creato una InfoWindow, devi richiamare open per visualizzarla sulla mappa. L'utente può fare clic sul pulsante di chiusura nella finestra InfoWindow per rimuoverla dalla mappa, oppure lo sviluppatore può richiamare la funzione di chiusura() per ottenere lo stesso effetto.
isOpen
Tipo:  boolean
Controlla se la finestra Info è aperta.
close
close()
Parametri: nessuno
Valore restituito: nessuno
Chiude questa InfoWindow 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 su di esso. Impossibile impostare lo stato attivo su InfoWindow non visibile.
getContent
getContent()
Parametri: nessuno
Valore restituito:  string|Element|Text|null|undefined il contenuto di questa InfoWindow. Uguale ai valori impostati in precedenza per i contenuti.
getHeaderContent
getHeaderContent()
Parametri: nessuno
Valore restituito:  string|Element|Text|null|undefined i contenuti dell'intestazione di questa InfoWindow. 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 InfoWindow.
getZIndex
getZIndex()
Parametri: nessuno
Valore restituito:  number zIndex di questa InfoWindow.
open
open([options, anchor])
Parametri: 
  • options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional Un oggetto InfoWindowOpenOptions (consigliato) o la mappa|panorama su cui eseguire il rendering di questa InfoWindow.
  • anchor:  MVCObject|AdvancedMarkerElement optional l'ancoraggio su cui verrà posizionata questa InfoWindow. Se l'ancoraggio non è null, la InfoWindow verrà posizionata in alto al centro dell'ancoraggio. La finestra InfoWindow verrà visualizzata sulla stessa mappa o panoramica dell'ancoraggio (se disponibile).
Valore restituito: nessuno
Apre questa InfoWindow sulla mappa data. Facoltativamente, una InfoWindow può essere associata a un ancoraggio. Nell'API principale, l'unico ancoraggio è la classe Marker. Tuttavia, un ancoraggio può essere qualsiasi oggetto MVCObject che espone una proprietà LatLng position e, facoltativamente, una proprietà Punto anchorPoint per calcolare pixelOffset (vedi InfoWindowOptions). anchorPoint è l'offset dalla posizione dell'ancoraggio alla punta della finestra informativa. Ti consigliamo di utilizzare l'interfaccia InfoWindowOpenOptions come singolo argomento per questo metodo. Per evitare di modificare lo stato attivo del browser all'apertura, imposta InfoWindowOpenOptions.shouldFocus su false.
setContent
setContent([content])
Parametri: 
  • content:  string|Element|Text optional I contenuti che verranno visualizzati da questa InfoWindow.
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 la finestra informativa.
Valore restituito: nessuno
setZIndex
setZIndex(zIndex)
Parametri: 
  • zIndex:  number z-index per questa InfoWindow. Un'InfoWindow con uno z-index maggiore verrà visualizzata davanti a tutte le altre InfoWindows con uno z-index più basso.
Valore restituito: nessuno
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
Argomenti:nessuno.
Questo evento viene attivato ogni volta che InfoWindow viene chiuso. Ad esempio, potresti chiamare il metodo InfoWindow.close, premere il tasto Esc per chiudere l'InfoWindow, fare clic sul pulsante di chiusura o spostare la InfoWindow su un'altra mappa.
closeclick
function()
Argomenti:nessuno.
Questo evento viene attivato quando è stato fatto clic sul pulsante di chiusura.
content_changed
function()
Argomenti:nessuno.
Questo evento viene attivato quando la proprietà dei contenuti viene modificata.
domready
function()
Argomenti:nessuno.
Questo evento viene attivato quando l'elemento <div> con i contenuti di InfoWindow viene collegato al DOM. Ti consigliamo di monitorare questo evento se crei dinamicamente i contenuti della finestra informativa.
headercontent_changed
function()
Argomenti:nessuno.
Questo evento viene attivato quando la proprietà headerContent viene modificata.
headerdisabled_changed
function()
Argomenti:nessuno.
Questo evento viene attivato quando la proprietà headerDisabled viene modificata.
position_changed
function()
Argomenti:nessuno.
Questo evento viene attivato quando la proprietà di posizione cambia.
visible
function()
Argomenti:nessuno.
Questo evento viene attivato quando InfoWindow è completamente visibile. Questo evento non viene attivato quando InfoWindow viene disattivato e poi di nuovo sullo schermo.
zindex_changed
function()
Argomenti:nessuno.
Questo evento viene attivato quando lo zIndex di InfoWindow cambia.

Interfaccia InfoWindowOptions

Interfaccia google.maps.InfoWindowOptions

Oggetto InfoWindowOptions utilizzato per definire le proprietà che è possibile impostare su una InfoWindow.
ariaLabel optional
Tipo:  string optional
AriaLabel da assegnare alla InfoWindow.
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. La finestra InfoWindow verrà ridimensionata in base ai contenuti. Per impostare una dimensione esplicita per i contenuti, imposta i contenuti come elemento HTML con quelle dimensioni.
disableAutoPan optional
Tipo:  boolean optional
Predefinita: false
Disattiva la panoramica della mappa per rendere la finestra InfoWindow completamente visibile all'apertura.
headerContent optional
Tipo:  string|Element|Text optional
I contenuti da visualizzare nella riga di intestazione InfoWindow. Può essere un elemento HTML o una stringa di testo normale. La finestra InfoWindow verrà ridimensionata in base ai contenuti. Per impostare una dimensione esplicita per i contenuti dell'intestazione, imposta headerContent come elemento HTML con quelle dimensioni.
headerDisabled optional
Tipo:  boolean optional
Disattiva l'intera riga di intestazione nella finestra InfoWindow. Se il criterio è impostato su true, l'intestazione viene 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 cambi contenuti, chiama close(), setOptions(), quindi 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 cambi contenuti, chiama close(), setOptions(), quindi open().
pixelOffset optional
Tipo:  Size optional
L'offset, in pixel, della punta della finestra informativa dal punto della mappa in corrispondenza delle cui coordinate geografiche è ancorata la finestra informativa. Se una InfoWindow viene aperta con un ancoraggio, il valore pixelOffset verrà calcolato dalla proprietà anchorPoint dell'ancoraggio.
position optional
Tipo:  LatLng|LatLngLiteral optional
Il valore LatLng in cui visualizzare la InfoWindow. Se la finestra informativa è aperta con un ancoraggio, al suo posto verrà utilizzata la posizione dell'ancoraggio.
zIndex optional
Tipo:  number optional
Tutte le InfoWindows vengono visualizzate sulla mappa in base al relativo zIndex, con i valori più alti visualizzati davanti a InfoWindows con valori più bassi. Per impostazione predefinita, InfoWindows viene visualizzato in base alla loro latitudine, mentre InfoWindows di latitudini inferiori viene visualizzato davanti a InfoWindows a latitudini superiori. Le finestre informative sono sempre visualizzate davanti agli indicatori.

Interfaccia InfoWindowOpenOptions

Interfaccia google.maps.InfoWindowOpenOptions

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