Info Window

klasa InfoWindow

google.maps.InfoWindow zajęcia

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

Te zajęcia są rozszerzone na MVCObject.

Aby uzyskać dostęp, zadzwoń 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:  opts:  InfoWindowOptions optional Tworzy okno informacyjne z podanymi opcjami. Okno InfoWindow 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, okno InfoWindow przesuwa mapę, by była widoczna po jej otwarciu. Po utworzeniu okna informacyjnego musisz wywołać polecenie open, aby wyświetlić je na mapie. Użytkownik może kliknąć przycisk zamykania w oknie InfoWindow, by usunąć je z mapy, lub programista może użyć funkcji Close() w celu uzyskania tego samego efektu.

Metody
close	close() Parametry: brak Zwracana wartość: brak Zamyka to InfoWindow przez usunięcie go ze struktury DOM.
focus	focus() Parametry: brak Zwracana wartość: brak Uaktywnia fokus na tym elemencie: InfoWindow. Zastanów się nad użyciem tej metody razem ze zdarzeniem visible, aby przed ustawieniem zaznaczenia na mapie było widoczne pole InfoWindow. Nie można zaznaczyć niewidocznego elementu InfoWindow.
getContent	getContent() Parametry: brak Zwracana wartość:  string|Element|Text|null|undefined zawartość tego okna informacyjnego. Taka sama jak wcześniej ustawiona jako treść.
getPosition	getPosition() Parametry: brak Zwracana wartość:  LatLng|null|undefined położenie 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 (zalecany) lub mapa|panorama, na której ma być renderowane to okno InfoWindow. anchor:  MVCObject|AdvancedMarkerElement optional kotwica, w której zostanie umieszczone to okno informacyjne. Jeśli kotwica nie ma wartości null, okno informacyjne zostanie umieszczone w górnej środkowej części kotwicy. Okno InfoWindow będzie renderowane na tej samej mapie lub w panoramie co reklama zakotwiczona (jeśli będzie dostępna). Zwracana wartość: brak Otwiera okno InfoWindow na podanej mapie. Opcjonalnie okno InfoWindow może być powiązane z kotwicą. W podstawowym interfejsie API jedyną kotwicą jest klasa Marka. Kotwica 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 pixelOffset (zobacz InfoWindowOptions). anchorPoint to odsunięcie położenia kotwicy do końca okna informacyjnego. Zaleca się użycie interfejsu InfoWindowOpenOptions jako jednego argumentu tej metody. Aby zapobiec zmianie fokusu przeglądarki przy otwarciu, ustaw InfoWindowOpenOptions.shouldFocus na false.
setContent	setContent([content]) Parametry:  content:  string|Element|Text optional treść, która ma być wyświetlana w tym oknie InfoWindow. Zwracana wartość: brak
setOptions	setOptions([options]) Parametry:  options:  InfoWindowOptions optional Zwracana wartość: brak
setPosition	setPosition([position]) Parametry:  position:  LatLng|LatLngLiteral optional położenie geograficzne, w którym ma być wyświetlane okno informacyjne. Zwracana wartość: brak
setZIndex	setZIndex(zIndex) Parametry:  zIndex:  number kolejność nakładania elementów w oknie InfoWindow. Okno InfoWindow o większej wartości kolejności nakładania elementów będzie wyświetlane przed wszystkimi innymi systemami InfoWindows i o niższej wartości. Zwracana wartość: brak
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Wydarzenia
close	function() Argumenty: brak To zdarzenie jest uruchamiane 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 InfoWindow na inną mapę.
closeclick	function() Argumenty: brak Zdarzenie to 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 element <div> zawierający treść elementu InfoWindow jest dołączony do DOM. Jeśli treść okna informacyjnego jest tworzona dynamicznie, możesz monitorować to zdarzenie.
headercontent_changed	Uwaga: ta funkcja jest dostępna tylko w kanale v=beta. function() Argumenty: brak To zdarzenie jest wywoływane po zmianie właściwości headerContent.
headerdisabled_changed	Uwaga: ta funkcja jest dostępna tylko w kanale v=beta. function() Argumenty: brak To zdarzenie jest wywoływane po zmianie właściwości headerDisabled.
position_changed	function() Argumenty: brak To zdarzenie jest wywoływane po zmianie właściwości pozycji.
visible	function() Argumenty: brak To zdarzenie jest uruchamiane, gdy InfoWindow jest w pełni widoczny. To zdarzenie nie jest uruchamiane, gdy przesuniesz kamerę InfoWindow, a następnie ponownie pojawi się na ekranie.
zindex_changed	function() Argumenty: brak To zdarzenie jest wywoływane, gdy wartość zIndex zmieni się dla parametru InfoWindow.

