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