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