Info Window

klasa InfoWindow

google.maps.InfoWindow zajęcia

Nakładka przypominająca dymek i często połączona ze znacznikiem.

Ta klasa rozszerza zakres MVCObject.

Uzyskaj 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 konkretnej 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, okno InfoWindow przesuwa mapę, by po jej otwarciu była widoczna. Po utworzeniu okna informacyjnego należy wywołać okno, aby je wyświetlić na mapie. Użytkownik może kliknąć przycisk zamykania w oknie InfoWindow, by usunąć je z mapy, lub uzyskać ten sam efekt z użyciem metody close().
isOpen
Typ:  boolean
Sprawdza, czy okno InfoWindow jest otwarte.
close
close()
Parametry: brak
Zwracana wartość: brak
Zamyka to okno InfoWindow przez usunięcie go ze struktury DOM.
focus
focus()
Parametry: brak
Zwracana wartość: brak
Ustawia fokus na: InfoWindow. Możesz skorzystać z tej metody razem ze zdarzeniem visible, aby mieć pewność, że element InfoWindow jest widoczny, zanim aktywujesz jego działanie. Nie można zaznaczyć pola InfoWindow, które jest niewidoczne.
getContent
getContent()
Parametry: brak
Zwracana wartość:  string|Element|Text|null|undefined zawartość tego okna informacyjnego. Taki sam jak wcześniej ustawiony.
getHeaderContent
getHeaderContent()
Parametry: brak
Zwracana wartość:  string|Element|Text|null|undefined zawartość nagłówka tego okna informacyjnego. Zobacz InfoWindowOptions.headerContent.
getHeaderDisabled
getHeaderDisabled()
Parametry: brak
Zwracana wartość:  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 położenia geograficznego tego okna informacyjnego.
getZIndex
getZIndex()
Parametry: brak
Zwracana wartość:  number wartość zIndex tego okna informacyjnego.
open
open([options, anchor])
Parametry: 
  • options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional obiekt InfoWindowOpenOptions (zalecane) lub mapa|panorama do renderowania tego okna InfoWindow.
  • anchor:  MVCObject|AdvancedMarkerElement optional kotwica, do której zostanie umieszczone okno InfoWindow. Jeśli kotwica ma wartość inną niż null, okno InfoWindow będzie umieszczone na środku u góry reklamy. Okno InfoWindow będzie renderowane na tej samej mapie lub w tej samej panoramie co reklama zakotwiczona (jeśli jest dostępna).
Zwracana wartość: brak
Otwiera to okno informacyjne na danej mapie. Opcjonalnie okno InfoWindow można powiązać z kotwicą. W podstawowym interfejsie API jedyną kotwicą jest klasa Mark. Kotwica może być jednak dowolny obiekt MVCObject, który udostępnia właściwość LatLng position, i opcjonalnie właściwość Point anchorPoint do obliczania wartości pixelOffset (patrz InfoWindowOptions). anchorPoint to odsunięcie od pozycji kotwicy do wierzchołka okna informacyjnego. Zaleca się używanie interfejsu InfoWindowOpenOptions jako pojedynczego argumentu tej metody. Aby nie zmieniać zaznaczenia w przeglądarce na otwartą, ustaw 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 położenie geograficzne, w którym ma zostać wyświetlone okno informacyjne.
Zwracana wartość: brak
setZIndex
setZIndex(zIndex)
Parametry: 
  • zIndex:  number kolejność nakładania elementów dla tego okna informacyjnego. Okno informacyjne o wyższym z-indeksie będzie wyświetlane przed wszystkimi innymi oknami InfoWindows o niższej wartości z-index.
Zwracana wartość: brak
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
Argumenty: brak
To zdarzenie jest wywoływane przy każdym zamknięciu InfoWindow. 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 zamykania.
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 do DOM jest dołączony element <div> zawierający treści elementu InfoWindow. Monitorowanie tego zdarzenia może być przydatne, jeśli zawartość swojego okna informacyjnego jest tworzona dynamicznie.
headercontent_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości headerContent.
headerdisabled_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie właściwości nagłówekDisabled.
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 zdarzenie InfoWindow jest w pełni widoczne. To zdarzenie nie jest wywoływane, gdy element InfoWindow zostanie przesunięty, a następnie z powrotem na ekran.
zindex_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane po zmianie parametru zIndex komponentu InfoWindow.

Interfejs InfoWindowOptions

Interfejs google.maps.InfoWindowOptions

