Classe InfoWindow
Classe google.maps.InfoWindow
Superposition qui ressemble à une bulle et qui est souvent reliée à un repère.
Cette classe étend MVCObject
.
Accédez au fichier 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:
Crée une fenêtre d'informations avec les options fournies. Une fenêtre d'informations peut être placée sur une carte à un point particulier ou au-dessus d'un repère, en fonction des options spécifiées. À moins que le panoramique automatique ne soit désactivé, une fenêtre d'informations fait un panoramique sur la carte pour la rendre visible à l'ouverture. Après avoir construit une fenêtre d'informations, vous devez appeler la méthode "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 close() pour le même effet. |
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
Met l'accent sur ce InfoWindow . Vous pouvez utiliser cette méthode avec un événement visible pour vous assurer que InfoWindow est visible avant de vous concentrer sur celui-ci. Un élément InfoWindow non visible ne peut pas être sélectionné. |
getContent |
getContent() Paramètres:aucun
|
getPosition |
getPosition() Paramètres:aucun
Valeur renvoyée:
LatLng|null|undefined 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:
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, la seule ancre est la classe Marker. Toutefois, une ancre peut être n'importe quel 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:
Valeur renvoyée:aucune
|
setOptions |
setOptions([options]) Paramètres:
Valeur renvoyée:aucune
|
setPosition |
setPosition([position]) Paramètres:
Valeur renvoyée:aucune
|
setZIndex |
setZIndex(zIndex) Paramètres:
Valeur renvoyée:aucune
|
Hérité:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Événements | |
---|---|
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 se déclenche 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 façon 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 ne se déclenche pas lorsque InfoWindow est déplacé, puis à l'écran. |
zindex_changed |
function() Arguments:aucun
Cet événement est déclenché lorsque le zIndex de InfoWindow change. |
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 AriaLabel à attribuer à la fenêtre d'informations. |
content 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 dépend du 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 sur la carte 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é, 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 sur la carte dont les coordonnées géographiques sont ancrées dans la fenêtre d'informations. Si une fenêtre d'informations est ouverte avec une ancre, le pixelOffset est 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 l'ancre est utilisée à la place. |
zIndex optional |
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 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 inférieures s'affichent devant celles de plus haute latitude. Les fenêtres d'informations sont toujours affichées devant les repères. |
Interface InfoWindowOpenOptions
Interface google.maps.InfoWindowOpenOptions
Options d'ouverture d'une fenêtre d'informations
Propriétés | |
---|---|
anchor optional |
Type:
MVCObject|AdvancedMarkerElement optional Annonce ancrée dans 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 Détermine si le curseur doit être déplacé dans la fenêtre d'informations lorsqu'elle est ouverte. Si cette propriété n'est pas configurée, ou si elle est définie sur null ou undefined , une heuristique permet de déterminer si le curseur doit être déplacé. Nous vous recommandons de définir explicitement cette propriété pour répondre à vos besoins, car les méthodes heuristiques sont susceptibles de changer et de ne pas fonctionner correctement dans tous les cas d'utilisation. |