InfoWindow-Klasse
google.maps.InfoWindow
Klasse
Ein Overlay, das wie eine Blase aussieht und oft mit einer Markierung verbunden ist.
Diese Klasse erweitert MVCObject
.
Rufen Sie dazu const {InfoWindow} = await google.maps.importLibrary("maps")
oder const {InfoWindow} = await google.maps.importLibrary("streetView")
auf. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
InfoWindow |
InfoWindow([opts]) Parameter:
Erstellt ein Infofenster mit den angegebenen Optionen. Ein Infofenster kann auf einer Karte, je nach angegebenen Optionen, an einer bestimmten Position oder oberhalb einer Markierung platziert werden. Ein InfoFenster schwenkt die Karte, so dass es beim Öffnen sichtbar wird, es sei denn, automatisches Schwenken ist inaktiviert. Nachdem Sie ein InfoWindow konstruiert haben, rufen Sie Öffnen auf, damit es auf der Karte angezeigt wird. Der Nutzer kann auf die Schaltfläche "Schließen" in InfoWindow klicken, um es aus der Karte zu entfernen. Alternativ kann der Entwickler zum gleichen Zweck "close()" aufrufen. |
Methoden | |
---|---|
close |
close() Parameter:Keine
Rückgabewert:Keine
Schließt dieses Infofenster, indem es aus der DOM-Struktur entfernt wird. |
focus |
focus() Parameter:Keine
Rückgabewert:Keine
Legt den Fokus auf dieses InfoWindow . Sie können diese Methode zusammen mit einem visible -Ereignis verwenden, damit InfoWindow sichtbar ist, bevor Sie den Fokus darauf setzen. Ein InfoWindow , der nicht sichtbar ist, kann nicht fokussiert werden. |
getContent |
getContent() Parameter:Keine
|
getPosition |
getPosition() Parameter:Keine
Rückgabewert:
LatLng|null|undefined Die LatLng-Position dieses Infofensters. |
getZIndex |
getZIndex() Parameter:Keine
Rückgabewert:
number Der zIndex dieses Infofensters |
open |
open([options, anchor]) Parameter:
Rückgabewert:Keine
Öffnet dieses InfoWindow in der angegebenen Karte. Optional kann ein InfoWindow mit einem Anker verbunden werden. Im Kern-API ist der einzige Anker die Markierungsklasse. Ein Anker kann jedoch ein beliebiges MVCObject sein, das eine LatLng-Eigenschaft position und optional eine Punkt-anchorPoint -Eigenschaft zur Berechnung von pixelOffset zur Verfügung stellt (siehe InfoWindowOptions). anchorPoint ist der Versatz von der Position des Ankers bis zur Spitze des Infofensters. Es empfiehlt sich, die Schnittstelle InfoWindowOpenOptions als einzelnes Argument für diese Methode zu verwenden. Um zu verhindern, dass der Browserfokus beim Öffnen geändert wird, setzen Sie InfoWindowOpenOptions.shouldFocus auf false . |
setContent |
setContent([content]) Parameter:
Rückgabewert:Keine
|
setOptions |
setOptions([options]) Parameter:
Rückgabewert:Keine
|
setPosition |
setPosition([position]) Parameter:
Rückgabewert:Keine
|
setZIndex |
setZIndex(zIndex) Parameter:
Rückgabewert:Keine
|
Übernommen:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Veranstaltungen | |
---|---|
closeclick |
function() Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn auf die Schalfläche Schließen geklickt wurde. |
content_changed |
function() Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft Inhalt ändert. |
domready |
function() Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn der <div> mit dem Inhalt des InfoWindow an das DOM angehängt wird. Möglicherweise möchten Sie dieses Ereignis überwachen, falls Sie Ihren Infofenster-Inhalt dynamisch erstellen. |
position_changed |
function() Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft Position ändert. |
visible |
function() Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn InfoWindow vollständig sichtbar ist. Dieses Ereignis wird nicht ausgelöst, wenn InfoWindow nach unten und dann wieder auf dem Bildschirm verschoben wird. |
zindex_changed |
function() Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich der ZIndex des InfoWindow ändert. |
InfoWindowOptions-Schnittstelle.
google.maps.InfoWindowOptions
-Schnittstelle
InfoWindowOptions-Objekt verwendet, das zum Definieren der Eigenschaften für ein Infofenster verwendet wird.
Attribute | |
---|---|
ariaLabel optional |
Typ:
string optional AriaLabel, das dem Infofenster zugewiesen werden soll. |
content optional |
Im InfoFenster anzuzeigender Inhalt. Dies kann ein HTML-Element sein, eine reine Zeichenfolge oder eine Zeichenfolge, die HTML enthält. Die Größe des InfoFensters wird seinem Inhalt angepasst. Um ausdrücklich eine Größe für den Inhalt zu bestimmen, legen Sie fest, dass der Inhalt ein HTML-Element mit dieser Größe sein soll. |
disableAutoPan optional |
Typ:
boolean optional Standardwert:
false Deaktivieren Sie das Schwenken der Karte, damit das Infofenster beim Öffnen vollständig sichtbar wird. |
maxWidth optional |
Typ:
number optional Maximale Breite des Infofensters, unabhängig von der Breite des Inhalts. Dieser Wert wird nur berücksichtigt, wenn er vor dem Aufruf von open() festgelegt wird. Um die maximale Breite beim Ändern von Inhalten zu ändern, rufen Sie close() , setOptions() und dann open() auf. |
minWidth optional |
Typ:
number optional Minimale Breite des Infofensters, unabhängig von der Breite des Inhalts. Wenn Sie diese Eigenschaft verwenden, wird dringend empfohlen, für minWidth einen Wert festzulegen, der kleiner als die Breite der Karte (in Pixeln) ist. Dieser Wert wird nur berücksichtigt, wenn er vor dem Aufruf von open() festgelegt wird. Um die Mindestbreite beim Ändern von Inhalten zu ändern, rufen Sie close() , setOptions() und dann open() auf. |
pixelOffset optional |
Typ:
Size optional Der Abstand in Pixeln zwischen der Spitze des Infofensters und dem Punkt auf der Karte, an dessen geografischen Koordinaten das Infofenster verankert ist. Wenn ein Infofenster mit einem Anker geöffnet wird, wird pixelOffset aus der Eigenschaft anchorPoint des Ankers berechnet. |
position optional |
Typ:
LatLng|LatLngLiteral optional Der LatLng-Wert, bei der diesem InfoWindow angezeigt werden soll. Wenn das Infofenster mit einem Anker geöffnet wird, wird stattdessen die Ankerposition verwendet. |
zIndex optional |
Typ:
number optional Sämtliche InfoWindow-Elemente werden auf der Karte in der Reihenfolge ihrer zIndex angezeigt, wobei InfoWindow-Elemente mit höheren Werten vor InfoWindow-Elementen mit niedrigeren Werten rangieren. Standardmäßig werden InfoWindow-Elemente gemäß ihrem Breitengrad angezeigt, wobei InfoWindow-Elemente mit niedrigeren Breiten vor InfoWindow-Elementen mit höheren Breiten angezeigt werden. InfoWindows-Elemente werden immer vor Markierungen angezeigt. |
InfoWindowOpenOptions-Schnittstelle.
google.maps.InfoWindowOpenOptions
-Schnittstelle
Optionen zum Öffnen eines Infofensters
Attribute | |
---|---|
anchor optional |
Typ:
MVCObject|AdvancedMarkerElement optional Der Anker, auf dem dieses Infofenster positioniert wird. Wenn der Anker nicht null ist, wird das Infofenster oben in der Mitte des Ankers positioniert. Das InfoWindow wird auf derselben Karte oder demselben Panorama wie der Anker gerendert, falls verfügbar. |
map optional |
Typ:
Map|StreetViewPanorama optional Die Karte oder das Panorama, auf der bzw. dem dieses Infofenster gerendert werden soll. |
shouldFocus optional |
Typ:
boolean optional Gibt an, ob der Fokus in das Infofenster verschoben werden soll, wenn es geöffnet wird. Wenn dieses Attribut nicht konfiguriert oder auf null oder undefined gesetzt ist, wird anhand einer Heuristik entschieden, ob der Fokus verschoben werden soll oder nicht. Es wird empfohlen, diese Eigenschaft explizit an Ihre Anforderungen anzupassen, da sich die Heuristik ändern kann und möglicherweise nicht für alle Anwendungsfälle gut funktioniert. |