Info Window

Klasa InfoWindow

google.maps.InfoWindow class
extends MVCObject
library "maps", "streetView"

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

const {InfoWindow} = await google.maps.importLibrary("maps");
 lub 
const {InfoWindow} = await google.maps.importLibrary("streetView");
InfoWindow
InfoWindow([opts])
Parametry:
Tworzy okno informacyjne z podanymi opcjami. Okno informacyjne można umieścić na mapie w określonej pozycji 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 okno było widoczne. Po utworzeniu obiektu InfoWindow musisz wywołać metodę open, aby wyświetlić go na mapie. Użytkownik może kliknąć przycisk zamknięcia w oknie informacyjnym, aby usunąć je z mapy. Deweloper może też wywołać funkcję close(), aby uzyskać ten sam efekt.
isOpen
readonly
Typ: boolean
Sprawdza, czy okno informacyjne jest otwarte.
close
close()
Parametry: brak
Zwracana wartość: brak
Zamyka to okno InfoWindow, usuwając je ze struktury DOM.
focus
focus()
Parametry: brak
Zwracana wartość: brak
Ustawia zaznaczenie na tym elemencie: InfoWindow. Możesz rozważyć użycie tej metody wraz ze zdarzeniem visible, aby upewnić się, że element InfoWindow jest widoczny, zanim zostanie zaznaczony. Nie można ustawić fokusu na niewidocznym elemencie InfoWindow.
getContent
getContent()
Parametry: brak
Zwracana wartość: string|Element|Text|null|undefined Zawartość tego okna informacyjnego. Taka sama jak wcześniej ustawiona treść.
getHeaderContent
getHeaderContent()
Parametry: brak
Wartość zwracana: string|Element|Text|null|undefined Treść nagłówka tego okna informacyjnego. Zobacz: InfoWindowOptions.headerContent.
getHeaderDisabled
getHeaderDisabled()
Parametry: brak
Zwracana wartość: boolean|undefined informacja o tym, 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 zIndex 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 Kotwica, do której będzie pozycjonowane to okno informacyjne. Jeśli kotwica nie ma wartości null, okno informacyjne zostanie umieszczone w górnej środkowej części kotwicy. Okno informacyjne zostanie wyrenderowane na tej samej mapie lub panoramie co kotwica (jeśli jest dostępna).
Zwracana wartość: brak
Otwiera to okno informacyjne na danej mapie. Opcjonalnie obiekt InfoWindow można powiązać z kotwicą. W podstawowym interfejsie API jedyną klasą kotwicy jest klasa Marker. Jednak kotwicą może być dowolny obiekt MVCObject, który udostępnia właściwość LatLng position i opcjonalnie właściwość Point anchorPoint do obliczania pixelOffset (patrz InfoWindowOptions). anchorPoint to przesunięcie od pozycji kotwicy do końcówki okna informacyjnego. Zalecamy użycie interfejsu InfoWindowOpenOptions jako jedynego argumentu tej metody. Aby zapobiec zmianie fokusu przeglądarki po otwarciu, ustaw zasadę InfoWindowOpenOptions.shouldFocus na false.
setContent
setContent([content])
Parametry:
  • content: string|Element|Text optional Treść, która ma być wyświetlana w tym oknie 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 być wyświetlane to okno informacyjne.
Zwracana wartość: brak
setZIndex
setZIndex(zIndex)
Parametry:
  • zIndex: number Indeks Z dla tego okna informacyjnego. Okno informacyjne z wyższym indeksem Z będzie wyświetlane przed wszystkimi innymi oknami informacyjnymi z niższym indeksem Z.
Zwracana wartość: brak
Dziedziczone: 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ęty. Może to być na przykład wywołanie metody InfoWindow.close, naciśnięcie klawisza Escape w celu zamknięcia okna informacyjnego, kliknięcie przycisku zamykania lub przeniesienie okna informacyjnego na inną mapę.
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, gdy zmienia się właściwość treści.
domready
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy element <div> zawierający treść InfoWindow jest dołączany do modelu 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ść 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 element InfoWindow jest przesuwany poza ekran, a potem z powrotem na ekran.
zindex_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się zIndex elementu InfoWindow.

