Info Window

Klasa InfoWindow

Klasa google.maps.InfoWindow

Nakładka, która wygląda jak dymek i często jest podłączona do znacznika.

Te zajęcia obejmują MVCObject.

Możesz uzyskać dostęp, dzwoniąc pod numer const {InfoWindow} = await google.maps.importLibrary("maps") lub const {InfoWindow} = await google.maps.importLibrary("streetView"). Zobacz biblioteki w interfejsie Maps JavaScript API.

InfoWindow
InfoWindow([opts])
Parametry: 
Tworzy okno informacyjne z podanymi opcjami. Okno informacyjne można umieścić na mapie w określonym miejscu lub nad znacznikiem, w zależności od tego, co jest ustawione w opcjach. O ile funkcja automatycznego przesuwania nie jest wyłączona, po otwarciu okna informacyjnego mapa przesuwa się, aby była widoczna. Po zbudowaniu obiektu InfoWindow musisz go wywołać, by wyświetlić go na mapie. Użytkownik może kliknąć ten przycisk w oknie InfoWindow, aby usunąć go z mapy, lub pozwolić deweloperowi na wywołanie tego działania.
close
close()
Parametry: brak
Zwracana wartość: brak
Zamyka to okno informacyjne, usuwając je ze struktury DOM.
focus
focus()
Parametry: brak
Zwracana wartość: brak
Skupia się na tym elemencie (InfoWindow). Zanim ustawisz ostrość na InfoWindow, możesz wykorzystać tę metodę wraz ze zdarzeniem visible. Niewidoczne jest pole InfoWindow, które nie jest widoczne.
getContent
getContent()
Parametry: brak
Zwracana wartość:  string|Element|Text|null|undefined zawartość tego okna informacyjnego. Są takie same jak wcześniej ustawione jako treści.
getPosition
getPosition()
Parametry: brak
Zwracana wartość:  LatLng|null|undefined Długość geograficzna tego elementu InfoWindow.
getZIndex
getZIndex()
Parametry: brak
Wartość zwrócona:  number Kolejność nakładania elementów tego okna informacyjnego.
open
open([options, anchor])
Parametry: 
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional Obiekt InfoWindowOpenOptions (zalecane) lub mapa|panorama, na której jest renderowane to okno InfoWindow.
  • anchorMVCObject|AdvancedMarkerElement optional kotwica, w której zostanie umieszczony ten element InfoWindow. Jeśli kotwica nie ma wartości null, element InfoWindow zostanie umieszczony na środku u góry kotwicy. Okno informacyjne będzie wyświetlane na tej samej mapie lub w tym samym panoramie co kotwica (jeśli jest dostępna).
Zwracana wartość: brak
Otwiera to okno informacyjne na podanej mapie. Opcjonalnie obiekt InfoWindow może być powiązany z kotwicą. W głównym interfejsie API jedyną kotwicą jest klasa Marker. Kotwica może być jednak dowolnym obiektem MVCObject, który udostępnia właściwość LatLng position, a opcjonalnie właściwość Point anchorPoint w celu obliczenia właściwości pixelOffset (patrz informacje w oknie InfoWindowOptions). anchorPoint to przesunięcie od pozycji kotwicy do końcówki okna informacyjnego. Zalecamy używanie interfejsu InfoWindowOpenOptions jako pojedynczego argumentu tej metody. Aby zapobiec zmianie ostrości przeglądarki podczas otwierania, ustaw InfoWindowOpenOptions.shouldFocus na false.
setContent
setContent([content])
Parametry: 
  • contentstring|Element|Text optional zawartość, która ma być wyświetlana przez to okno informacyjne.
Zwracana wartość: brak
setOptions
setOptions([options])
Parametry: 
Zwracana wartość: brak
setPosition
setPosition([position])
Parametry: 
  • positionLatLng|LatLngLiteral optional Długość i szerokość geograficzna miejsca wyświetlania tego okna informacyjnego.
Zwracana wartość: brak
setZIndex
setZIndex(zIndex)
Parametry: 
  • zIndexnumber kolejność nakładania elementów dla tego elementu InfoWindow. Okno informacyjne, które ma wyższą wartość kolejności nakładania, będzie wyświetlane przed wszystkimi innymi oknami informacyjnymi.
