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.
Constructeur | |
---|---|
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. |
Méthodes | |
---|---|
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
|
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:
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:
Return Value (Valeur renvoyée) : aucune
|
setOptions |
setOptions([options]) Paramètres:
Return Value (Valeur renvoyée) : aucune
|
setPosition |
setPosition([position]) Paramètres:
Return Value (Valeur renvoyée) : aucune
|
setZIndex |
setZIndex(zIndex) Paramètres:
Return Value (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 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. |
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 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.
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 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. |
headerContent 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 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 de l'en-tête, définissez headerContent en tant qu'élément HTML de cette taille. |
headerDisabled optional |
Type:
boolean optional Désactive toute la ligne d'en-tête dans la fenêtre d'informations. Lorsque 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 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
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 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. |