InfoWindow-Klasse
google.maps.InfoWindow
class
extends MVCObject
library "maps", "streetView"
Ein Overlay, das wie eine Blase aussieht und oft mit einer Markierung verbunden ist.
const {InfoWindow} = await google.maps.importLibrary("maps");
const {InfoWindow} = await google.maps.importLibrary("streetView");
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. |
Attribute | |
|---|---|
isOpen
readonly |
Typ:
booleanPrüft, ob das InfoWindow geöffnet ist. |
Methoden | |
|---|---|
close |
close()Parameter: Keine
Rückgabewert: Keiner
Schließt dieses Infofenster, indem es aus der DOM-Struktur entfernt wird. |
focus |
focus()Parameter: Keine
Rückgabewert: Keiner
Legt den Fokus auf dieses InfoWindow. Wir empfehlen, diese Methode zusammen mit einem visible-Ereignis zu verwenden, um sicherzustellen, dass InfoWindow sichtbar ist, bevor Sie den Fokus darauf festlegen. Ein nicht sichtbares InfoWindow kann nicht fokussiert werden. |
getContent |
getContent()Parameter: Keine
|
getHeaderContent |
getHeaderContent()Parameter: Keine
Rückgabewert:
string|Element|Text|null|undefined Der Headerinhalt dieses InfoWindow. Siehe InfoWindowOptions.headerContent. |
getHeaderDisabled |
getHeaderDisabled()Parameter: Keine
Rückgabewert:
boolean|undefined Gibt an, ob die gesamte Kopfzeile deaktiviert ist oder nicht. Siehe InfoWindowOptions.headerDisabled. |
getPosition |
getPosition()Parameter: Keine
Rückgabewert:
LatLng|null|undefined Die LatLng-Position dieses InfoWindow. |
getZIndex |
getZIndex()Parameter: Keine
Rückgabewert:
number Der zIndex dieses InfoWindow. |
open |
open([options, anchor])Parameter:
Rückgabewert: Keiner
Ö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 ein LatLng-Attribut position und optional ein Point-Attribut anchorPoint zur Berechnung des pixelOffset-Werts enthält (siehe InfoWindowOptions). anchorPoint ist der Abstand von der Position des Ankers zur Spitze des InfoWindow. Es wird empfohlen, die Schnittstelle InfoWindowOpenOptions als einziges Argument für diese Methode zu verwenden. Wenn Sie verhindern möchten, dass sich der Browserfokus beim Öffnen ändert, setzen Sie InfoWindowOpenOptions.shouldFocus auf false. |
setContent |
setContent([content])Parameter:
Rückgabewert: Keiner
|
setHeaderContent |
setHeaderContent([headerContent])Parameter:
Rückgabewert: Keiner
|
setHeaderDisabled |
setHeaderDisabled([headerDisabled])Parameter:
Rückgabewert: Keiner
|
setOptions |
setOptions([options])Parameter:
Rückgabewert: Keiner
|
setPosition |
setPosition([position])Parameter:
Rückgabewert: Keiner
|
setZIndex |
setZIndex(zIndex)Parameter:
Rückgabewert: Keiner
|
Übernommen:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
Ereignisse | |
|---|---|
close |
function()Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn das InfoWindow geschlossen wird. Das kann beispielsweise durch Aufrufen der Methode InfoWindow.close, Drücken der Esc-Taste zum Schließen des InfoWindow, Klicken auf die Schaltfläche „Schließen“ oder Verschieben des InfoWindow auf eine andere Karte geschehen. |
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 das <div>, das den Inhalt des InfoWindow enthält, an das DOM angehängt wird. Möglicherweise möchten Sie dieses Ereignis überwachen, falls Sie Ihren Infofenster-Inhalt dynamisch erstellen. |
headercontent_changed |
function()Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft „headerContent“ ändert. |
headerdisabled_changed |
function()Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich die Eigenschaft „headerDisabled“ ändert. |
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 die InfoWindow vollständig sichtbar ist. Dieses Ereignis wird nicht ausgelöst, wenn InfoWindow aus dem Bildschirmbereich heraus- und dann wieder hineingeschwenkt wird. |
zindex_changed |
function()Argumente: Keine
Dieses Ereignis wird ausgelöst, wenn sich der zIndex des InfoWindow-Objekts ändert. |
InfoWindowOptions-Schnittstelle
Schnittstelle google.maps.InfoWindowOptions
InfoWindowOptions-Objekt, mit dem die Eigenschaften definiert werden, die für ein InfoWindow festgelegt werden können.
Attribute | |
|---|---|
ariaLabel
optional |
Typ:
string optionalAriaLabel, das dem InfoWindow 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 optionalStandard:
falseSchwenken der Karte deaktivieren, damit das InfoWindow beim Öffnen vollständig sichtbar ist. |
headerContent
optional |
Der Inhalt, der in der Kopfzeile des InfoWindow angezeigt werden soll. Dies kann ein HTML-Element oder ein Nur-Text-String sein. Die Größe des InfoFensters wird seinem Inhalt angepasst. Wenn Sie eine explizite Größe für den Headerinhalt festlegen möchten, legen Sie für „headerContent“ ein HTML-Element mit dieser Größe fest. |
headerDisabled
optional |
Typ:
boolean optionalDeaktiviert die gesamte Kopfzeile im InfoWindow. Wenn diese Option auf „true“ gesetzt ist, wird der Header entfernt, sodass der Headerinhalt und die Schaltfläche „Schließen“ ausgeblendet werden. |
maxWidth
optional |
Typ:
number optionalMaximale Breite des InfoWindow, unabhängig von der Breite des Inhalts. Dieser Wert wird nur berücksichtigt, wenn er vor einem Aufruf von open() festgelegt wird. Wenn Sie die maximale Breite beim Ändern von Inhalten ändern möchten, rufen Sie close(), setOptions() und dann open() auf. |
minWidth
optional |
Typ:
number optionalMindestbreite des InfoWindow, unabhängig von der Breite des Inhalts. Wenn Sie diese Property 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 einem Aufruf von open() festgelegt wird. Wenn Sie die Mindestbreite beim Ändern von Inhalten ändern möchten, rufen Sie close(), setOptions() und dann open() auf. |
pixelOffset
optional |
Typ:
Size optionalDer Abstand in Pixeln zwischen der Spitze des Infofensters und dem Punkt auf der Karte, an dessen geografischen Koordinaten das Infofenster verankert ist. Wenn ein InfoWindow mit einem Anker geöffnet wird, wird der pixelOffset aus der anchorPoint-Eigenschaft des Ankers berechnet. |
position
optional |
Typ:
LatLng|LatLngLiteral optionalDer LatLng-Wert, bei der diesem InfoWindow angezeigt werden soll. Wenn das InfoWindow mit einem Anker geöffnet wird, wird stattdessen die Position des Ankers verwendet. |
zIndex
optional |
Typ:
number optionalSä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 InfoWindows nach ihrem Breitengrad angezeigt. InfoWindows mit niedrigeren Breitengraden werden vor InfoWindows mit höheren Breitengraden angezeigt. InfoWindows-Elemente werden immer vor Markierungen angezeigt. |
Schnittstelle InfoWindowOpenOptions
Schnittstelle google.maps.InfoWindowOpenOptions
Optionen zum Öffnen eines InfoWindow
Attribute | |
|---|---|
anchor
optional |
Typ:
MVCObject|AdvancedMarkerElement optionalDer Anker, an dem dieses InfoWindow positioniert wird. Wenn der Anker nicht null ist, wird das InfoWindow 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 optionalDie Karte oder das Panorama, auf dem dieses InfoWindow gerendert werden soll. |
shouldFocus
optional |
Typ:
boolean optionalGibt an, ob der Fokus innerhalb des InfoWindow verschoben werden soll, wenn es geöffnet wird. Wenn diese Property nicht festgelegt ist oder auf null oder undefined gesetzt ist, wird anhand einer Heuristik entschieden, ob der Fokus verschoben werden soll oder nicht. Es wird empfohlen, dieses Attribut explizit an Ihre Anforderungen anzupassen, da sich die Heuristik ändern kann und möglicherweise nicht für alle Anwendungsfälle gut funktioniert. |