PhoneGap开发API教程:events

events(事件类)

备注:events类只有一个方法

事件类型：deviceready

说明：当PhponeGap完全加载完成以后激活(类似于window.onload)

在页面完全加载完成以后，再调用其他函数，比较安全

函数原型：document.addEventListener("deviceready", yourCallbackFunction, false);

详细说明：

这是一个非常重要的事件，每个PhoneGap 应用都应该使用这个函数。PhoneGap包含两种代码基础，native和javascript(注:这是两种语言)，当native代码加载时，普通的图像也会加载然后显示，但是，javascript只在Dom加载完成后才会加载，这样意味javascript函数必须在调用前被加载。PhoneGap 的deviceready 事件在PhoneGap应用完全加载成功后回调，这样就能安全的调用PhoneGap函数。你需要对文档Dom加载完成后使用document.addEventListener 添加一个事件监听函数。

支持的平台：

Android

BlackBerry WebWorks (OS 5.0 and higher)

iPhone

BlackBerry (OS 4.6) 平台:

BlackBerry (OS 4.6) 平台不支持deviceready 事件，无论如何都不会激活这个事件，只有手动的使用PhoneGap.available函数检查当前应用是否已经完全加载成功。

原文文档在此 http://docs.phonegap.com/phonegap_events_events.md.html