Info Window

Classe InfoWindow

google.maps.InfoWindow classe

Un overlay dall'aspetto di una bolla 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.

Costruttore

InfoWindow

InfoWindow([opts]) Parametri:  opts:  InfoWindowOptions optional Crea una finestra informativa con le opzioni fornite. Una finestra informativa può essere posizionata su una mappa in una determinata posizione o sopra un indicatore, a seconda di ciò che è specificato nelle opzioni. A meno che la panoramica automatica non sia disabilitata, una InfoWindow esegue la panoramica della mappa per rendersi visibile all'apertura. Dopo aver creato una InfoWindow, devi richiamare open per poterla visualizzare sulla mappa. L'utente può fare clic sul pulsante di chiusura in InfoWindow per rimuoverlo dalla mappa oppure lo sviluppatore può richiamare la funzione Close() per ottenere lo stesso effetto.

Metodi
close	close() Parametri: nessuno Valore restituito: nessuno Chiude la 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 questo metodo. Impossibile mettere a fuoco un elemento InfoWindow non visibile.
getContent	getContent() Parametri: nessuno Valore restituito:  string|Element|Text|null|undefined i contenuti di questa InfoWindow. Uguale a quanto impostato in precedenza per i contenuti.
getPosition	getPosition() Parametri: nessuno Valore restituito:  LatLng|null|undefined la posizione LatLng di questa InfoWindow.
getZIndex	getZIndex() Parametri: nessuno Valore restituito:  number il valore 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 InfoWindow. anchor:  MVCObject|AdvancedMarkerElement optional l'ancoraggio a cui verrà posizionata questa InfoWindow. Se l'ancoraggio è diverso da null, la finestra InfoWindow verrà posizionata nella parte superiore centrale dell'ancoraggio. La finestra InfoWindow verrà visualizzata sulla stessa mappa o panoramica dell'ancoraggio (se disponibile). Valore restituito: nessuno Apre questa InfoWindow sulla mappa specificata. Facoltativamente, una InfoWindow 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à position LatLng e, facoltativamente, una proprietà Punto anchorPoint per calcolare pixelOffset (vedi InfoWindowOptions). anchorPoint è l'offset dalla posizione dell'ancoraggio alla punta della InfoWindow. Ti consigliamo di utilizzare l'interfaccia InfoWindowOpenOptions come argomento singolo per questo metodo. Per impedire la modifica dello stato attivo del browser per l'apertura, imposta InfoWindowOpenOptions.shouldFocus su false.
setContent	setContent([content]) Parametri:  content:  string|Element|Text optional i contenuti da visualizzare in questa InfoWindow. Valore restituito: nessuno
setOptions	setOptions([options]) Parametri:  options:  InfoWindowOptions optional 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 lo z-index per questa InfoWindow. Una InfoWindow con uno z-index maggiore viene visualizzata davanti a tutte le altre InfoWindows con uno z-index più basso. Valore restituito: nessuno
Ereditate: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Eventi
close	function() Argomenti: nessuno Questo evento viene attivato alla chiusura di InfoWindow. Ad esempio, potresti richiamare il metodo InfoWindow.close, premere il tasto Esc per chiudere la InfoWindow, fare clic sul pulsante di chiusura o spostare quest'ultima in un'altra mappa.
closeclick	function() Argomenti: nessuno Questo evento viene attivato quando l'utente ha 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> con i contenuti di InfoWindow è collegato al DOM. Ti consigliamo di monitorare questo evento se stai creando in modo dinamico i contenuti della finestra informativa.
headercontent_changed	Avviso: disponibile soltanto nel canale v=beta. function() Argomenti: nessuno Questo evento viene attivato quando la proprietà headerContent cambia.
headerdisabled_changed	Avviso: disponibile soltanto nel canale v=beta. function() Argomenti: nessuno Questo evento viene attivato quando la proprietà headerDisabled cambia.
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 spostato fuori dalla panoramica e poi di nuovo sullo schermo.
zindex_changed	function() Argomenti: nessuno Questo evento viene attivato quando lo zIndex di InfoWindow viene modificato.

Interfaccia InfoWindowOptions

Interfaccia google.maps.InfoWindowOptions

Oggetto InfoWindowOptions utilizzato per definire le proprietà che possono essere impostate in una InfoWindow.

Proprietà
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. La finestra InfoWindow verrà dimensionata 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 Predefinita: false Disattiva la panoramica della mappa per rendere la InfoWindow completamente visibile all'apertura.
headerContent optional	Avviso: disponibile soltanto nel canale v=beta. Tipo:  string|Element|Text optional I contenuti da visualizzare nella riga di intestazione InfoWindow. Può essere un elemento HTML o una stringa contenente HTML. La finestra InfoWindow verrà dimensionata in base ai contenuti. Per impostare una dimensione esplicita per i contenuti dell'intestazione, imposta headerContent in modo che sia un elemento HTML con quelle dimensioni.
headerDisabled optional	Avviso: disponibile soltanto nel canale v=beta. Tipo:  boolean optional Disattiva l'intera riga di intestazione nella InfoWindow. Se impostato su true, l'intestazione viene rimossa in modo che i contenuti dell'intestazione e il pulsante di chiusura siano nascosti.
maxWidth optional	Tipo:  number optional Larghezza massima della InfoWindow, indipendentemente dalla larghezza dei contenuti. Questo valore viene preso in considerazione solo se viene impostato prima di una chiamata a open(). Per cambiare la larghezza massima quando modifichi i contenuti, chiama close(), setOptions() e poi open().
minWidth optional	Tipo:  number optional Larghezza minima della InfoWindow, 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 rispetto al punto sulla mappa alle cui coordinate geografiche è ancorata la finestra informativa. Se una InfoWindow viene aperta con un ancoraggio, pixelOffset verrà calcolato dalla proprietà anchorPoint dell'ancoraggio.
position optional	Tipo:  LatLng|LatLngLiteral optional Il LatLng in cui visualizzare la InfoWindow. Se la InfoWindow viene 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 ordine zIndex, con i valori più alti visualizzati davanti a InfoWindows con valori più bassi. Per impostazione predefinita, le finestre informative vengono visualizzate in base alla latitudine, mentre le finestre InfoWindows delle latitudini inferiori vengono visualizzate davanti a Windows Info a latitudine più elevate. Le finestre informative vengono sempre visualizzate davanti agli indicatori.

Interfaccia InfoWindowOpenOptions

Interfaccia google.maps.InfoWindowOpenOptions

Opzioni per l'apertura di una finestra informativa

Proprietà
anchor optional	Tipo:  MVCObject|AdvancedMarkerElement optional L'ancoraggio a cui verrà posizionata questa InfoWindow. Se l'ancoraggio è diverso da null, la finestra InfoWindow verrà posizionata nella parte superiore centrale 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 su cui eseguire il rendering di questa InfoWindow.
shouldFocus optional	Tipo:  boolean optional Indica se lo stato attivo deve essere spostato o meno all'interno della InfoWindow 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 perché l'euristica è soggetta a modifiche e potrebbe non funzionare bene per tutti i casi d'uso.