Topik ini menjelaskan API JavaScript tambahan yang dapat digunakan saat membuat aplikasi HTML5 atau Miniapps.
WindVaneReady
Saat halaman dimuat, WindVane memicu event WindVaneReady, yang dapat didengarkan oleh halaman untuk mengetahui status pemuatan. Event ini juga dipicu saat halaman di-refresh atau riwayat halaman dikembalikan.
document.addEventListener('WindVaneReady', function(e) {
alert('WindVaneReady');
}, false);
Latar Belakang
Saat aplikasi dipindahkan ke latar belakang, seperti beralih ke aplikasi lain atau membuka bilah notifikasi, WindVane akan memicu event WV.Event.APP.Background, dan halaman dapat mendengarkan event ini untuk mengetahui pergantian aplikasi ke latar belakang.
Karena keterbatasan sistem Android, event WV.Event.APP.Background juga dipicu ketika pengguna beralih dari WebView ke aktivitas lain, tidak hanya saat aplikasi berpindah ke latar belakang.
Saat aplikasi berada di latar belakang, operasi tidak dapat dilakukan hingga WebView diaktifkan kembali. Hindari memicu peringatan dalam event ini karena dapat menyebabkan bug serius pada beberapa model Android, di mana setiap halaman yang dibuka akan kosong.
Pada sistem iOS, mulai WindVane 5.6.0, kondisi pemantik event WV.Event.APP.Background diperbarui agar sesuai dengan sistem Android: Event ini dipicu saat aplikasi beralih dari WebView ke Native atau tampilan lainnya.
Parameter "to" ditambahkan mulai WindVane 5.6.0 untuk menentukan tujuan perpindahan aplikasi dari WebView. Nilai valid untuk parameter ini adalah 'background', yang menunjukkan bahwa WebView dipindahkan ke latar belakang.
Jika parameter ini tidak ada, tidak dapat ditentukan kemana aplikasi berpindah dari WebView.
document.addEventListener('WV.Event.APP.Background', function(e) {
// Untuk beberapa model, peringatan dipicu saat aplikasi keluar, yang akan menyebabkan bug sistem.
console.log('Event Background');
}, false);
Aktif
Saat aplikasi dipindahkan dari latar belakang ke latar depan, WindVane akan memicu event WV.Event.APP.Active, dan halaman dapat mendengarkan event ini untuk mendapatkan aktivasi aplikasi.
Karena keterbatasan sistem Android, event WV.Event.APP.Active juga dipicu ketika pengguna beralih dari aktivitas lain ke WebView, tidak hanya saat aplikasi berpindah dari latar belakang ke latar depan.
Pada sistem iOS, mulai WindVane 5.6.0, kondisi pemantik event WV.Event.APP.Active diperbarui agar sesuai dengan sistem Android: Event ini dipicu saat aplikasi beralih dari Native atau tampilan lainnya ke WebView.
Parameter "from" ditambahkan mulai WindVane 5.6.0 untuk menentukan asal perpindahan aplikasi ke WebView. Nilai valid:
'background': Menunjukkan bahwa aplikasi beralih dari latar belakang ke WebView.'webview': Menunjukkan bahwa aplikasi beralih dari tampilan lain ke WebView.
Jika parameter ini tidak ada, tidak dapat ditentukan dari mana aplikasi beralih ke WebView.
Parameter "data" ditambahkan mulai WindVane 6.3.0 untuk mendapatkan data yang dilewatkan oleh WebAppInterface.pop.
document.addEventListener('WV.Event.APP.Active', function(e) {
alert('Event Active');
}, false);