Zwracana wartość: brak
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function()
Argumenty: brak
To zdarzenie jest wywoływane po kliknięciu przycisku zamknięcia.
content_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości treści.
domready
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy <div> zawiera treść elementu InfoWindow do elementu DOM. Możesz je monitorować, jeśli dynamicznie tworzysz zawartość okna informacyjnego.
position_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości pozycji.
visible
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy element InfoWindow jest w pełni widoczny. To zdarzenie nie jest wywoływane, gdy panel InfoWindow zostanie przesunięty i wyświetlony z powrotem na ekranie.
zindex_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie parametru zindex elementu InfoWindow.

Interfejs InfoWindowOptions

google.maps.InfoWindowOptions interfejs

Obiekt InfoWindowOptions używany do definiowania właściwości, które można ustawić w obiektie InfoWindow.

ariaLabel optional
Typ:  string optional
AriaLabel do przypisania do InfoInfo.
content optional
Typ:  string|Element|Text optional
Zawartość do wyświetlenia w oknie informacyjnym. Może to być element HTML, ciąg tekstowy lub ciąg HTML. Rozmiar okna informacyjnego zostanie dopasowany do zawartości. Aby ustawić jawny rozmiar treści, ustaw element jako element HTML o tym rozmiarze.
disableAutoPan optional
Typ:  boolean optional
Domyślne: false
Wyłącz przesuwanie mapy, aby okno informacyjne było w pełni widoczne po jej otwarciu.
maxWidth optional
Typ:  number optional
Maksymalna szerokość InfoInfo niezależnie od szerokości treści. Ta wartość jest uwzględniana tylko wtedy, gdy jest ustawiona przed wywołaniem funkcji open(). Aby zmienić maksymalną szerokość podczas zmieniania treści, wywołaj elementy close(), setOptions(), a następnie open().
minWidth optional
Typ:  number optional
Minimalna szerokość elementu InfoWindow niezależnie od szerokości treści. Podczas korzystania z tej właściwości zdecydowanie zalecamy ustawienie w polu minWidth wartości mniejszej niż szerokość mapy (w pikselach). Ta wartość jest uwzględniana tylko wtedy, gdy jest ustawiona przed wywołaniem funkcji open(). Aby zmienić minimalną szerokość podczas zmiany treści, wywołaj elementy close(), setOptions(), a następnie open().
pixelOffset optional
Typ:  Size optional
Odsunięcie (w pikselach) od czubka okna informacyjnego od punktu na mapie, którego współrzędne geograficzne są zakotwiczone. Jeśli okno informacyjne jest otwarte za pomocą kotwicy, wartość pixelOffset zostanie obliczona na podstawie jej właściwości anchorPoint.
position optional
Typ:  LatLng|LatLngLiteral optional
Długość geograficzna miejsca wyświetlania tego okna informacyjnego. Jeśli okno informacyjne zostanie otwarte z kotwicą, zostanie użyta pozycja kotwicy.
zIndex optional
Typ:  number optional
Wszystkie obiekty InfoWindows są wyświetlane na mapie w kolejności ich kolejności nakładania elementów, przy czym wyższe wartości pojawiają się przed obiektem InfoWindows, a niższe. Domyślnie obiekty InfoWindows wyświetlają się z uwzględnieniem szerokości geograficznej – z niższymi szerokościami InfoDisplay na niższych szerokościach geograficznych. Obiekty InfoWindows są zawsze wyświetlane przed znacznikami.

Interfejs InfoWindowOpenOptions

google.maps.InfoWindowOpenOptions interfejs

Opcje otwierania okna informacyjnego

anchor optional
Kotwica, w której znajdzie się to okno informacyjne. Jeśli kotwica nie ma wartości null, element InfoWindow zostanie umieszczony na środku u góry kotwicy. Okno informacyjne będzie wyświetlane na tej samej mapie lub w tym samym panoramie co kotwica (jeśli jest dostępna).
map optional
Typ:  Map|StreetViewPanorama optional
Mapa lub panorama, na której ma być renderowane to okno informacyjne.
shouldFocus optional
Typ:  boolean optional
Określa, czy fokus ma zostać przeniesiony do obiektu InfoWindow po jego otwarciu. Gdy ta właściwość jest nieskonfigurowana lub ma wartość null lub undefined, do rozpoznania, czy nie ma zostać przeniesione wyróżnienie, używany jest heurystyka. Zalecane jest dokładne określenie tej właściwości zgodnie z potrzebami, ponieważ dane heurystyczne mogą się zmieniać i mogą nie działać dobrze we wszystkich przypadkach użycia.