Info Window

Classe InfoWindow

class google.maps.InfoWindow extends MVCObject
library "maps", "streetView"

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

const {InfoWindow} = await google.maps.importLibrary("maps");
 ou 
const {InfoWindow} = await google.maps.importLibrary("streetView");
InfoWindow
InfoWindow([opts])
Paramètres :
Crée une fenêtre d'informations avec les options données. Une InfoWindow peut être placée sur une carte à une position spécifique ou au-dessus d'un repère, selon ce qui est spécifié dans les options. Sauf si le panoramique automatique est désactivé, une InfoWindow déplace la carte pour se rendre visible lorsqu'elle est ouverte. Après avoir créé un InfoWindow, vous devez appeler open pour l'afficher sur la carte. L'utilisateur peut cliquer sur le bouton de fermeture de l'InfoWindow pour la supprimer de la carte, ou le développeur peut appeler close() pour obtenir le même effet.
isOpen
readonly
Type : boolean
Vérifie si l'InfoWindow est ouverte.
close
close()
Paramètres : aucun
Valeur renvoyée : aucune
Ferme cet InfoWindow en le supprimant de la structure DOM.
focus
focus()
Paramètres : aucun
Valeur renvoyée : aucune
Définit la sélection 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 InfoWindow qui n'est pas visible ne peut pas être sélectionné.
getContent
getContent()
Paramètres : aucun
Valeur renvoyée : string|Element|Text|null|undefined Le contenu de cette InfoWindow. Identique à ce qui était précédemment défini comme contenu.
getHeaderContent
getHeaderContent()
Paramètres : aucun
Valeur renvoyée : string|Element|Text|null|undefined Le contenu de l'en-tête de cette InfoWindow. Consultez InfoWindowOptions.headerContent.
getHeaderDisabled
getHeaderDisabled()
Paramètres : aucun
Valeur renvoyée : boolean|undefined Indique si toute la ligne d'en-tête est désactivée ou non. Consultez InfoWindowOptions.headerDisabled.
getPosition
getPosition()
Paramètres : aucun
Valeur renvoyée : LatLng|null|undefined Position LatLng de cette InfoWindow.
getZIndex
getZIndex()
Paramètres : aucun
Valeur renvoyée : number Le zIndex de cette InfoWindow.
open
open([options, anchor])
Paramètres :
  • options: InfoWindowOpenOptions|Map|StreetViewPanorama optional Objet InfoWindowOpenOptions (recommandé) ou carte/panorama sur lequel afficher cet InfoWindow.
  • anchor: MVCObject|AdvancedMarkerElement optional : l'ancre sur laquelle cette InfoWindow sera positionnée. Si l'ancrage n'est pas nul, l'InfoWindow sera positionnée en haut au centre de l'ancrage. L'InfoWindow s'affiche sur la même carte ou le même panorama que l'ancrage (si disponible).
Valeur renvoyée : aucune
Ouvre cet InfoWindow sur la carte donnée. Vous pouvez éventuellement associer un InfoWindow à une ancre. Dans l'API de base, le seul ancrage est la classe Marker. Toutefois, une ancre peut être n'importe quel MVCObject qui expose une propriété LatLng position et, éventuellement, une propriété Point anchorPoint pour calculer le pixelOffset (voir InfoWindowOptions). anchorPoint est le décalage entre la position de l'ancre et l'extrémité de l'InfoWindow. Il est recommandé d'utiliser l'interface InfoWindowOpenOptions comme seul argument pour cette méthode. Pour empêcher le changement de focus du navigateur à l'ouverture, définissez InfoWindowOpenOptions.shouldFocus sur false.
setContent
setContent([content])
Paramètres :
  • content: string|Element|Text optional Contenu à afficher dans cette InfoWindow.
Valeur renvoyée : aucune
setHeaderContent
setHeaderContent([headerContent])
Paramètres :
Valeur renvoyée : aucune
setHeaderDisabled
setHeaderDisabled([headerDisabled])
Paramètres :
Valeur renvoyée : aucune
setOptions
setOptions([options])
Paramètres :
Valeur renvoyée : aucune
setPosition
setPosition([position])
Paramètres :
  • position: LatLng|LatLngLiteral optional Position LatLng à laquelle afficher cette InfoWindow.
Valeur renvoyée : aucune
setZIndex
setZIndex(zIndex)
Paramètres :
  • zIndex: number : z-index de cet objet InfoWindow. Une InfoWindow avec un z-index plus élevé s'affiche devant toutes les autres InfoWindows avec un z-index plus faible.
