Topik ini menjelaskan fitur JSAPI tambahan untuk mengembangkan aplikasi H5 dan mini program.
Event WindVaneReady
Event WindVaneReady dipicu setelah halaman selesai dimuat. Anda dapat mendengarkan event ini untuk memantau status pemuatan halaman. Event ini juga dipicu saat halaman dimuat ulang atau ketika Anda kembali melalui riwayat halaman.
document.addEventListener('WindVaneReady', function(e) {
alert('WindVaneReady');
}, false);
Event Background
Saat aplikasi dikirim ke latar belakang—misalnya dengan beralih ke aplikasi lain atau membuka bilah notifikasi—WindVane memicu event WV.Event.APP.Background. Anda dapat mendengarkan event ini untuk mengetahui kapan aplikasi memasuki latar belakang.
Karena keterbatasan pada platform Android, event ini juga dipicu saat Anda beralih dari WebView saat ini ke Activity lain, bukan hanya ketika aplikasi dikirim ke latar belakang.
Operasi yang dapat dilakukan saat aplikasi berada di latar belakang terbatas dan mungkin tertunda hingga halaman diaktifkan kembali. Penting: Jangan panggil alert() dalam penanganan event ini. Hal tersebut dapat menyebabkan bug kritis pada beberapa perangkat Android, sehingga semua halaman dimuat sebagai layar kosong.
Pada WindVane untuk iOS v5.6.0 dan versi selanjutnya, kondisi pemicu event Background diperbarui agar sesuai dengan perilaku Android. Event ini juga dipicu saat Anda beralih dari WebView saat ini ke komponen native atau WebView lain.
Versi ini juga menambahkan parameter event to untuk menentukan tujuan peralihan dari WebView saat ini. Nilai 'background' menunjukkan peralihan ke latar belakang.
Jika parameter to tidak tersedia, tujuan peralihan tidak dapat ditentukan.
document.addEventListener('WV.Event.APP.Background', function(e) {
// Pada beberapa perangkat, memanggil alert() saat aplikasi memasuki latar belakang menyebabkan masalah.
console.log('Event Background');
}, false);
Event Active
Saat aplikasi kembali ke latar depan dari latar belakang, WindVane memicu event WV.Event.APP.Active. Anda dapat mendengarkan event ini untuk mengetahui kapan aplikasi menjadi aktif.
Karena keterbatasan pada platform Android, event ini juga dipicu saat Anda beralih dari Activity lain ke WebView saat ini, bukan hanya ketika aplikasi kembali ke latar depan dari latar belakang.
Pada WindVane untuk iOS v5.6.0 dan versi selanjutnya, kondisi pemicu event Active diperbarui agar konsisten dengan Android. Event ini juga dipicu saat Anda beralih dari komponen native atau WebView lain ke WebView saat ini.
Versi ini juga menambahkan parameter event from untuk menunjukkan sumber peralihan ke WebView saat ini. Nilai-nilai yang mungkin adalah:
'background': Menunjukkan kembali dari latar belakang.'webview': Menunjukkan peralihan dari WebView lain.
Jika parameter from tidak tersedia, sumber peralihan tidak dapat ditentukan.
Pada WindVane v6.3.0 dan versi selanjutnya, parameter data ditambahkan untuk mengambil data yang dikirimkan dari WebAppInterface.pop.
document.addEventListener('WV.Event.APP.Active', function(e) {
alert('Event Active');
}, false);