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.

Costruttore

InfoWindow

InfoWindow([opts]) Parametri:  opts:  InfoWindowOptions optional 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.

Proprietà
isOpen	Tipo:  boolean Controlla se la finestra Info è aperta.

Metodi
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:  headerContent:  string|Element|Text optional i contenuti dell'intestazione che devono essere visualizzati da questa InfoWindow. Vedi InfoWindowOptions.headerContent. Valore restituito: nessuno
setHeaderDisabled	setHeaderDisabled([headerDisabled]) Parametri:  headerDisabled:  boolean optional specifica se disattivare l'intera riga di intestazione. Vedi InfoWindowOptions.headerDisabled. 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 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

Eventi
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.

Proprietà
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

Proprietà
anchor optional	Tipo:  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).
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.