Class InfoWindow
Class
google.maps.InfoWindow
Overlay yang terlihat seperti balon dan sering terhubung ke penanda.
Class ini memperluas
MVCObject
.
Akses dengan memanggil const {InfoWindow} = await google.maps.importLibrary("maps")
atau const {InfoWindow} = await google.maps.importLibrary("streetView")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
InfoWindow |
InfoWindow([opts]) Parameter:
Membuat jendela info dengan opsi yang diberikan. InfoWindow dapat ditempatkan di peta pada posisi tertentu atau di atas penanda, bergantung pada apa yang ditentukan dalam opsi. Kecuali jika geser otomatis dinonaktifkan, InfoWindow akan menggeser peta agar terlihat saat dibuka. Setelah membuat InfoWindow, Anda harus memanggil open untuk menampilkannya di peta. Pengguna dapat mengklik tombol tutup di InfoWindow untuk menghapusnya dari peta, atau developer dapat memanggil close() untuk efek yang sama. |
Properti | |
---|---|
isOpen |
Jenis:
boolean Memeriksa apakah InfoWindow terbuka. |
Metode | |
---|---|
close |
close() Parameter: Tidak ada
Nilai yang Ditampilkan: Tidak ada
Menutup InfoWindow ini dengan menghapusnya dari struktur DOM. |
focus |
focus() Parameter: Tidak ada
Nilai yang Ditampilkan: Tidak ada
Menetapkan fokus pada InfoWindow ini. Sebaiknya pertimbangkan untuk menggunakan metode ini bersama dengan peristiwa visible untuk memastikan InfoWindow terlihat sebelum menetapkan fokus pada InfoWindow . InfoWindow yang tidak terlihat tidak dapat difokuskan. |
getContent |
getContent() Parameter: Tidak ada
|
getHeaderContent |
getHeaderContent() Parameter: Tidak ada
Nilai yang Ditampilkan:
string|Element|Text|null|undefined Konten header InfoWindow ini. Lihat InfoWindowOptions.headerContent . |
getHeaderDisabled |
getHeaderDisabled() Parameter: Tidak ada
Nilai yang Ditampilkan:
boolean|undefined Apakah seluruh baris header dinonaktifkan atau tidak. Lihat InfoWindowOptions.headerDisabled . |
getPosition |
getPosition() Parameter: Tidak ada
Nilai yang Ditampilkan:
LatLng|null|undefined Posisi LatLng InfoWindow ini. |
getZIndex |
getZIndex() Parameter: Tidak ada
Nilai yang Ditampilkan:
number zIndex InfoWindow ini. |
open |
open([options, anchor]) Parameter:
Nilai yang Ditampilkan: Tidak ada
Membuka InfoWindow ini di peta yang diberikan. Secara opsional, InfoWindow dapat dikaitkan dengan anchor. Di API inti, satu-satunya anchor adalah class Penanda. Namun, anchor dapat berupa MVCObject apa pun yang mengekspos properti LatLng position dan secara opsional properti Point anchorPoint untuk menghitung pixelOffset (lihat InfoWindowOptions). anchorPoint adalah offset dari posisi anchor ke ujung InfoWindow. Sebaiknya gunakan antarmuka InfoWindowOpenOptions sebagai satu argumen untuk metode ini. Untuk mencegah perubahan fokus browser saat dibuka, tetapkan InfoWindowOpenOptions.shouldFocus ke false . |
setContent |
setContent([content]) Nilai yang Ditampilkan: Tidak ada
|
setHeaderContent |
setHeaderContent([headerContent]) Parameter:
Nilai yang Ditampilkan: Tidak ada
|
setHeaderDisabled |
setHeaderDisabled([headerDisabled]) Parameter:
Nilai yang Ditampilkan: Tidak ada
|
setOptions |
setOptions([options]) Parameter:
Nilai yang Ditampilkan: Tidak ada
|
setPosition |
setPosition([position]) Parameter:
Nilai yang Ditampilkan: Tidak ada
|
setZIndex |
setZIndex(zIndex) Parameter:
Nilai yang Ditampilkan: Tidak ada
|
Diwariskan:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Acara | |
---|---|
close |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan setiap kali InfoWindow ditutup. Misalnya, hal ini dapat terjadi karena memanggil metode InfoWindow.close , menekan tombol escape untuk menutup InfoWindow, atau mengklik tombol tutup atau memindahkan InfoWindow ke peta lain. |
closeclick |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat tombol tutup diklik. |
content_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti konten berubah. |
domready |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat <div> yang berisi konten InfoWindow dilampirkan ke DOM. Sebaiknya pantau peristiwa ini jika Anda membuat konten jendela info secara dinamis. |
headercontent_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti headerContent berubah. |
headerdisabled_changed |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat properti headerDisabled berubah. |
position_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti posisi berubah. |
visible |
function() Argumen: Tidak ada
Peristiwa ini dipicu saat InfoWindow terlihat sepenuhnya. Peristiwa ini tidak diaktifkan saat InfoWindow digeser keluar, lalu kembali ke layar. |
zindex_changed |
function() Argumen: Tidak ada
Peristiwa ini diaktifkan saat zIndex InfoWindow berubah. |
Antarmuka InfoWindowOptions
Antarmuka
google.maps.InfoWindowOptions
Objek InfoWindowOptions yang digunakan untuk menentukan properti yang dapat ditetapkan di InfoWindow.
Properti | |
---|---|
ariaLabel optional |
Jenis:
string optional AriaLabel yang akan ditetapkan ke InfoWindow. |
content optional |
Konten yang akan ditampilkan di InfoWindow. Ini dapat berupa elemen HTML, string teks biasa, atau string yang berisi HTML. InfoWindow akan diukur sesuai dengan konten. Untuk menetapkan ukuran eksplisit untuk konten, tetapkan konten sebagai elemen HTML dengan ukuran tersebut. |
disableAutoPan optional |
Jenis:
boolean optional Default:
false Nonaktifkan geser peta agar InfoWindow terlihat sepenuhnya saat dibuka. |
headerContent optional |
Konten yang akan ditampilkan di baris header InfoWindow. Ini dapat berupa elemen HTML, atau string teks biasa. InfoWindow akan diukur sesuai dengan konten. Untuk menetapkan ukuran eksplisit untuk konten header, tetapkan headerContent sebagai elemen HTML dengan ukuran tersebut. |
headerDisabled optional |
Jenis:
boolean optional Menonaktifkan seluruh baris header di InfoWindow. Jika ditetapkan ke true, header akan dihapus sehingga konten header dan tombol tutup akan disembunyikan. |
maxWidth optional |
Jenis:
number optional Lebar maksimum InfoWindow, terlepas dari lebar konten. Nilai ini hanya dipertimbangkan jika ditetapkan sebelum panggilan ke open() . Untuk mengubah lebar maksimum saat mengubah konten, panggil close() , setOptions() , lalu open() . |
minWidth optional |
Jenis:
number optional Lebar minimum InfoWindow, terlepas dari lebar konten. Saat menggunakan properti ini, sebaiknya tetapkan minWidth ke nilai yang kurang dari lebar peta (dalam piksel). Nilai ini hanya dipertimbangkan jika ditetapkan sebelum panggilan ke open() . Untuk mengubah lebar minimum saat mengubah konten, panggil close() , setOptions() , lalu open() . |
pixelOffset optional |
Jenis:
Size optional Offset, dalam piksel, dari ujung jendela info dari titik pada peta yang koordinat geografisnya menjadi tempat penambatan jendela info. Jika InfoWindow dibuka dengan anchor, pixelOffset akan dihitung dari properti anchorPoint anchor. |
position optional |
Jenis:
LatLng|LatLngLiteral optional LatLng tempat InfoWindow ini akan ditampilkan. Jika InfoWindow dibuka dengan anchor, posisi anchor akan digunakan sebagai gantinya. |
zIndex optional |
Jenis:
number optional Semua InfoWindows ditampilkan di peta sesuai urutan zIndex-nya, dengan nilai yang lebih tinggi ditampilkan di depan InfoWindows dengan nilai yang lebih rendah. Secara default, InfoWindows ditampilkan sesuai dengan lintang, dengan InfoWindows lintang yang lebih rendah muncul di depan InfoWindows pada lintang yang lebih tinggi. InfoWindows selalu ditampilkan di depan penanda. |
Antarmuka InfoWindowOpenOptions
Antarmuka
google.maps.InfoWindowOpenOptions
Opsi untuk membuka InfoWindow
Properti | |
---|---|
anchor optional |
Jenis:
MVCObject|AdvancedMarkerElement optional Anchor tempat InfoWindow ini akan diposisikan. Jika anchor bukan null, InfoWindow akan diposisikan di bagian tengah atas anchor. InfoWindow akan dirender pada peta atau panorama yang sama dengan anchor (jika tersedia). |
map optional |
Jenis:
Map|StreetViewPanorama optional Peta atau panorama tempat InfoWindow ini dirender. |
shouldFocus optional |
Jenis:
boolean optional Apakah fokus harus dipindahkan di dalam InfoWindow atau tidak saat dibuka. Jika properti ini tidak ditetapkan atau ditetapkan ke null atau undefined , heuristik akan digunakan untuk memutuskan apakah fokus harus dipindahkan atau tidak. Sebaiknya tetapkan properti ini secara eksplisit agar sesuai dengan kebutuhan Anda karena heuristik dapat berubah dan mungkin tidak berfungsi dengan baik untuk semua kasus penggunaan. |