Info Window

InfoWindow class

google.maps.InfoWindow class

Nakładka wyglądająca jak bańka i często połączona z rysunkiem.

Te zajęcia trwają MVCObject.

Dostęp przez połączenie telefoniczne const {InfoWindow} = await google.maps.importLibrary("maps") lub const {InfoWindow} = await google.maps.importLibrary("streetView"). Zobacz Biblioteki w Maps JavaScript API.
InfoWindow
InfoWindow([opts])
Parametry: 
Tworzy okno informacyjne z podanymi opcjami. Okno informacyjne może być umieszczone na mapie w konkretnym miejscu lub nad znacznikiem, w zależności od tego, co jest określone w opcjach. Jeśli automatyczne przesuwanie mapy nie jest wyłączone, po otwarciu okna InfoWindow mapa przesunie się, aby stało się widoczne. Po utworzeniu okna informacyjnego musisz wywołać open, aby wyświetlić je na mapie. Użytkownik może kliknąć przycisk Zamknij w oknie informacyjnym, aby usunąć je z mapy, lub deweloper może wywołać metodę close().
isOpen
Typ:  boolean
Sprawdza, czy okno informacyjne jest otwarte.
close
close()
Parametry: brak
Zwracana wartość:  brak
Zamyka to okno informacyjne, usuwając je ze struktury DOM.
focus
focus()
Parametry: brak
Zwracana wartość:  brak
Ustawia ostrość na tym InfoWindow. Możesz użyć tej metody razem ze zdarzeniem visible, aby mieć pewność, że element InfoWindow jest widoczny, zanim ustawisz na nim fokus. InfoWindow, który jest niewidoczny, nie może być zaznaczony.
getContent
getContent()
Parametry: brak
Zwracana wartość:  string|Element|Text|null|undefined zawartość tego okna informacyjnego. To samo, co zostało wcześniej ustawione jako treść.
getHeaderContent
getHeaderContent()
Parametry: brak
Zwracana wartość:  string|Element|Text|null|undefined zawartość nagłówka tego okna informacyjnego. Zobacz InfoWindowOptions.headerContent.
getHeaderDisabled
getHeaderDisabled()
Parametry: brak
Wartość zwracana:  boolean|undefined określa, czy cały wiersz nagłówka jest wyłączony. Zobacz InfoWindowOptions.headerDisabled.
getPosition
getPosition()
Parametry: brak
Zwracana wartość:  LatLng|null|undefined Pozycja LatLng tego okna informacyjnego.
getZIndex
getZIndex()
Parametry: brak
Zwracana wartość:  number Z-index okna informacyjnego.
open
open([options, anchor])
Parametry: 
  • options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional Obiekt InfoWindowOpenOptions (zalecany) lub map|panorama, na której ma być wyświetlone okno informacji.
  • anchor:  MVCObject|AdvancedMarkerElement optional Kotwica, na której będzie umieszczone okno informacyjne. Jeśli element anchor jest niepusty, okno informacyjne zostanie umieszczone w środku u góry elementu. Okno informacyjne zostanie wyrenderowane na tej samej mapie lub panoramie co element kotwiczący (jeśli jest dostępny).
Zwracana wartość:  brak
Otwiera to okno informacyjne na danej mapie. Opcjonalnie można powiązać InfoWindow z ankrą. W interfejsie API podstawowej jedyną kotwicą jest klasa Marker. Jednak kotwicą może być dowolny obiekt MVC, który udostępnia właściwość LatLng position i opcjonalnie właściwość Punkt anchorPoint do obliczania pixelOffset (patrz InfoWindowOptions). Wartość anchorPoint to przesunięcie od pozycji kotwicy do wierzchołka okna z informacjami. Zalecamy użycie interfejsu InfoWindowOpenOptions jako jedynego argumentu tej metody. Aby zapobiec zmianie punktu skupienia w otwartej przeglądarce, ustaw wartość InfoWindowOpenOptions.shouldFocus na false.
setContent
setContent([content])
Parametry: 
  • content:  string|Element|Text optional Treść, która ma być wyświetlana przez to okno informacyjne.
Zwracana wartość:  brak
setHeaderContent
setHeaderContent([headerContent])
Parametry: 
Zwracana wartość:  brak
setHeaderDisabled
setHeaderDisabled([headerDisabled])
Parametry: 
Zwracana wartość:  brak
setOptions
setOptions([options])
Parametry: 
Zwracana wartość:  brak
setPosition
setPosition([position])
Parametry: 
  • position:  LatLng|LatLngLiteral optional współrzędne LatLng, na których ma być wyświetlane to okno informacyjne.
Zwracana wartość:  brak
setZIndex
setZIndex(zIndex)
Parametry: 
  • zIndex:  number indeks z tego okna informacyjnego. Okno informacyjne o większej wartości wskaźnika z-index będzie wyświetlane przed wszystkimi innymi oknami o mniejszej wartości tego wskaźnika.
