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.
Zespół | |
---|---|
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. |
Metody | |
---|---|
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
|
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:
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:
Zwracana wartość: brak
|
setOptions |
setOptions([options]) Parametry:
Zwracana wartość: brak
|
setPosition |
setPosition([position]) Parametry:
Zwracana wartość: brak
|
setZIndex |
setZIndex(zIndex) Parametry:
Zwracana wartość: brak
|
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Zdarzenia | |
---|---|
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.
Właściwości | |
---|---|
ariaLabel optional |
Typ:
string optional AriaLabel do przypisania do InfoInfo. |
content 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
Właściwości | |
---|---|
anchor optional |
Typ:
MVCObject|AdvancedMarkerElement 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. |