deviceready 事件

Cordova 框架中第一个应该掌握的就是这个 deviceready 事件。

采用 Cordova 开发的应用在运行的时候,Cordova 提供的通过 HTML5调用 Native 功能并不是立即就能使用的,Cordova 框架在读入 HTML5代码之后,要进行 HTML5和 Native 建立桥接,在未能完成这个桥接的初始的情况下,是不能调用 Native 功能的。

在 Cordova 框架中,当这个桥接的初始化完成后,会调用他自身特有的事件,即 deviceready 事件。

所以首先应该在 HTML 中注册 deviceready 的事件监听,在它的 CallBack 函数中再去使用 Cordova 的功能。

Js 代码

document.addEventListener('deviceready', function () {
  console.log('Device is Ready!');
  // ....your code
}, false);

需要注意的是,deviceready 事件是在每回读入 HTML 的时候都会被调用,而不只是应用启动时调用。

除了 deviceready 事件以外,Cordova 应用在内部读取 HTML 代码的时候还会调用一些其他的事件。但这些并不是 Cordova 框架提供的事件,而是嵌入的 Webview 的浏览器 Render 引擎提供的。

DOMContentLoaded 事件

页面的 DOM 内容加载完成后即触发,而无需等待其他资源(CSS、JS)的加载。

load 事件

在 DOMContentLoaded 事件之后,其他资源加载完成后触发。

所以,其实调用的顺序是:DOMContentLoaded -> load -> deviceready deviceready 事件一定是在 load 事件之后,所以 load 事件的执行速度会影响到 deviceready 事件的调用。把一些不必要的资源可以在 deviceready 事件之后调用从而提高执行速度。

Js 代码

document.addEventListener('DOMContentLoaded', function () {
  console.log('DOMContentLoaded OK!');
}, false);

window.addEventListener('load', function () {
  console.log('load OK!');
}, false);

document.addEventListener('deviceready', function () {
  console.log('deviceready OK!');
}, false);
需要注意的是,在 Cordova 的 app 中如果 js 执行失败,前台不会有任何提示(后台会出 log),所以很多时候点击都没有任何反应,那说明 JS 执行出错了,把以下代码加到 index.html 中,当应用发生 JS 错误的时候,会调用 window 的 onerror 方法从而显示错误信息,从而捕获 JavaScript 的 Error 提示用户。

Js 代码

window.onerror = function(msg, url, line) {
   var idx = url.lastIndexOf("/");
   if(idx > -1) {
    url = url.substring(idx+1);
   }
   alert("ERROR in " + url + " (line #" + line + "): " + msg);
   return false;
};

联系我们

邮箱 626512443@qq.com
电话 18611320371(微信)
QQ群 235681453

Copyright © 2015-2024

备案号:京ICP备15003423号-3