Zwracana wartość:  brak
Uzyskane: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy InfoWindow się zamyka. Może to być wywołanie metody InfoWindow.close, naciśnięcie klawisza Escape w celu zamknięcia okna InfoWindow lub kliknięcie przycisku Zamknij albo przeniesienie okna InfoWindow na inną mapę.
closeclick
function()
Argumenty: brak.
To zdarzenie jest wywoływane po kliknięciu przycisku Zamknij.
content_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się właściwość content.
domready
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy element <div> zawierający zawartość elementu InfoWindow jest dołączany do DOM. Jeśli treści okna informacyjnego są tworzone dynamicznie, możesz chcieć monitorować to zdarzenie.
headercontent_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się właściwość headerContent.
headerdisabled_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się właściwość headerDisabled.
position_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się właściwość position.
visible
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy InfoWindow jest w pełni widoczne. To zdarzenie nie jest wywoływane, gdy element InfoWindow zniknie z ekranu, a potem znów się na nim pojawi.
zindex_changed
function()
Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmienia się z-indeks elementu InfoWindow.

InfoWindowOptions (interfejs)

google.maps.InfoWindowOptionsinterfejs

Obiekt InfoWindowOptions służy do definiowania właściwości, które można ustawić w InfoWindow.
ariaLabel optional
Typ:  string optional
AriaLabel do przypisania do okna informacyjnego.
content optional
Typ:  string|Element|Text optional
Treści do wyświetlenia w oknie informacyjnym. Może to być element HTML, ciągły tekst lub ciąg znaków zawierający kod HTML. Okno z informacjami będzie dopasowywane do zawartości. Aby ustawić dokładny rozmiar treści, ustaw go jako element HTML.
disableAutoPan optional
Typ:  boolean optional
Domyślnie: false
Wyłącz przesuwanie mapy, aby okno informacyjne było w pełni widoczne po otwarciu.
headerContent optional
Typ:  string|Element|Text optional
Treść do wyświetlenia w wierszu nagłówka okna informacyjnego. Może to być element HTML lub ciągły tekst. Okno z informacjami będzie dopasowywane do zawartości. Aby ustawić dokładny rozmiar zawartości nagłówka, ustaw element HTML o takim rozmiarze.
headerDisabled optional
Typ:  boolean optional
Wyłącza cały wiersz nagłówka w oknie InfoWindow. Jeśli ustawisz to pole na wartość true, nagłówek zostanie usunięty, a zawartość nagłówka i przycisk Zamknij staną się niewidoczne.
maxWidth optional
Typ:  number optional
Maksymalna szerokość okna informacyjnego niezależnie od szerokości treści. Ta wartość jest brana pod uwagę tylko wtedy, gdy jest ustawiona przed wywołaniem funkcji open(). Aby zmienić maksymalną szerokość podczas zmiany treści, wywołaj kolejno funkcje close(), setOptions() i open().
minWidth optional
Typ:  number optional
Minimalna szerokość okna informacyjnego niezależnie od szerokości treści. Podczas korzystania z tej właściwości zdecydowanie zalecamy ustawienie wartości minWidth na mniejszą niż szerokość mapy (w pikselach). Ta wartość jest brana pod uwagę tylko wtedy, gdy jest ustawiona przed wywołaniem funkcji open(). Aby zmienić minimalną szerokość podczas zmiany treści, wywołaj kolejno funkcje close(), setOptions() i open().
pixelOffset optional
Typ:  Size optional
Odsunięcie (w pikselach) wierzchołka okna informacji od punktu na mapie, w którym osadzone jest okno informacji. Jeśli okno informacyjne zostanie otwarte za pomocą kotwicy, wartość pixelOffset zostanie obliczona na podstawie właściwości anchorPoint tej kotwicy.
position optional
Typ:  LatLng|LatLngLiteral optional
współrzędne LatLng, na których ma być wyświetlane okno z informacjami; Jeśli okno informacyjne zostanie otwarte za pomocą kotwicy, zamiast tego zostanie użyta pozycja kotwicy.
zIndex optional
Typ:  number optional
Wszystkie okna informacyjne są wyświetlane na mapie w kolejności zIndex, przy czym okna o większych wartościach są wyświetlane przed oknami o mniejszych wartościach. Domyślnie okna informacyjne są wyświetlane zgodnie z ich szerokością geograficzną, przy czym okna o niższej szerokości geograficznej pojawiają się przed oknami o wyższej szerokości geograficznej. Okna informacyjne są zawsze wyświetlane przed znacznikami.

InfoWindowOpenOptions (interfejs)

google.maps.InfoWindowOpenOptionsinterfejs

Opcje otwierania okna z informacjami
anchor optional
Kotwica, do której zostanie przypięty element InfoWindow. Jeśli element anchor jest niepusty, okno informacyjne zostanie umieszczone w środku u góry elementu. Okno informacyjne zostanie wyrenderowane na tej samej mapie lub panoramie co element kotwiczący (jeśli jest dostępny).
map optional
Typ:  Map|StreetViewPanorama optional
Mapa lub panorama, na której ma być renderowany ten element InfoWindow.
shouldFocus optional
Typ:  boolean optional
Określa, czy po otwarciu okna InfoWindow fokus powinien się przesunąć do środka. Jeśli ta właściwość nie jest skonfigurowana lub ma wartość null lub undefined, do podejmowania decyzji o przenoszeniu punktu skupienia używana jest heurystyka. Zalecamy jawne ustawienie tej właściwości zgodnie z Twoimi potrzebami, ponieważ heurystyka może ulec zmianie i nie działać dobrze w każdym przypadku użycia.