Info Window

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Klasa InfoWindow

google.maps.InfoWindow klasa

Nakładka wygląda jak dymek i jest często podłączona do znacznika.

Te zajęcia rozciągają się do MVCObject.

Jeśli używasz aplikacji v=beta, możesz uzyskać do niej dostęp, dzwoniąc pod numer const {InfoWindow} = await google.map.importLibrary("maps") lub const {InfoWindow} = await google.map.importLibrary("streetView"). Zobacz Biblioteki w interfejsie Maps JavaScript API.
InfoWindow
InfoWindow([opts])
Parametry:
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 opcji określonych w opcjach. O ile funkcja automatycznego przesuwania nie jest wyłączona, okno informacyjne przesunie mapę, by stała się widoczna po otwarciu. Po zbudowaniu obiektu InfoWindow musisz wywołać polecenie open, aby wyświetlić je na mapie. Użytkownik może kliknąć przycisk zamykania w oknie InfoWindow, aby usunąć go z mapy, lub deweloper może wywołać metodęclose() w tym samym celu.
close
close()
Parametry: brak
Zwróć wartość: brak
Zamyka obiekt InfoWindow, usuwając go ze struktury DOM.
focus
focus()
Parametry: brak
Zwróć wartość: brak
Aktywuje InfoWindow. Zanim ustawisz ostrość w taki sposób, możesz użyć tej metody razem ze zdarzeniem visible, aby mieć pewność, że pole InfoWindow będzie widoczne. Niewidoczne pole InfoWindow jest niezaznaczone.
getContent
getContent()
Parametry: brak
Zwracana wartość: string|Element|null|Text|undefined zawartość tego okna informacyjnego. Takie same jak wcześniej skonfigurowane.
getPosition
getPosition()
Parametry: brak
Zwracana wartość: LatLng|null|undefined Długość geograficzna tego obiektu InfoWindow.
getZIndex
getZIndex()
Parametry: brak
Wartość zwrócona: number Wartość zindex tego okna informacyjnego.
open
open([options, anchor])
Parametry:
  • options:  InfoWindowOpenOptions|Map|StreetViewPanorama optional Obiekt InfoWindowOpenOptions (zalecane) lub mapa|panorama, na której zostanie wyrenderowane to okno informacyjne.
  • anchor: MVCObject|AdvancedMarkerView optional kotwica, do której zostanie umieszczony ten element InfoWindow. Jeśli kotwica nie ma wartości null, element InfoWindow zostanie umieszczony na środku u góry reklamy. Okno Inforenderuje na tej samej mapie lub w tym samym oknie co kotwica (jeśli jest dostępna).
Zwróć wartość: brak
Otwiera to okno informacyjne na danej mapie. Opcjonalnie można powiązać okno informacyjne z kotwicą. W podstawowym interfejsie API jedyną kotwicą jest klasa Marker. Kotwica może być jednak dowolnym obiektem MVCObject, który udostępnia właściwość position LatLng, i opcjonalnie właściwość Point anchorPoint do obliczania wartości pixelOffset (patrz obiekty InfoWindowOptions). anchorPoint to przesunięcie od położenia kotwicy do końcówki okna informacyjnego. Zaleca się użycie interfejsu InfoWindowOpenOptions jako pojedynczego argumentu tej metody. Aby uniemożliwić zmianę zaznaczenia przeglądarki na otwartą, ustaw InfoWindowOpenOptions.shouldFocus na false.
setContent
setContent([content])
Parametry:
  • content:  string|Element|Text optional zawartość, która ma być wyświetlana przez to okno informacyjne.
Zwróć wartość: brak
setOptions
setOptions([options])
Parametry:
Zwróć wartość: brak
setPosition
setPosition([position])
Parametry:
  • position: LatLng|LatLngLiteral optional Pozycja, w której ma się wyświetlić to okno informacyjne.
Zwróć wartość: brak
setZIndex
setZIndex(zIndex)
Parametry:
  • zIndex: number kolejność nakładania elementów (ang. z-index) tego elementu InfoWindow. Okno informacyjne, które ma większą wartość kolejności nakładania elementów, zostanie wyświetlone przed wszystkimi innymi oknami o niższym kolejności nakładania elementów.