Interfejs InfoWindowOptions

google.maps.InfoWindowOptions interfejs

Obiekt InfoWindowOptions używany do definiowania właściwości, które można ustawić w InfoWindow.

Właściwości
ariaLabel optional	Typ:  string optional AriaLabel do przypisania do InfoWindow.
content optional	Typ:  string|Element|Text optional Zawartość do wyświetlenia w oknie InfoWindow. Może to być element HTML, zwykły ciąg tekstowy lub ciąg tekstowy zawierający kod HTML. Rozmiar okna InfoWindow jest dostosowywany do treści. Aby ustawić jawny rozmiar treści, skonfiguruj ją jako element HTML o tym rozmiarze.
disableAutoPan optional	Typ:  boolean optional Wartość domyślna: false Wyłącz przesuwanie mapy, aby okno InfoWindow było w pełni widoczne po otwarciu.
headerContent optional	Uwaga: ta funkcja jest dostępna tylko w kanale v=beta. Typ:  string|Element|Text optional Zawartość do wyświetlenia w wierszu nagłówka InfoWindow. Może to być element HTML lub ciąg znaków zawierający kod HTML. Rozmiar okna InfoWindow jest dostosowywany do treści. Aby ustawić jawny rozmiar treści nagłówka, ustaw element headerContent jako element HTML o tym rozmiarze.
headerDisabled optional	Uwaga: ta funkcja jest dostępna tylko w kanale v=beta. Typ:  boolean optional Wyłącza cały wiersz nagłówka w oknie InfoWindow. Jeśli zasada ma wartość Prawda, nagłówek jest usuwany, a treść nagłówka i przycisk zamykania ukryte.
maxWidth optional	Typ:  number optional Maksymalna szerokość okna InfoWindow niezależnie od szerokości treści. Ta wartość jest brana pod uwagę 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 InfoWindow, niezależnie od szerokości treści. Jeśli używasz tej właściwości, zdecydowanie zalecamy ustawienie parametru minWidth na wartość mniejszą niż szerokość mapy (w pikselach). Ta wartość jest brana pod uwagę 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 Przesunięcie (w pikselach) końcówki okna informacyjnego od punktu na mapie, w którym zakotwiczone jest okno informacyjne ze współrzędnymi geograficznymi. Jeśli okno InfoWindow jest otwarte z kotwicą, wartość pixelOffset zostanie obliczona na podstawie właściwości anchorPoint kotwicy.
position optional	Typ:  LatLng|LatLngLiteral optional Lokalizacja geograficzna, do której ma być wyświetlane to okno informacyjne. Jeśli okno InfoWindow jest otwarte za pomocą kotwicy, zostanie użyta jej pozycja.
zIndex optional	Typ:  number optional Wszystkie systemy InfoWindows są wyświetlane na mapie w kolejności według ich zIndex – wyższe wartości są wyświetlane przed systemem InfoWindows, a niższe. Domyślnie InfoWindows są wyświetlane według szerokości geograficznej. W większych miejscach przed systemem InfoWindows wyświetlane są niższe szerokości geograficzne. System InfoWindows jest zawsze wyświetlany 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 zostanie umieszczone to okno InfoWindow. Jeśli kotwica nie ma wartości null, okno informacyjne zostanie umieszczone w górnej środkowej części kotwicy. Okno InfoWindow będzie renderowane na tej samej mapie lub w panoramie co reklama zakotwiczona (jeśli będzie dostępna).
map optional	Typ:  Map|StreetViewPanorama optional Mapa lub panorama, na których ma być renderowane to okno informacyjne.
shouldFocus optional	Typ:  boolean optional Określa, czy należy przenieść zaznaczenie w oknie InfoWindow, gdy jest ono otwarte. Gdy właściwość jest nieskonfigurowana lub ma wartość null lub undefined, do ustalenia, czy należy 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.