Info Window

InfoWindow

Classe google.maps.InfoWindow

Superposition qui ressemble à une bulle et qui est souvent reliée à un repère.

Cette classe étend MVCObject.

Accès en appelant const {InfoWindow} = await google.maps.importLibrary("maps") ou const {InfoWindow} = await google.maps.importLibrary("streetView") Consultez Bibliothèques dans l'API Maps JavaScript.

InfoWindow
InfoWindow([opts])
Paramètres:
Crée une fenêtre d'informations avec les options données. Une fenêtre d'informations peut être placée sur une carte à un emplacement spécifique ou au-dessus d'un repère, en fonction de ce qui est spécifié dans les options. À moins que la fonction de panoramique automatique ne soit désactivée, une fenêtre d'informations se déplace sur la carte pour devenir visible à l'ouverture. Après avoir construit une fenêtre d'informations, vous devez appeler open pour l'afficher sur la carte. L'utilisateur peut cliquer sur le bouton de fermeture dans la fenêtre d'informations pour la supprimer de la carte, ou le développeur peut appeler close() pour obtenir le même effet.
close
close()
Paramètres:aucun
Valeur de retour:aucune
Ferme cette fenêtre d'informations en la supprimant de la structure DOM.
focus
focus()
Paramètres:aucun
Valeur de retour:aucune
Active le InfoWindow. Nous vous conseillons d'utiliser cette méthode en même temps qu'un événement visible pour vous assurer que InfoWindow est visible avant d'activer la mise au point. Impossible de sélectionner un élément InfoWindow qui n'est pas visible.
getContent
getContent()
Paramètres:aucun
Valeur de retour : string|Element|null|Text|undefined : contenu de cette fenêtre d'informations. Identique au contenu précédemment défini comme contenu.
getPosition
getPosition()
Paramètres:aucun
Valeur de retour:  LatLng|null|undefined position LatLng de cette fenêtre d'informations.
getZIndex
getZIndex()
Paramètres:aucun
Valeur de retour:number zIndex de cette fenêtre d'informations.
open
open([options, anchor])
Paramètres:
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional. Objet InfoWindowOpenOptions (recommandé) ou plan|panorama sur lequel afficher cette fenêtre d'informations.
  • anchorMVCObject|AdvancedMarkerView optional Ancrage dans lequel la fenêtre d'informations sera placée. Si l'ancre n'est pas nulle, la fenêtre d'informations sera positionnée en haut au centre de l'ancre. La fenêtre d'informations sera affichée sur la même carte ou le même panorama que l'ancre (si disponible).
Valeur de retour:aucune
Ouvre cette fenêtre d'informations sur la carte donnée. Une fenêtre d'informations peut éventuellement être associée à une ancre. Dans l'API principale, la seule ancre est la classe Marker. Cependant, une ancre peut être n'importe quel objet MVCObject qui expose une propriété position LatLng et éventuellement une propriété Point anchorPoint pour calculer la pixelOffset (voir InfoWindowOptions). anchorPoint est le décalage entre la position de l'ancre et l'extrémité de la fenêtre d'informations. Il est recommandé d'utiliser l'interface InfoWindowOpenOptions comme argument unique pour cette méthode. Pour empêcher l'ouverture du navigateur, définissez InfoWindowOpenOptions.shouldFocus sur false.
setContent
setContent([content])
Paramètres:
  • contentstring|Element|Text optional contenu à afficher dans cette fenêtre d'informations.
Valeur de retour:aucune
setOptions
setOptions([options])
Paramètres:
Valeur de retour:aucune
setPosition
setPosition([position])
Paramètres:
  • positionLatLng|LatLngLiteral optional position LatLng à laquelle afficher cette fenêtre d'informations.
Valeur de retour:aucune
setZIndex
setZIndex(zIndex)
Paramètres:
  • zIndexnumber z-index de cette fenêtre d'informations. Une fenêtre d'informations ayant un z-index plus élevé s'affiche devant toutes les autres fenêtres d'info ayant un z-index plus faible.