Zwróć wartość: brak
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function()
Argumenty: brak
To zdarzenie jest uruchamiane po kliknięciu przycisku zamknięcia.
content_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane po zmianie właściwości treści.
domready
function()
Argumenty: brak
Zdarzenie jest uruchamiane, gdy <div> zawiera treść elementu InfoWindow do elementu DOM. Może to być przydatne, jeśli dynamicznie tworzysz zawartość swojego okna informacyjnego.
position_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane po zmianie właściwości pozycji.
visible
function()
Argumenty: brak
Zdarzenie jest uruchamiane, gdy element InfoWindow jest w pełni widoczny. To zdarzenie nie jest uruchamiane, gdy element InfoWindow jest przesunięty i wyświetlony z powrotem na ekranie.
zindex_changed
function()
Argumenty: brak
To zdarzenie jest uruchamiane, gdy InfoWindow ma zmianę kolejności nakładania elementów.

Interfejs InfoWindowOptions

google.maps.InfoWindowOptions interfejs

Obiekt InfoWindowOptions używany do definiowania właściwości, które można ustawić w InfoInfo.
ariaLabel optional
Typ: string optional
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, zwykły tekst lub ciąg HTML. Rozmiar okna informacyjnego zostanie dopasowany do treści. Aby określić jawny rozmiar treści, ustaw go jako element HTML o tym rozmiarze.
disableAutoPan optional
Typ: boolean optional
Domyślne: false
Wyłącz przesunięcie, aby okno informacyjne było w pełni widoczne po otwarciu.
maxWidth optional
Typ: number optional
Maksymalna szerokość elementu InfoWindow niezależnie od szerokości treści. Ta wartość jest uwzględniana tylko wtedy, gdy jest ustawiona przed wywołaniem open(). Aby zmienić maksymalną szerokość podczas zmieniania treści, wywołaj close(), setOptions(), a następnie open().
minWidth optional
Typ: number optional
Minimalna szerokość elementu InfoWindow niezależnie od szerokości treści. Jeśli używasz tej właściwości, zalecamy ustawienie w polu minWidth wartości mniejszej niż szerokość mapy (w pikselach). Ta wartość jest uwzględniana tylko wtedy, gdy jest ustawiona przed wywołaniem open(). Aby zmienić minimalną szerokość podczas zmieniania treści, wywołaj elementy close(), setOptions(), a następnie open().
pixelOffset optional
Typ: Size optional
Przesunięcie w pikselach od końca okna informacyjnego od punktu na mapie, dla którego współrzędne geograficzne są zakotwiczone. Jeśli okno informacyjne jest otwarte za pomocą kotwicy, element pixelOffset zostanie obliczony na podstawie właściwości kotwicy anchorPoint.
position optional
Typ: LatLng|LatLngLiteral optional
Długość geograficzna, w której ma zostać wyświetlone to okno informacyjne. Jeśli okno informacyjne zostanie otwarte za pomocą kotwicy, zostanie użyta pozycja kotwicy.
zIndex optional
Typ: number optional
Wszystkie obiekty InfoWindows są wyświetlane na mapie w kolejności ich kolejności nakładania elementów, a większe wartości pojawiają się przed obiektem InfoWindows o niższych wartościach. Domyślnie obiekty InfoWindows wyświetlają się zgodnie z szerokością geograficzną. Niższe szerokości geograficzne są przed nim wyświetlane. Obiekty infoWindows są zawsze wyświetlane przed znacznikami.

Interfejs InfoWindowOpenOptions

google.maps.InfoWindowOpenOptions interfejs

Opcje otwierania okna informacyjnego
anchor optional
Kotwica, do której zostanie umieszczony ten element InfoWindow. Jeśli kotwica nie ma wartości null, element InfoWindow zostanie umieszczony na środku u góry reklamy. Okno Inforenderuje na tej samej mapie lub w tym samym oknie co kotwica (jeśli jest dostępna).
map optional
Typ: Map|StreetViewPanorama optional
Mapa lub panorama, na której należy wyrenderować to okno informacyjne.
shouldFocus optional
Typ: boolean optional
Określa, czy po otwarciu okna informacyjnego ma ono zostać przeniesione. Gdy ta właściwość jest nieskonfigurowana lub ma wartość null lub undefined, do jej podjęcia brane są pod uwagę dane heurystyczne. Zaleca się wyraźne określenie tej właściwości w sposób odpowiadający Twoim potrzebom, ponieważ dane heurystyczne mogą ulec zmianie i mogą nie działać prawidłowo w niektórych przypadkach użycia.