Info Window

Classe InfoWindow

Classe google.maps.InfoWindow

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

Cette classe étend MVCObject.

Accédez-y en appelant const {InfoWindow} = await google.maps.importLibrary("maps") ou const {InfoWindow} = await google.maps.importLibrary("streetView"). Consultez la section Bibliothèques de l'API Maps JavaScript.

Constructeur

InfoWindow

InfoWindow([opts]) Paramètres: opts:  InfoWindowOptions optional Crée une fenêtre d'informations avec les options données. Une InfoWindow peut être placée sur une carte à un emplacement particulier ou au-dessus d'un repère, en fonction de ce qui est spécifié dans les options. Sauf si le panoramique automatique est désactivé, une InfoWindow fait pivoter la carte pour se rendre visible lorsqu'elle est ouverte. Après avoir créé une 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.

Propriétés
isOpen	Type:boolean Vérifie si l'InfoWindow est ouverte.

Méthodes
close	close() Paramètres:aucun Valeur renvoyée:aucune Ferme cette InfoWindow en la supprimant de la structure DOM.
focus	focus() Paramètres:aucun Valeur renvoyée:aucune Définit la mise au point sur cet élément InfoWindow. Vous pouvez envisager d'utiliser cette méthode avec un événement visible pour vous assurer que InfoWindow est visible avant de le mettre en surbrillance. Un InfoWindow qui n'est pas visible ne peut pas être mis au point.
getContent	getContent() Paramètres:aucun Valeur renvoyée:string|Element|Text|null|undefined Contenu de cette InfoWindow. Il s'agit du contenu précédemment défini.
getHeaderContent	getHeaderContent() Paramètres:aucun Valeur renvoyée:string|Element|Text|null|undefined Contenu de l'en-tête de cette InfoWindow. Consultez InfoWindowOptions.headerContent.
getHeaderDisabled	getHeaderDisabled() Paramètres:aucun Valeur renvoyée:boolean|undefined Indique si l'ensemble de la ligne d'en-tête est désactivé 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 Indice z de cette fenêtre d'informations.
open	open([options, anchor]) Paramètres: options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional Un objet InfoWindowOpenOptions (recommandé) ou la carte/le panorama sur lequel afficher cette InfoWindow. anchor:  MVCObject|AdvancedMarkerElement optional Ancrage auquel cette InfoWindow sera positionnée. Si l'ancre n'est pas nulle, l'InfoWindow est placé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 (lorsqu'elle est disponible). Valeur renvoyée:aucune Ouvre cette InfoWindow sur la carte donnée. Une InfoWindow peut éventuellement être associée à un ancrage. Dans l'API principale, la seule ancre est la classe Marker. Toutefois, un ancrage peut être n'importe quel MVCObject qui expose une propriété position LatLng et éventuellement une propriété anchorPoint Point pour calculer la pixelOffset (voir InfoWindowOptions). anchorPoint correspond au 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 de cette méthode. Pour éviter de modifier le 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: headerContent:  string|Element|Text optional Contenu de l'en-tête à afficher par cette InfoWindow. Consultez InfoWindowOptions.headerContent. Valeur renvoyée:aucune
setHeaderDisabled	setHeaderDisabled([headerDisabled]) Paramètres: headerDisabled:  boolean optional Indique si toute la ligne d'en-tête doit être désactivée. Consultez InfoWindowOptions.headerDisabled. Valeur renvoyée:aucune
setOptions	setOptions([options]) Paramètres: options:  InfoWindowOptions optional 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 Indice Z de cette InfoWindow. Une InfoWindow avec un z-index plus élevé s'affiche devant toutes les autres InfoWindows ayant un z-index inférieur. Valeur renvoyée:aucune
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Événements
close	function() Arguments:aucun Cet événement est déclenché chaque fois que l'InfoWindow se ferme. Par exemple, il peut s'agir d'un appel de la méthode InfoWindow.close, d'une pression sur la touche Échap pour fermer la fenêtre d'informations, ou d'un clic sur le bouton de fermeture ou d'un déplacement de la fenêtre d'informations vers une autre carte.
closeclick	function() Arguments:aucun Cet événement est déclenché lorsqu'un utilisateur clique sur le bouton de fermeture.
content_changed	function() Arguments:aucun Cet événement est déclenché lorsque la propriété "content" change.
domready	function() Arguments:aucun Cet événement se déclenche lorsque le <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'InfoWindow est entièrement visible. Cet événement n'est pas déclenché lorsque InfoWindow est masqué, puis réapparu à l'écran.
zindex_changed	function() Arguments:aucun Cet événement est déclenché lorsque l'indice z de l'InfoWindow change.

Interface InfoWindowOptions

Interface google.maps.InfoWindowOptions

Objet InfoWindowOptions utilisé pour définir les propriétés pouvant être définies sur un InfoWindow.

Propriétés
ariaLabel optional	Type:string optional AriaLabel à attribuer à l'InfoWindow.
content optional	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 contenu comme un élément HTML de cette taille.
disableAutoPan optional	Type:boolean optional Par défaut:false Désactivez le panoramique de la carte pour que la fenêtre d'informations soit entièrement visible lorsqu'elle s'ouvre.
headerContent optional	Type:string|Element|Text optional Contenu à afficher dans la ligne d'en-tête de la fenêtre d'informations. 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 optional	Type:boolean optional Désactive l'intégralité de la ligne d'en-tête dans la fenêtre d'informations. Si cette valeur est définie sur "true", l'en-tête est supprimé, ce qui masque le contenu de l'en-tête et le bouton de fermeture.
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 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 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 de la carte dont les coordonnées géographiques correspondent à celles de la fenêtre d'informations. Si une InfoWindow est ouverte avec une ancre, pixelOffset est calculé à partir de la propriété anchorPoint de l'ancre.
position optional	Type:LatLng|LatLngLiteral optional Coordonnées LatLng à afficher pour cette fenêtre d'informations. Si l'InfoWindow est ouverte avec un ancrage, la position de l'ancrage est utilisée à la place.
zIndex optional	Type:number optional Toutes les InfoWindows sont affichées sur la carte par ordre de zIndex, les valeurs plus élevées s'affichant devant les InfoWindows ayant des valeurs plus faibles. Par défaut, les InfoWindows s'affichent en fonction de leur latitude, les InfoWindows de latitudes inférieures apparaissant devant celles de latitudes supérieures. Les InfoWindows s'affichent toujours devant les repères.

Interface InfoWindowOpenOptions

Interface google.maps.InfoWindowOpenOptions

Options pour ouvrir une InfoWindow

Propriétés
anchor optional	Type:MVCObject|AdvancedMarkerElement optional Ancrage auquel cette fenêtre d'informations sera positionnée. Si l'ancre n'est pas nulle, l'InfoWindow est placé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 (lorsqu'elle est disponible).
map optional	Type:Map|StreetViewPanorama optional Carte ou panorama sur lesquels afficher cette InfoWindow.
shouldFocus optional	Type:boolean optional Indique si le focus 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 heuristique est utilisée pour déterminer si le focus 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 d'évoluer et de ne pas fonctionner correctement pour tous les cas d'utilisation.