Interfejs InfoWindowOptions

Interfejs google.maps.InfoWindowOptions

Obiekt InfoWindowOptions służący do definiowania właściwości, które można ustawić w obiekcie InfoWindow.
ariaLabel
opcjonalne
Typ: string optional
AriaLabel do przypisania do okna informacyjnego.
content
opcjonalne
Typ: string|Element|Text optional
Treść do wyświetlenia w oknie informacyjnym. Może to być element HTML, ciąg zwykłego tekstu lub ciąg zawierający kod HTML. Rozmiar okna informacyjnego będzie dostosowany do treści. Aby ustawić konkretny rozmiar treści, ustaw treść jako element HTML o tym rozmiarze.
disableAutoPan
opcjonalne
Typ: boolean optional
Domyślnie: false
Wyłącz przesuwanie mapy, aby po otwarciu okna informacyjnego było ono w pełni widoczne.
headerContent
opcjonalne
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 będzie dostosowany do treści. Aby ustawić konkretny rozmiar treści nagłówka, ustaw headerContent jako element HTML o tym rozmiarze.
headerDisabled
opcjonalne
Typ: boolean optional
Wyłącza cały wiersz nagłówka w oknie informacyjnym. Jeśli zasada ma wartość „true”, nagłówek zostanie usunięty, co spowoduje ukrycie jego zawartości i przycisku zamykania.
maxWidth
opcjonalne
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 close(), setOptions(), a następnie open().
minWidth
opcjonalne
Typ: number optional
Minimalna szerokość okna informacyjnego, niezależnie od szerokości treści. Jeśli używasz tej właściwości, zdecydowanie zalecamy ustawienie właściwoś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 close(), setOptions(), a następnie open().
pixelOffset
opcjonalne
Typ: Size optional
Przesunięcie (w pikselach) wierzchołka okna informacyjnego względem punktu na mapie, w którego współrzędnych geograficznych jest zakotwiczone okno informacyjne. Jeśli okno informacyjne zostanie otwarte z kotwicą, właściwość pixelOffset zostanie obliczona na podstawie właściwości anchorPoint kotwicy.
position
opcjonalne
Typ: LatLng|LatLngLiteral optional
Współrzędne LatLng, w których ma się wyświetlać to okno informacyjne. Jeśli okno informacyjne zostanie otwarte z kotwicą, zostanie użyta pozycja kotwicy.
zIndex
opcjonalne
Typ: number optional
Wszystkie okna informacyjne są wyświetlane na mapie w kolejności ich wartości zIndex, przy czym wyższe wartości są wyświetlane przed oknami informacyjnymi o niższych wartościach. Domyślnie okna informacyjne są wyświetlane zgodnie z ich szerokością geograficzną, przy czym okna o niższych szerokościach geograficznych pojawiają się przed oknami o wyższych szerokościach geograficznych. Okna informacyjne są zawsze wyświetlane przed znacznikami.

Interfejs InfoWindowOpenOptions

Interfejs google.maps.InfoWindowOpenOptions

Opcje otwierania okna informacyjnego
anchor
opcjonalne
Kotwica, do której będzie pozycjonowane to okno InfoWindow. Jeśli kotwica nie ma wartości null, okno informacyjne zostanie umieszczone w górnej środkowej części kotwicy. Okno informacyjne zostanie wyrenderowane na tej samej mapie lub panoramie co kotwica (jeśli jest dostępna).
map
opcjonalne
Typ: Map|StreetViewPanorama optional
Mapa lub panorama, na której ma zostać wyrenderowane to okno informacyjne.
shouldFocus
opcjonalne
Typ: boolean optional
Określa, czy po otwarciu okna informacyjnego należy przenieść do niego zaznaczenie. Gdy ta właściwość jest nieskonfigurowana lub ma wartość null albo undefined, do określenia, czy należy przenieść zaznaczenie, używana jest heurystyka. Zalecamy, aby ustawić tę właściwość zgodnie z potrzebami, ponieważ heurystyka może ulec zmianie i może nie działać dobrze we wszystkich przypadkach użycia.