Info Window

Classe InfoWindow

Classe google.maps.InfoWindow

Superposition qui ressemble à une bulle et est souvent connecté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.

Constructeur

InfoWindow

InfoWindow([opts]) Paramètres:  opts:  InfoWindowOptions optional 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 le panoramique automatique ne soit désactivé, une fenêtre d'informations effectue un panoramique sur la carte pour la rendre visible lorsqu'elle est ouverte. Après avoir créé une fenêtre d'informations, vous devez appeler la fonction "open" pour l'afficher sur la carte. L'utilisateur peut cliquer sur le bouton Fermer de la fenêtre d'informations pour le supprimer de la carte, ou le développeur peut appeler la fonction "close()" pour obtenir le même effet.

Propriétés
isOpen	Type:boolean Vérifie si la fenêtre d'informations est ouverte.

Méthodes
close	close() Paramètres:aucun Valeur renvoyée:aucune Ferme cette fenêtre d'informations en la supprimant de la structure DOM.
focus	focus() Paramètres:aucun Valeur renvoyée:aucune Place le focus 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 sélectionner. 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 à ce qui a été précédemment défini pour le contenu.
getHeaderContent	getHeaderContent() Paramètres:aucun Valeur renvoyée:string|Element|Text|null|undefined contenu de l'en-tête de cette fenêtre d'informations. Voir InfoWindowOptions.headerContent.
getHeaderDisabled	getHeaderDisabled() Paramètres:aucun Valeur renvoyée:boolean|undefined indique si l'intégralité de la ligne d'en-tête est désactivée ou non. Voir InfoWindowOptions.headerDisabled.
getPosition	getPosition() Paramètres:aucun 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:  options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional Un objet InfoWindowOpenOptions (recommandé) ou le plan|panorama sur lequel afficher cette fenêtre d'informations. anchor : MVCObject|AdvancedMarkerElement 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). Valeur renvoyée:aucune Ouvre cette fenêtre d'informations sur la carte donnée. Vous pouvez éventuellement associer une fenêtre d'informations à une ancre. Dans l'API principale, la seule ancre 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 la pixelOffset (voir InfoWindowOptions). anchorPoint correspond au décalage entre la position de l'ancre et l'extrémité de la fenêtre d'informations. Nous vous recommandons d'utiliser l'interface InfoWindowOpenOptions comme argument unique pour cette méthode. Pour empêcher la modification du curseur dans le navigateur lorsque l'état est ouvert, définissez InfoWindowOpenOptions.shouldFocus sur false.
setContent	setContent([content]) Paramètres:  content:  string|Element|Text optional Contenu à afficher par cette fenêtre d'informations Valeur renvoyée:aucune
setHeaderContent	setHeaderContent([headerContent]) Paramètres:  headerContent:  string|Element|Text optional contenu de l'en-tête que cette fenêtre d'informations doit afficher. Voir InfoWindowOptions.headerContent. Valeur renvoyée:aucune
setHeaderDisabled	setHeaderDisabled([headerDisabled]) Paramètres:  headerDisabled:  boolean optional indique si la ligne d'en-tête doit être entièrement désactivée. Voir 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 fenêtre d'informations. Valeur renvoyée:aucune
setZIndex	setZIndex(zIndex) Paramètres:  zIndex:  number 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'informations dont le z-index est inférieur. Valeur renvoyée:aucune
Hérités:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Événements
close	function() Arguments:aucun Cet événement est déclenché à la fermeture de InfoWindow. Par exemple, vous pouvez appeler la méthode InfoWindow.close, appuyer sur la touche Échap pour fermer la fenêtre d'informations, cliquer sur le bouton de fermeture ou déplacer la fenêtre d'informations 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 est modifiée.
domready	function() Arguments:aucun Cet événement est déclenché lorsque la <div> contenant le contenu de InfoWindow est associée 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 est modifiée.
headerdisabled_changed	function() Arguments:aucun Cet événement est déclenché lorsque la propriété headerDisabled est modifiée.
position_changed	function() Arguments:aucun Cet événement est déclenché lorsque la propriété de position est modifiée.
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 déplacé hors de l'écran, puis à nouveau affiché à l'écran.
zindex_changed	function() Arguments:aucun Cet événement est déclenché lorsque le zIndex de InfoWindow est modifié.

Interface 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.

Propriétés
ariaLabel optional	Type:string optional Étiquette Aria à 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 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 avec 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.
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 la fenêtre d'informations est définie en fonction du contenu. Pour définir une taille explicite pour le contenu de l'en-tête, définissez headerContent sur un élément HTML avec cette taille.
headerDisabled optional	Type:boolean optional Désactive toute la ligne d'en-tête dans la fenêtre d'informations. Si cette règle est définie sur "true", l'en-tête est supprimé afin que son contenu et le bouton de fermeture soient masqués.
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é, 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 auquel la fenêtre d'informations est ancrée. Si une fenêtre d'informations est ouverte avec une ancre, le pixelOffset sera calculé à partir de la propriété anchorPoint de l'ancre.
position optional	Type:LatLng|LatLngLiteral optional LatLng selon 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 à la place.
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 les plus élevées s'affichant devant les fenêtres d'informations avec les valeurs inférieures. Par défaut, les fenêtres d'informations sont affichées en fonction de leur latitude, les fenêtres d'informations de latitudes plus basses s'affichant devant les fenêtres d'informations à des latitudes plus élevées. Les fenêtres d'informations s'affichent toujours devant les repères.

Interface InfoWindowOpenOptions

Interface google.maps.InfoWindowOpenOptions

Options pour ouvrir une fenêtre d'informations

Propriétés
anchor optional	Type:MVCObject|AdvancedMarkerElement 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 la sélection doit être déplacée ou non. Nous vous recommandons de définir explicitement cette propriété pour répondre à vos besoins, car l'heuristique est susceptible d'être modifiée et peut ne pas fonctionner correctement dans tous les cas d'utilisation.