Valeur renvoyée : aucune
Héritées : addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
Arguments : aucun
Cet événement est déclenché chaque fois que le InfoWindow se ferme. Par exemple, cela peut se produire en appelant la méthode InfoWindow.close, en appuyant sur la touche Échap pour fermer l'InfoWindow, en cliquant sur le bouton de fermeture ou en déplaçant l'InfoWindow vers une autre carte.
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 change.
domready
function()
Arguments : aucun
Cet événement est déclenché lorsque l'élément <div> contenant 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.
headercontent_changed
function()
Arguments : aucun
Cet événement est déclenché lorsque la propriété headerContent change.
headerdisabled_changed
function()
Arguments : aucun
Cet événement est déclenché lorsque la propriété headerDisabled change.
position_changed
function()
Arguments : aucun
Cet événement est déclenché lorsque la propriété "position" change.
visible
function()
Arguments : aucun
Cet événement est déclenché lorsque l'élément InfoWindow est entièrement visible. Cet événement n'est pas déclenché lorsque InfoWindow est déplacé hors de l'écran, puis de nouveau à l'écran.
zindex_changed
function()
Arguments : aucun
Cet événement est déclenché lorsque l'index Z de l'objet InfoWindow change.

InfoWindowOptions

interface google.maps.InfoWindowOptions

Objet InfoWindowOptions utilisé pour définir les propriétés pouvant être définies sur un InfoWindow.
ariaLabel
facultatif
Type : string optional
AriaLabel à attribuer à l'InfoWindow.
content
facultatif
Type : string|Element|Text optional
Contenu à afficher dans l'InfoWindow. Il peut s'agir d'un élément HTML, d'une chaîne de texte brut ou d'une chaîne contenant du code HTML. La taille de l'InfoWindow est adaptée au contenu. Pour définir une taille explicite pour le contenu, définissez-le comme un élément HTML de cette taille.
disableAutoPan
facultatif
Type : boolean optional
Par défaut : false
Désactivez le panoramique de la carte pour que l'InfoWindow soit entièrement visible lorsqu'elle s'ouvre.
headerContent
facultatif
Type : string|Element|Text optional
Contenu à afficher dans la ligne d'en-tête de l'InfoWindow. Il peut s'agir d'un élément HTML ou d'une chaîne de texte brut. La taille de l'InfoWindow est adaptée au contenu. Pour définir une taille explicite pour le contenu de l'en-tête, définissez headerContent sur un élément HTML de cette taille.
headerDisabled
facultatif
Type : boolean optional
Désactive toute la ligne d'en-tête dans InfoWindow. Si cette valeur est définie sur "true", l'en-tête est supprimé, ce qui masque son contenu et le bouton de fermeture.
maxWidth
facultatif
Type : number optional
Largeur maximale de l'InfoWindow, 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
facultatif
Type : number optional
Largeur minimale de l'InfoWindow, 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
facultatif
Type : Size optional
Décalage, en pixels, entre l'extrémité de la fenêtre d'informations et le point de la carte dont les coordonnées géographiques correspondent à l'ancrage de la fenêtre d'informations. Si une InfoWindow est ouverte avec un ancrage, la propriété pixelOffset sera calculée à partir de la propriété anchorPoint de l'ancrage.
position
facultatif
Type : LatLng|LatLngLiteral optional
LatLng auquel afficher cette InfoWindow. Si l'InfoWindow est ouverte avec un ancrage, la position de l'ancrage sera utilisée à la place.
zIndex
facultatif
Type : number optional
Toutes les fenêtres d'informations sont affichées sur la carte par ordre de zIndex, les valeurs plus élevées s'affichant devant les fenêtres d'informations ayant des valeurs plus faibles. Par défaut, les InfoWindows sont affichées en fonction de leur latitude. Celles situées à des latitudes plus basses apparaissent devant celles situées à des latitudes plus élevées. Les InfoWindows s'affichent toujours devant les repères.

Interface InfoWindowOpenOptions

interface google.maps.InfoWindowOpenOptions

Options d'ouverture d'une InfoWindow
anchor
facultatif
Ancre sur laquelle cette InfoWindow sera positionnée. Si l'ancrage n'est pas nul, l'InfoWindow sera positionnée en haut au centre de l'ancrage. L'InfoWindow s'affiche sur la même carte ou le même panorama que l'ancrage (si disponible).
map
facultatif
Type : Map|StreetViewPanorama optional
Carte ou panorama sur lequel afficher cette InfoWindow.
shouldFocus
facultatif
Type : boolean optional
Indique si le curseur doit être déplacé dans l'InfoWindow lorsqu'elle est ouverte. Lorsque cette propriété n'est pas définie ou qu'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.