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.

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

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

Metodi
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:  headerContent:  string|Element|Text optional i contenuti dell'intestazione da visualizzare in questa finestra informativa. 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 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

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

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

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