Info Window

Classe InfoWindow

Classe google.maps.InfoWindow

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

Cette classe étend MVCObject.

Accédez à la carte 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 proposées. Une fenêtre d'informations peut être placée sur une carte à un endroit précis ou au-dessus d'un repère, en fonction de ce qui est spécifié dans les options. À moins que le panoramique automatique ne soit désactivé, une fenêtre d'informations effectue un panoramique de la carte pour la rendre visible à l'ouverture. Après avoir créé une fenêtre d'informations, vous devez appeler open pour l'afficher sur la carte. L'utilisateur peut cliquer sur le bouton de fermeture de la fenêtre d'informations pour la supprimer de la carte, ou le développeur peut appeler la fonction "close()" pour obtenir le même effet.
close
close()
Paramètres:aucun
Return Value (Valeur renvoyée) : aucune
Ferme cette fenêtre d'informations en la supprimant de la structure DOM.
focus
focus()
Paramètres:aucun
Return Value (Valeur renvoyée) : aucune
Place le focus sur ce InfoWindow. Vous pouvez envisager d'utiliser cette méthode avec un événement visible pour vous assurer que InfoWindow est visible avant de placer le curseur dessus. Un élément InfoWindow non visible ne peut pas être sélectionné.
getContent
getContent()
Paramètres:aucun
Valeur renvoyée:string|Element|Text|null|undefined Contenu de cette fenêtre d'informations. Identique au contenu précédemment défini.
getPosition
getPosition()
Paramètres:aucun
Return Value (Valeur renvoyée) : LatLng|null|undefined position LatLng de cette fenêtre d'informations.
getZIndex
getZIndex()
Paramètres:aucun
Valeur renvoyée:number zIndex de cette fenêtre d'informations.
open
open([options, anchor])
Paramètres: 
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional objet InfoWindowOpenOptions (recommandé) ou carte|panorama sur lequel afficher cette fenêtre d'informations.
  • anchorMVCObject|AdvancedMarkerElement optional L'ancre sur laquelle 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 s'affiche sur la même carte ou le même panorama que l'ancre (si disponible).
Return Value (Valeur renvoyée) : 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, le seul ancrage est la classe Marker. Toutefois, une ancre peut être n'importe quel objet MVCObject qui expose une propriété LatLng position 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 la modification de la sélection du navigateur lors de l'ouverture, définissez InfoWindowOpenOptions.shouldFocus sur false.
setContent
setContent([content])
Paramètres: 
  • contentstring|Element|Text optional Le contenu que cette fenêtre d'informations doit afficher.
Return Value (Valeur renvoyée) : aucune
setOptions
setOptions([options])
Paramètres: 
Return Value (Valeur renvoyée) : aucune
setPosition
setPosition([position])
Paramètres: 
  • positionLatLng|LatLngLiteral optional position LatLng à laquelle la fenêtre d'informations doit être affichée.
Return Value (Valeur renvoyée) : aucune
setZIndex
setZIndex(zIndex)
Paramètres: 
  • zIndexnumber z-index de cette fenêtre d'informations. Une fenêtre d'informations dont le z-index est plus élevé s'affiche devant toutes les autres fenêtres d'informations dont le z-index est plus faible.
Return Value (Valeur renvoyée) : aucune
Hérité:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
Arguments:aucun
Cet événement est déclenché chaque fois que InfoWindow se ferme. Il peut s'agir, par exemple, d'appeler la méthode InfoWindow.close, d'appuyer sur la touche Échap pour fermer la fenêtre d'informations, de cliquer sur le bouton de fermeture ou de déplacer la fenêtre d'informations vers une autre carte.
closeclick
function()
Arguments:aucun
Cet événement est déclenché lors d'un clic 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 le <div> contenant le contenu de l'InfoWindow est joint au DOM. Vous pouvez surveiller cet événement si vous développez 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 InfoWindow est entièrement visible. Cet événement n'est pas déclenché lorsque InfoWindow est de nouveau affiché à l'écran après avoir été déplacé en mode panoramique.
zindex_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque le zIndex de InfoWindow change.

InfoWindowOptions.

Interface google.maps.InfoWindowOptions

Objet InfoWindowOptions utilisé pour 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 contenant du code HTML. La taille de la fenêtre d'informations dépend 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 mode panoramique pour rendre la fenêtre d'informations entièrement visible lorsqu'elle s'ouvre.
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 lors de la modification du 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é, nous vous recommandons vivement 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 lors de la modification du 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 à partir du point sur la carte auquel la fenêtre d'informations est ancrée aux coordonnées géographiques. Si une fenêtre d'informations est ouverte avec une ancre, pixelOffset sera calculé à 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 celle-ci est utilisée.
zIndex optional
Type:number optional
Toutes les fenêtres d'informations sont affichées sur la carte dans l'ordre de leur zIndex, les valeurs plus élevées s'affichant devant les fenêtres d'informations avec des valeurs plus faibles. Par défaut, les fenêtres d'informations s'affichent en fonction de leur latitude, les fenêtres d'informations de latitudes inférieures s'affichant devant les fenêtres d'informations à des latitudes plus élevées. Les fenêtres d'informations sont toujours affichées devant les marqueurs.

InfoWindowOpenOptions.

Interface google.maps.InfoWindowOpenOptions

Options d'ouverture d'une fenêtre d'informations

anchor optional
Ancre sur laquelle 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 s'affiche 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. Si cette propriété n'est pas définie, ou si elle est définie sur null ou undefined, une heuristique est utilisée pour décider si le curseur doit être déplacé ou non. Nous vous recommandons de définir explicitement cette propriété en fonction de vos besoins, car l'heuristique est susceptible de changer et peut ne pas fonctionner correctement pour tous les cas d'utilisation.