Info Window

Klasa InfoWindow

google.maps.InfoWindow zajęcia

Nakładka, która wygląda jak dymek i jest często połączona ze znacznikiem.

Ta klasa rozszerza klasę MVCObject.

Dostęp przez połączenie z numerem 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żna umieścić na mapie w określonym miejscu lub nad znacznikiem, w zależności od tego, co zostało określone w opcjach. Jeśli automatyczne przesuwanie nie jest wyłączone, po otwarciu okna informacyjnego mapa zostanie przesunięta, aby było ono widoczne. Po utworzeniu obiektu InfoWindow musisz wywołać metodę open, aby wyświetlić go na mapie. Użytkownik może kliknąć przycisk zamykania w oknie informacyjnym, aby usunąć je z mapy. Deweloper może też wywołać funkcję close(), aby uzyskać ten sam efekt.
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 wraz ze zdarzeniem visible, aby mieć pewność, że element InfoWindow jest widoczny przed ustawieniem na nim fokusu. Nie można ustawić ostrości na InfoWindow, który jest niewidoczny.
getContent
getContent()
Parametry: brak
Zwracana wartość:  string|Element|Text|null|undefined zawartość tego okna informacyjnego. Takie same jak wcześniej ustawione treści.
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 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 kolejność nakładania tego okna informacyjnego.
open
open([options, anchor])
Parametry: 
  • options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional obiekt InfoWindowOpenOptions (zalecany) lub mapa/panorama, na której ma być renderowane to okno informacyjne.
  • anchor:  MVCObject|AdvancedMarkerElement optional punkt, względem którego zostanie umieszczone okno informacyjne. Jeśli kotwica nie ma wartości null, okno informacyjne zostanie umieszczone w górnej środkowej części kotwicy. Okno informacyjne będzie renderowane na tej samej mapie lub panoramie co punkt zakotwiczenia (jeśli jest dostępny).
Zwracana wartość: brak
Otwiera to okno informacyjne na danej mapie. Opcjonalnie z punktem zakotwiczenia można powiązać okno informacyjne. W podstawowym interfejsie API jedynym elementem zakotwiczenia jest klasa Marker. Punkt zakotwiczenia może być jednak dowolnym obiektem MVCObject, który udostępnia właściwość LatLng position i opcjonalnie właściwość Point anchorPoint do obliczania wartości pixelOffset (patrz InfoWindowOptions). Wartość anchorPoint to przesunięcie od pozycji punktu zakotwiczenia do wierzchołka okna informacyjnego. Zalecamy używanie interfejsu InfoWindowOpenOptions jako pojedynczego argumentu tej metody. Aby zapobiec zmianie fokusu przeglądarki po otwarciu, ustaw wartość InfoWindowOpenOptions.shouldFocus na false.
setContent
setContent([content])
Parametry: 
  • content:  string|Element|Text optional treść, która ma być wyświetlana w tym okienku informacyjnym.
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 pozycja LatLng, w której ma się wyświetlać to okno informacyjne.
Zwracana wartość: brak
setZIndex
setZIndex(zIndex)
Parametry: 
  • zIndex:  number indeks z dla tego okna informacyjnego. Okno informacyjne o większej wartości z-index będzie wyświetlane przed wszystkimi innymi oknami informacyjnymi o mniejszej wartości z-index.
Zwracana wartość: brak
Odziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
Argumenty: brak
To zdarzenie jest wywoływane za każdym razem, gdy InfoWindow zostanie zamknięte. Może to być na przykład wywołanie metody InfoWindow.close, naciśnięcie klawisza Escape w celu zamknięcia okna informacyjnego lub kliknięcie przycisku zamykania albo przeniesienie okna informacyjnego na inną mapę.
closeclick
function()
Argumenty: brak
To zdarzenie jest wywoływane po kliknięciu przycisku zamykania.
content_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość treści.
domready
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy element <div> zawierający treść elementu InfoWindow jest dołączany do DOM. Możesz monitorować to zdarzenie, jeśli dynamicznie tworzysz zawartość okna informacyjnego.
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 element InfoWindow jest w pełni widoczny. To zdarzenie nie jest wywoływane, gdy InfoWindow zostanie przesunięty poza ekran, a następnie z powrotem na ekran.
zindex_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się wartość zIndex elementu InfoWindow.

InfoWindowOptions interfejs

google.maps.InfoWindowOptionsinterfejs

Obiekt InfoWindowOptions służący do określania właściwości, które można ustawić w obiekcie InfoWindow.
ariaLabel optional
Typ:  string optional
Etykieta AriaLabel do przypisania do okna informacyjnego.
content optional
Typ:  string|Element|Text optional
Treść do wyświetlenia w oknie informacyjnym. Może to być element HTML, ciąg tekstowy lub ciąg zawierający HTML. Rozmiar okna informacyjnego zostanie dopasowany do treści. Aby ustawić konkretny rozmiar treści, ustaw treść jako element HTML o tym rozmiarze.
disableAutoPan optional
Typ:  boolean optional
Domyślnie: false
Wyłącz przesuwanie mapy, aby po otwarciu okna informacyjnego było ono w pełni widoczne.
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 zwykłego tekstu. Rozmiar okna informacyjnego zostanie dopasowany do treści. Aby ustawić konkretny rozmiar treści nagłówka, ustaw headerContent jako element HTML o tym rozmiarze.
headerDisabled optional
Typ:  boolean optional
Wyłącza cały wiersz nagłówka w oknie informacyjnym. Jeśli ma wartość true, nagłówek zostanie usunięty, a treść nagłówka i przycisk zamykania będą ukryte.
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 wartość 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 informacyjnego od punktu na mapie, do którego współrzędnych geograficznych jest ono przypisane. Jeśli okno informacyjne zostanie otwarte z kotwicą, wartość pixelOffset zostanie obliczona na podstawie właściwości anchorPoint kotwicy.
position optional
Typ:  LatLng|LatLngLiteral optional
Wartość LatLng, w której ma się wyświetlać ten obiekt InfoWindow. Jeśli okno informacyjne jest otwierane za pomocą kotwicy, zamiast tego używana jest pozycja kotwicy.
zIndex optional
Typ:  number optional
Wszystkie okna informacyjne są wyświetlane na mapie w kolejności określonej przez parametr zIndex. Okna o wyższych wartościach są wyświetlane przed oknami o niższych wartościach. Domyślnie okna informacyjne są wyświetlane zgodnie z szerokością geograficzną. Okna informacyjne o mniejszej szerokości geograficznej pojawiają się przed oknami informacyjnymi o większej szerokości geograficznej. Okna informacyjne są zawsze wyświetlane przed znacznikami.

InfoWindowOpenOptions interfejs

google.maps.InfoWindowOpenOptionsinterfejs

Opcje otwierania okna informacyjnego
anchor optional
Punkt, względem którego zostanie umieszczone okno informacyjne. Jeśli kotwica nie ma wartości null, okno informacyjne zostanie umieszczone w górnej środkowej części kotwicy. Okno informacyjne będzie renderowane na tej samej mapie lub panoramie co punkt zakotwiczenia (jeśli jest dostępny).
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 po otwarciu okna informacyjnego należy przenieść do niego fokus. Gdy ta właściwość jest nieskonfigurowana lub ma wartość null lub undefined, do określenia, czy należy przenieść fokus, używana jest heurystyka. Zalecamy wyraźne ustawienie tej właściwości zgodnie z Twoimi potrzebami, ponieważ heurystyka może ulec zmianie i nie musi działać dobrze we wszystkich przypadkach użycia.