Info Window

InfoWindow class

google.maps.InfoWindow corso

Un overlay che ha la forma di una bolla ed è 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 specificate. Un riquadro informativo può essere posizionato su una mappa in una posizione specifica o sopra un indicatore, a seconda di quanto specificato nelle opzioni. A meno che la panoramica automatica non sia disattivata, un riquadro informativo eseguirà la panoramica della mappa per rendersi visibile quando viene aperto. Dopo aver creato un InfoWindow, devi chiamare open per visualizzarlo sulla mappa. L'utente può fare clic sul pulsante di chiusura nella finestra informativa per rimuoverla dalla mappa oppure lo sviluppatore può chiamare close() per ottenere lo stesso effetto.

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 il relativo 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. Lo stesso impostato in precedenza come contenuto.
getHeaderContent	getHeaderContent() Parametri: nessuno Valore restituito:string|Element|Text|null|undefined i contenuti dell'intestazione di questa finestra informativa. Consulta InfoWindowOptions.headerContent.
getHeaderDisabled	getHeaderDisabled() Parametri: nessuno Valore restituito:  boolean|undefined indica se l'intera riga di intestazione è disattivata o meno. Consulta 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 l'indice z 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 a cui verrà posizionata questa finestra informativa. Se l'ancora non è null, la finestra informativa verrà posizionata in alto al centro dell'ancora. La finestra informativa verrà visualizzata sulla stessa mappa o nello stesso panorama dell'ancora (se disponibile). Valore restituito:nessuno Apre questa finestra informativa sulla mappa specificata. Facoltativamente, una finestra informativa può essere associata a un'ancora. Nell'API di base, l'unico ancoraggio è la classe Marker. Tuttavia, un'ancora può essere qualsiasi MVCObject che esponga una proprietà LatLng position e, facoltativamente, una proprietà Point anchorPoint per il calcolo del 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 la modifica dell'attenzione 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. Consulta InfoWindowOptions.headerContent. Valore restituito:nessuno
setHeaderDisabled	setHeaderDisabled([headerDisabled]) Parametri:  headerDisabled:  boolean optional specifica se disattivare l'intera riga di intestazione. Consulta 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 per questa finestra informativa. Una finestra informativa con un indice z maggiore viene 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, può essere causato dall'utilizzo del metodo InfoWindow.close, dalla pressione del tasto Esc per chiudere la finestra informativa, dal clic sul pulsante di chiusura o dal trasferimento della finestra informativa a 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à dei contenuti cambia.
domready	function() Argomenti: nessuno Questo evento viene attivato quando l'elemento <div> contenente i contenuti di InfoWindow viene collegato al DOM. Ti consigliamo di monitorare questo evento se stai creando i contenuti della finestra informativa in modo dinamico.
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 allontanato e poi riportato sullo schermo.
zindex_changed	function() Argomenti: nessuno Questo evento viene attivato quando l'indice z di InfoWindow cambia.

Interfaccia InfoWindowOptions

google.maps.InfoWindowOptions interfaccia

Oggetto InfoWindowOptions utilizzato per definire le proprietà che possono essere impostate su una finestra informativa.

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. Le dimensioni della finestra informativa verranno adattate ai contenuti. Per impostare una dimensione esplicita per i contenuti, imposta i contenuti come elemento HTML con quella dimensione.
disableAutoPan optional	Tipo:  boolean optional Valore predefinito: false Disattiva la panoramica 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 dell'intestazione della finestra informativa. Può essere un elemento HTML o una stringa di testo normale. Le dimensioni della finestra informativa verranno adattate ai contenuti. Per impostare una dimensione esplicita per i contenuti dell'intestazione, imposta headerContent come elemento HTML con quella dimensione.
headerDisabled optional	Tipo:  boolean optional Disattiva l'intera riga di intestazione nella finestra informativa. Se impostato su true, l'intestazione verrà 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 modifichi i contenuti, chiama close(), setOptions() e poi 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 modifichi i 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'ancora, pixelOffset verrà calcolato dalla proprietà anchorPoint dell'ancora.
position optional	Tipo:  LatLng|LatLngLiteral optional La latitudine e la longitudine a cui visualizzare questa finestra informativa. Se la finestra informativa viene aperta con un'ancora, verrà utilizzata la posizione dell'ancora.
zIndex optional	Tipo:  number optional Tutti gli infowindow vengono visualizzati sulla mappa in ordine di zIndex, con i valori più alti visualizzati davanti agli infowindow con valori più bassi. Per impostazione predefinita, le finestre informazioni vengono visualizzate in base alla latitudine, con le finestre informazioni di latitudini più basse che appaiono davanti a quelle di latitudini più elevate. Le finestre di informazioni vengono sempre visualizzate davanti agli indicatori.

Interfaccia InfoWindowOpenOptions

google.maps.InfoWindowOpenOptions interfaccia

Opzioni per l'apertura di una finestra informativa

Proprietà
anchor optional	Tipo:  MVCObject|AdvancedMarkerElement optional L'ancora a cui verrà posizionata questa finestra informativa. Se l'ancora non è null, la finestra informativa verrà posizionata in alto al centro dell'ancora. La finestra informativa verrà visualizzata sulla stessa mappa o nello stesso 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. Quando 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.