Obiekt InfoWindowOptions używany do definiowania właściwości, które można ustawić w InfoWindow.
ariaLabel optional
Typ:  string optional
AriaLabel, która ma zostać przypisana do okna informacyjnego.
content optional
Typ:  string|Element|Text optional
Zawartość do wyświetlenia w oknie informacyjnym. Może to być element HTML, zwykły tekst lub ciąg tekstowy zawierający kod HTML. Rozmiar okna InfoWindow zostanie dopasowany do zawartości. Aby ustawić konkretny rozmiar treści, ustaw treść jako element HTML o tym rozmiarze.
disableAutoPan optional
Typ:  boolean optional
Wartość domyślna: false
Wyłącz przesuwanie mapy, aby okno informacyjne było w pełni widoczne po otwarciu.
headerContent optional
Typ:  string|Element|Text optional
Zawartość do wyświetlenia w wierszu nagłówka InfoWindow. Może to być element HTML lub ciąg zwykłego tekstu. Rozmiar okna InfoWindow zostanie dopasowany do zawartości. Aby ustawić wyraźny rozmiar treści nagłówka, ustaw nagłówekHeaderContent jako element HTML o tym rozmiarze.
headerDisabled optional
Typ:  boolean optional
Wyłącza cały wiersz nagłówka w oknie InfoWindow. Jeśli zasada ma wartość Prawda, nagłówek jest usuwany, przez co zawartość nagłówka i przycisk zamykania są ukryte.
maxWidth optional
Typ:  number optional
Maksymalna szerokość okna InfoWindow niezależnie od szerokości treści. Ta wartość jest uwzględniana tylko wtedy, gdy została ustawiona przed wywołaniem funkcji open(). Aby zmienić maksymalną szerokość przy zmianie treści, wywołaj close(), setOptions(), a następnie open().
minWidth optional
Typ:  number optional
Minimalna szerokość okna informacyjnego niezależnie od szerokości zawartości. Podczas korzystania z tej właściwości zdecydowanie zalecamy ustawienie minWidth na wartość mniejszą niż szerokość mapy (w pikselach). Ta wartość jest uwzględniana tylko wtedy, gdy została ustawiona przed wywołaniem funkcji open(). Aby zmienić minimalną szerokość przy zmianie treści, wywołaj close(), setOptions(), a następnie open().
pixelOffset optional
Typ:  Size optional
Odsunięcie wierzchołka okna informacyjnego (w pikselach) od punktu na mapie, na którym zakotwiczone jest okno informacyjne. Jeśli okno InfoWindow jest otwierane za pomocą reklamy zakotwiczonej, wartość pixelOffset jest obliczana na podstawie właściwości anchorPoint kotwicy.
position optional
Typ:  LatLng|LatLngLiteral optional
Szerokość geograficzna, dla której ma zostać wyświetlone to okno informacyjne. Jeśli okno informacyjne jest otwierane za pomocą reklamy zakotwiczonej, używana jest pozycja kotwicy.
zIndex optional
Typ:  number optional
Wszystkie elementy InfoWindows są wyświetlane na mapie w kolejności według zIndex. wyższe wartości są wyświetlane przed panelem InfoWindows, a niższe. Domyślnie panele InfoWindows są wyświetlane zgodnie z szerokością geograficzną, przy czym informacje InfoWindows są wyświetlane przed panelami InfoWindows na wyższych szerokościach. Okna InfoWindows są zawsze wyświetlane przed znacznikami.

Interfejs InfoWindowOpenOptions

Interfejs google.maps.InfoWindowOpenOptions

Opcje otwierania okna informacyjnego
anchor optional
Kotwica, do której zostanie umieszczone okno informacyjne. Jeśli kotwica ma wartość inną niż null, okno InfoWindow będzie umieszczone na środku u góry reklamy. Okno InfoWindow będzie renderowane na tej samej mapie lub w tej samej panoramie co reklama zakotwiczona (jeśli jest dostępna).
map optional
Typ:  Map|StreetViewPanorama optional
Mapa lub panorama, na której ma zostać wyrenderowane to okno InfoWindow.
shouldFocus optional
Typ:  boolean optional
Określa, czy zaznaczenie ma zostać przeniesione w oknie InfoWindow, gdy jest otwarte. Gdy właściwość jest nieskonfigurowana lub ma wartość null lub undefined, do ustalenia, czy przenieść zaznaczenie, używana jest heurystyka. Zalecamy wyraźne ustawienie tej właściwości zgodnie ze swoimi potrzebami, ponieważ heurystyka może się zmieniać i może nie działać dobrze w niektórych przypadkach użycia.