Valeur de retour:aucune
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function()
Arguments:aucun
Cet événement est déclenché lorsque l'utilisateur clique sur le bouton de fermeture.
content_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété de contenu est modifiée.
domready
function()
Arguments:aucun
Cet événement est déclenché lorsque <div>, qui contient le contenu de InfoWindow, est associé au DOM. Vous pouvez surveiller cet événement si vous créez le contenu de votre fenêtre d'informations de manière dynamique.
position_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété de position change.
visible
function()
Arguments:aucun
Cet événement est déclenché lorsque le InfoWindow est entièrement visible. Cet événement n'est pas déclenché lorsque l'utilisateur fait un panoramique sur InfoWindow, puis revient à l'écran.
zindex_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque le zIndex de InfoWindow change.

InfoWindowOptions

google.maps.InfoWindowOptions interface

Objet InfoWindowOptions permettant de définir les propriétés pouvant être définies sur une fenêtre d'informations.

ariaLabel optional
Type:string optional
AriaLabel à attribuer à la fenêtre d'informations.
content optional
Type:string|Element|Text optional
Contenu à afficher dans la fenêtre d'informations. Il peut s'agir d'un élément HTML, d'une chaîne en texte brut ou d'une chaîne HTML. La taille de la fenêtre d'informations est définie en fonction du contenu. Pour définir une taille explicite pour le contenu, définissez le contenu en tant qu'élément HTML de cette taille.
disableAutoPan optional
Type:boolean optional
Par défaut:false
Désactivez le panoramique pour que la fenêtre d'informations soit entièrement visible à l'ouverture.
maxWidth optional
Type:number optional
Largeur maximale de la fenêtre d'informations, quelle que soit la largeur du contenu. Cette valeur n'est prise en compte que si elle est définie avant un appel à open(). Pour modifier la largeur maximale lorsque vous modifiez le contenu, appelez close(), setOptions(), puis open().
minWidth optional
Type:number optional
Largeur minimale de la fenêtre d'informations, quelle que soit la largeur du contenu. Lorsque vous utilisez cette propriété, il est vivement recommandé de définir minWidth sur une valeur inférieure à la largeur de la carte (en pixels). Cette valeur n'est prise en compte que si elle est définie avant un appel à open(). Pour modifier la largeur minimale lorsque vous modifiez le contenu, appelez close(), setOptions(), puis open().
pixelOffset optional
Type:Size optional
Décalage, en pixels, de l'extrémité de la fenêtre d'informations par rapport au point sur la carte dont les coordonnées géographiques sont ancrées. Si une fenêtre d'informations est ouverte avec une ancre, la pixelOffset est calculée à partir de la propriété anchorPoint de l'ancre.
position optional
Type:LatLng|LatLngLiteral optional
LatLng à laquelle afficher cette fenêtre d'informations. Si la fenêtre d'informations est ouverte avec une ancre, la position de l'ancre est utilisée.
zIndex optional
Type:number optional
Tous les InfoFenêtres sont affichés sur la carte par ordre de zIndex. Les valeurs les plus élevées s'affichent devant celles dont les valeurs sont inférieures. Par défaut, les fenêtres d'informations sont affichées en fonction de leur latitude, les latitudes de fenêtres inférieures étant affichées devant celles de plus haute latitude. Les fenêtres d'informations sont toujours affichées devant les repères.

Interface InfoWindowOpenOptions

google.maps.InfoWindowOpenOptions interface

Options pour ouvrir une fenêtre d'informations

anchor optional
Ancrage sur lequel cette fenêtre d'informations sera positionnée. Si l'ancre n'est pas nulle, la fenêtre d'informations sera positionnée en haut au centre de l'ancre. La fenêtre d'informations sera affichée sur la même carte ou le même panorama que l'ancre (si disponible).
map optional
Type:Map|StreetViewPanorama optional
Carte ou panorama sur lequel afficher cette fenêtre d'informations.
shouldFocus optional
Type:boolean optional
Indique si le curseur doit être déplacé dans la fenêtre d'informations lorsqu'elle est ouverte. Lorsque cette propriété n'est pas définie, ou qu'elle est définie sur null ou undefined, une méthode heuristique permet de déterminer si le curseur doit être déplacé. Nous vous recommandons de définir explicitement cette propriété en fonction de vos besoins, car la méthode heuristique est susceptible de changer et peut ne pas fonctionner dans tous les cas d'utilisation.