解析PhoneGap API帮助文档翻译Events事件

移动开发
PhoneGap API帮助文档翻译Events事件是本文要介绍的内容,主要是来了解并学习PhoneGap API文档的应用,具体关于PhoneGap API文档的翻译来看本文详解。

PhoneGap API帮助文档翻译Events事件是本文要介绍的内容,主要是来了解并学习PhoneGap API文档的应用,具体关于PhoneGap API文档的翻译来看本文详解,PhoneGap整个生命周期内触发的事件。

事件类型:

backbutton  
deviceready  
menubutton  
pause  
resume  
searchbutton  
online  
offline  
backbutton   
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.

当用户在Android系统上点击后退按钮的时候触发此事件。

document.addEventListener("backbutton", yourCallbackFunction, false);    
document.addEventListener("backbutton", yourCallbackFunction, false); 
  • 1.
  • 2.

详述:

如果你需要在Android系统上重载默认后退按钮的行为,可以通过注册一个事件监听器来监听“backbutton”事件。它不再需求调用任何其他方法来重载后退按钮行为,现在你只需要为“backbutton”事件注册一个事件监听器。

通常情况下,你需要在接收到PhoneGap的“deviceready”事件后,使用document.addEventListener来附加该事件监听器。

支持的平台:

Android

简单的范例:

document.addEventListener("backbutton", onBackKeyDown, false);    
        
function onBackKeyDown() {    
   // 处理后退按钮操作    
}    
document.addEventListener("backbutton", onBackKeyDown, false);  
   
function onBackKeyDown() {  
   // 处理后退按钮操作  

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.

完整的范例:

<!DOCTYPE html>    
<html>    
<head>        
<title>PhoneGap Device Ready Example</title>    
    
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>    
<script type="text/javascript" charset="utf-8">    
    
    // 当PhoneGap加载完毕后调用onDeviceReady回调函数     
    // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。    
    // 当PhoneGap加载完毕并开始和本地设备进行通讯,    
    // 会触发“deviceready”事件    
    document.addEventListener("deviceready", onDeviceReady, false);    
        
    // PhoneGap is loaded and it is now safe to make calls PhoneGap methods    
    function onDeviceReady() {    
        // 注册回退按钮事件监听器    
        document.addEventListener("backbutton", onBackKeyDown, false);    
    }    
        
    // 处理后退按钮操作    
    function onBackKeyDown() {    
    }    
    
</script>    
</head>    
<body>    
</body>    
</html>    
<!DOCTYPE html> 
<html> 
<head>   
<title>PhoneGap Device Ready Example</title> 
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
<script type="text/javascript" charset="utf-8"> 
 
 // 当PhoneGap加载完毕后调用onDeviceReady回调函数   
 // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。  
 // 当PhoneGap加载完毕并开始和本地设备进行通讯,  
 // 会触发“deviceready”事件  
 document.addEventListener("deviceready", onDeviceReady, false);  
   
 // PhoneGap is loaded and it is now safe to make calls PhoneGap methods  
 function onDeviceReady() {  
  // 注册回退按钮事件监听器  
     document.addEventListener("backbutton", onBackKeyDown, false);  
 }  
   
 // 处理后退按钮操作  
 function onBackKeyDown() {  
 }  
 
</script> 
</head> 
<body> 
</body> 
</html> 
deviceready   
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.
  • 56.
  • 57.
  • 58.
  • 59.

当PhoneGap被完全加载后会触发该事件。

document.addEventListener("deviceready", yourCallbackFunction, false);    
document.addEventListener("deviceready", yourCallbackFunction, false); 
  • 1.
  • 2.

详述:

这是每个PhoneGap应用程序都会用到的重要事件。

PhoneGap包含两套代码库:本地代码库和JavaScript代码库。当本地代码加载时会显示一个自定义的加载图片,但是,JavaScript只是在DOM加载后就被加载。这潜在的说明用户的Web应用程序可以在PhoneGap加载完成之前调用相应的JavaScript函数。

PhoneGap一旦完全加载就会触发deviceready事件。当设备触发该事件后,用户就可以安全进行PhoneGap函数调用。

通常情况下,你会希望在HTML文件的DOM加载完毕后使用document.addEventListener附加一个事件监听器。

支持的平台:

Android

BlackBerry WebWorks (OS 5.0或更高版本)

iPhone

简单的范例:

document.addEventListener("deviceready", onDeviceReady, false);    
function onDeviceReady() {    
    // 现在可以安全使用PhoneGap API     
}    
document.addEventListener("deviceready", onDeviceReady, false);  
 
function onDeviceReady() {  
 // 现在可以安全使用PhoneGap API   

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.

完整的范例:

<!DOCTYPE html>    
<html>    
<head>        
<title>PhoneGap Device Ready Example</title>    
    
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>    
<script type="text/javascript" charset="utf-8">    
    
    // 当PhoneGap加载完毕后调用onDeviceReady回调函数    
    // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。    
    // 当PhoneGap加载完毕并开始和本地设备进行通讯,    
    // 就会触发“deviceready”事件。    
    document.addEventListener("deviceready", onDeviceReady, false);    
        
    // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法    
    function onDeviceReady() {    
       // 现在可以安全使用PhoneGap API    
    }    
    
</script>    
</head>    
<body>    
</body>    
</html>    
<!DOCTYPE html> 
<html> 
<head>   
<title>PhoneGap Device Ready Example</title> 
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
<script type="text/javascript" charset="utf-8"> 
 
 // 当PhoneGap加载完毕后调用onDeviceReady回调函数  
 // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。  
 // 当PhoneGap加载完毕并开始和本地设备进行通讯,  
 // 就会触发“deviceready”事件。  
 document.addEventListener("deviceready", onDeviceReady, false);  
   
 // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法  
 function onDeviceReady() {  
    // 现在可以安全使用PhoneGap API  
 }  
 
</script> 
</head> 
<body> 
</body> 
</html> 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.

#p#

BlackBerry (OS 4.6) 的特异情况:

RIM的BrowserField(网页浏览器视图)不支持自定义事件,所以deviceready事件不会被触发。

PhoneGap API中,一种解决方法是一直手动查询PhoneGap.available方法直到PhoneGap完全加载完毕。

function onLoad() {    
    // BlackBerry OS 4浏览器不支持自定义事件。    
    // 因此通过手动方式等待,直到PhoneGap加载完毕。    
    var intervalID = window.setInterval(    
        function() {    
            if (PhoneGap.available) {    
            window.clearInterval(intervalID);    
            onDeviceReady();    
        }    
    },    
    500    
    );    
}    
    
function onDeviceReady() {    
    // 现在可以安全地调用PhoneGap API    
}    
function onLoad() {  
 // BlackBerry OS 4浏览器不支持自定义事件。  
 // 因此通过手动方式等待,直到PhoneGap加载完毕。  
 var intervalID = window.setInterval(  
  function() {  
    if (PhoneGap.available) {  
    window.clearInterval(intervalID);  
    onDeviceReady();  
   }  
  },  
  500  
 );  
}  
 
function onDeviceReady() {  
 // 现在可以安全地调用PhoneGap API  

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.

menubutton 

当用户在Android系统上点击菜单按钮的时候触发此事件。

document.addEventListener("menubutton", yourCallbackFunction, false);    
document.addEventListener("menubutton", yourCallbackFunction, false); 
  • 1.
  • 2.

详述:

如果你需要在Android系统上重载默认菜单按钮的行为,可以通过注册一个事件监听器来监听“menubutton”事件。

通常情况下,你需要在接受到PhoneGap的“deviceready”事件后,使用document.addEventListener来附加该事件监听器。

支持的平台:

Android

简单的范例:

document.addEventListener("menubutton", onMenuKeyDown, false);     
     
function onMenuKeyDown() {     
    //处理菜单按钮操作     
}    
document.addEventListener("menubutton", onMenuKeyDown, false);   
   
function onMenuKeyDown() {   
 //处理菜单按钮操作   

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.

完整的范例:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">    
<html>    
<head>        
<title>PhoneGap Device Ready Example</title>     
    
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>     
<script type="text/javascript" charset="utf-8">     
    
    // 当PhoneGap加载完毕后调用onDeviceReady回调函数    
    // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。    
    // 当PhoneGap加载完毕并开始和本地设备进行通讯,    
    // 会触发“deviceready”事件    
    document.addEventListener("deviceready", onDeviceReady, false);     
        
    // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法    
    function onDeviceReady() {     
        // 注册菜单按钮事件监听器    
        document.addEventListener("menubutton", onMenuKeyDown, false);     
    }     
        
    // 处理菜单按钮操作    
    function onMenuKeyDown() {     
    }     
    
</script>    
</head>    
<body onload="onLoad()">    
</body>    
</html>    
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> 
<html> 
<head>   
<title>PhoneGap Device Ready Example</title>   
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>   
<script type="text/javascript" charset="utf-8">   
 
 // 当PhoneGap加载完毕后调用onDeviceReady回调函数  
 // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。  
 // 当PhoneGap加载完毕并开始和本地设备进行通讯,  
 // 会触发“deviceready”事件  
 document.addEventListener("deviceready", onDeviceReady, false);   
   
 // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法  
 function onDeviceReady() {   
  // 注册菜单按钮事件监听器  
  document.addEventListener("menubutton", onMenuKeyDown, false);   
 }   
   
 // 处理菜单按钮操作  
 function onMenuKeyDown() {   
 }   
 
</script> 
</head> 
<body onload="onLoad()"> 
</body> 
</html> 
pause   
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.
  • 56.
  • 57.
  • 58.
  • 59.

#p#

当PhoneGap应用程序被放到后台的时候触发此事件。

document.addEventListener("pause", yourCallbackFunction, false);    
document.addEventListener("pause", yourCallbackFunction, false); 
  • 1.
  • 2.

详述:

PhoneGap API中,PhoneGap包含两套代码库:本地代码库和JavaScript代码库。当本地代码将应用程序放到后台的时候会触发pause事件。

通常情况下,你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。
支持的平台:

Android

BlackBerry WebWorks (OS 5.0或更高版本)

iPhone

简单的范例:

document.addEventListener("pause", onPause, false);    
    
function onPause() {    
   // 处理pause事件    
}    
document.addEventListener("pause", onPause, false);  
 
function onPause() {  
   // 处理pause事件  

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.

完整的范例:

<!DOCTYPE html>    
<html>    
<head>        
<title>PhoneGap Device Ready Example</title>    
    
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>    
<script type="text/javascript" charset="utf-8">    
        
    // 当PhoneGap加载完毕后调用onDeviceReady回调函数。    
    // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。    
    // 当PhoneGap加载完毕并开始和本地设备进行通讯,    
    // 就会触发“deviceready”事件。    
    document.addEventListener("deviceready", onDeviceReady, false);    
        
    // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法    
    function onDeviceReady() {    
        document.addEventListener("pause", onPause, false);    
    }    
        
    // 处理pause事件    
    function onPause() {    
    }    
    
</script>    
</head>    
<body>    
</body>    
</html>    
<!DOCTYPE html> 
<html> 
<head>   
<title>PhoneGap Device Ready Example</title> 
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
<script type="text/javascript" charset="utf-8"> 
   
 // 当PhoneGap加载完毕后调用onDeviceReady回调函数。  
 // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。  
 // 当PhoneGap加载完毕并开始和本地设备进行通讯,  
 // 就会触发“deviceready”事件。  
 document.addEventListener("deviceready", onDeviceReady, false);  
   
 // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法  
 function onDeviceReady() {  
  document.addEventListener("pause", onPause, false);  
 }  
   
 // 处理pause事件  
 function onPause() {  
 }  
 
</script> 
</head> 
<body> 
</body> 
</html> 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.
  • 56.

iOS的特异情况:

PhoneGap API中,在pause事件处理过程中,不但任何通过Objective-C的调用不会工作,而且任何交互性的调用也不会工作,比如警示功能。这意味着你不能调用console.log(及其变种),且任何来自插件或PhoneGap API的调用都不会有所反应。这些调用只有在应用程序恢复后才会被处理(在下一轮运行循环中处理)。

resume  
 
PhoneGap应用程序被恢复到前台运行的时候触发此事件。

document.addEventListener("resume", yourCallbackFunction, false);    
document.addEventListener("resume", yourCallbackFunction, false); 
  • 1.
  • 2.

详述:

PhoneGap API中,PhoneGap包含两套代码库:本地代码库和JaPhoneGap包含两套代码库:本地代码库和JavaScript代码库。当本地代码将应用程序从后台提取到前台运行的时候触发resume事件。

通常情况下,你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台:

Android

BlackBerry WebWorks (OS 5.0或更高版本)

iPhone

简单的范例:

document.addEventListener("resume", onResume, false);    
    
function onResume() {    
   // 处理resume事件    
}    
document.addEventListener("resume", onResume, false);  
 
function onResume() {  
   // 处理resume事件  

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.

完整的范例

<!DOCTYPE html>    
<html>    
<head>        
<title>PhoneGap Device Ready Example</title>    
    
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>    
<script type="text/javascript" charset="utf-8">    
    
    // 当PhoneGap加载完毕后调用onDeviceReady回调函数。    
    // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。    
    // 当PhoneGap加载完毕并开始和本地设备进行通讯,    
    // 就会触发“deviceready”事件。    
    document.addEventListener("deviceready", onDeviceReady, false);    
        
    // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法。    
    function onDeviceReady() {    
        document.addEventListener("resume", onResume, false);    
    }    
        
    // 处理resume事件    
    function onResume() {    
    }    
        
</script>    
</head>    
<body>    
</body>    
</html>    
<!DOCTYPE html> 
<html> 
<head>   
<title>PhoneGap Device Ready Example</title> 
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script> 
<script type="text/javascript" charset="utf-8"> 
 
 // 当PhoneGap加载完毕后调用onDeviceReady回调函数。  
 // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。  
 // 当PhoneGap加载完毕并开始和本地设备进行通讯,  
 // 就会触发“deviceready”事件。  
 document.addEventListener("deviceready", onDeviceReady, false);  
   
 // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法。  
 function onDeviceReady() {  
  document.addEventListener("resume", onResume, false);  
 }  
   
 // 处理resume事件  
 function onResume() {  
 }  
   
</script> 
</head> 
<body> 
</body> 
</html> 
online   
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.
  • 56.
  • 57.

#p#

当PhoneGap应用程序在线(连接到因特网)的时候触发此事件。

document.addEventListener("online", yourCallbackFunction, false);    
document.addEventListener("online", yourCallbackFunction, false); 
  • 1.
  • 2.

详述:

当应用程序的网络连接改变为online的时候触发online事件。

通常情况下,你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台:

Android

BlackBerry WebWorks (OS 5.0或更高版本)

iPhone

简单的范例:

document.addEventListener("online", onOnline, false);     
     
function onOnline() {    
    // 处理online事件    
}    
document.addEventListener("online", onOnline, false);   
   
function onOnline() {  
 // 处理online事件  
}  
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.

完整的范例:

<!DOCTYPE html>    
<html>    
<head>        
<title>PhoneGap Device Ready Example</title>     
    
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>     
<script type="text/javascript" charset="utf-8">     
    
    // 当PhoneGap加载完毕后调用onDeviceReady回调函数。    
    // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。    
    // 当PhoneGap加载完毕并开始和本地设备进行通讯,    
      // 就会触发“deviceready”事件。    
    document.addEventListener("deviceready", onDeviceReady, false);     
        
    // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法。    
    function onDeviceReady() {     
        document.addEventListener("online", onOnline, false);     
    }     
        
    // 处理online事件     
    function onOnline() {     
    }     
    
</script>    
</head>    
<body>    
</body>    
</html>    
<!DOCTYPE html> 
<html> 
<head>   
<title>PhoneGap Device Ready Example</title>   
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>   
<script type="text/javascript" charset="utf-8">   
 
 // 当PhoneGap加载完毕后调用onDeviceReady回调函数。  
 // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。  
 // 当PhoneGap加载完毕并开始和本地设备进行通讯,  
   // 就会触发“deviceready”事件。  
 document.addEventListener("deviceready", onDeviceReady, false);   
   
 // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法。  
 function onDeviceReady() {   
  document.addEventListener("online", onOnline, false);   
 }   
   
 // 处理online事件   
 function onOnline() {   
 }   
</script> 
</head> 
<body> 
</body> 
</html> 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.

iOS的特异情况:

在初次启动的情况下,第一个online事件(如果有的话)将需要至少1秒钟才被触发。

offline 

PhoneGap应用程序离线(没有连接到因特网)的时候触发此事件。

document.addEventListener("offline", yourCallbackFunction, false);    
document.addEventListener("offline", yourCallbackFunction, false); 
  • 1.
  • 2.

详述:

当应用程序的网络连接改变为offline的时候触发offline事件。

通常情况下,你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。

支持的平台:

Android

BlackBerry WebWorks (OS 5.0或更高版本)

iPhone

简单的范例:

document.addEventListener("offline", onOffline, false);     
     
function onOffline() {    
    // 处理offline事件     
}    
document.addEventListener("offline", onOffline, false);   
   
function onOffline() {  
 // 处理offline事件   

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.

完整的范例:

<!DOCTYPE html>    
<html>    
<head>        
<title>PhoneGap Device Ready Example</title>     
    
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>     
<script type="text/javascript" charset="utf-8">     
    
    // 当PhoneGap加载完毕后调用onDeviceReady回调函数    
    // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。    
    // 当PhoneGap加载完毕并开始和本地设备进行通讯,    
      // 就会触发“deviceready”事件。    
    document.addEventListener("deviceready", onDeviceReady, false);     
        
    // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法。    
    function onDeviceReady() {     
        document.addEventListener("offline", onOffline, false);     
    }     
        
    // 处理offline事件    
    function onOffline() {     
    }     
    
</script>    
</head>    
<body>    
</body>    
</html>    
<!DOCTYPE html> 
<html> 
<head>   
<title>PhoneGap Device Ready Example</title>   
 
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>   
<script type="text/javascript" charset="utf-8">   
 
 // 当PhoneGap加载完毕后调用onDeviceReady回调函数  
 // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。  
 // 当PhoneGap加载完毕并开始和本地设备进行通讯,  
   // 就会触发“deviceready”事件。  
 document.addEventListener("deviceready", onDeviceReady, false);   
   
 // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法。  
 function onDeviceReady() {   
  document.addEventListener("offline", onOffline, false);   
 }   
   
 // 处理offline事件  
 function onOffline() {   
 }   
 
</script> 
</head> 
<body> 
</body> 
</html> 
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.
  • 38.
  • 39.
  • 40.
  • 41.
  • 42.
  • 43.
  • 44.
  • 45.
  • 46.
  • 47.
  • 48.
  • 49.
  • 50.
  • 51.
  • 52.
  • 53.
  • 54.
  • 55.
  • 56.

iOS的特异情况:

在初次启动的情况下,第一个offline事件(如果有的话)将需要至少1秒钟才被触发。

Searchbutton  
 
当用户在Android系统上点击搜索按钮的时候触发该事件。

document.addEventListener("searchbutton", yourCallbackFunction, false);    
document.addEventListener("searchbutton", yourCallbackFunction, false); 
  • 1.
  • 2.

详述:

如果你需要在Android系统上重载默认搜索按钮的行为,可以通过注册一个事件监听器来监听“searchbutton”事件。

通常情况下,你需要在接受到PhoneGap的“deviceready”事件后,使用document.addEventListener来附加该事件监听器。

支持的平台:

Android

简单的范例:

document.addEventListener("searchbutton", onSearchKeyDown, false);     
     
function onSearchKeyDown() {    
    // 处理搜索按钮操作    
}    
document.addEventListener("searchbutton", onSearchKeyDown, false);   
   
function onSearchKeyDown() {  
 // 处理搜索按钮操作  

  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.

完整的范例:

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">    
<html>    
<head>        
<title>PhoneGap Device Ready Example</title>     
    
<script type="text/javascript" charset="utf-8" src="phonegap.js"></script>     
<script type="text/javascript" charset="utf-8">     
    
    // 当PhoneGap加载完毕后调用onDeviceReady回调函数。    
    // 此时,该文件已加载完毕但phonegap.js还没有加载完毕。    
    // 当PhoneGap加载完毕并开始和本地设备进行通讯,    
    // 会触发“deviceready”事件。     
    document.addEventListener("deviceready", onDeviceReady, false);      
        
    // PhoneGap加载完毕,现在可以安全地调用PhoneGap方法     
    function onDeviceReady() {     
        // 注册搜索按钮事件监听器    
        document.addEventListener("searchbutton", onSearchKeyDown, false);     
    }     
        
    // 处理搜索按钮操作    
    function onSearchKeyDown() {     
    }     
    
</script>    
</head>    
<body onload="onLoad()">    
</body>    
</html>   
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.

小结:解析PhoneGap API帮助文档翻译Events事件的内容介绍完了,希望通过PhoneGap API内容的学习能对你有所帮助!

责任编辑:zhaolei 来源: CSDN博客
相关推荐

2011-09-13 14:07:45

PhoneGap AP

2011-09-13 11:06:08

PhoneGap AP

2011-09-13 10:40:25

PhoneGap AP

2011-09-13 14:40:16

PhoneGap AP

2011-09-13 16:08:58

PhoneGap AP

2011-09-13 13:47:56

PhoneGap AP

2011-09-13 16:24:11

PhoneGap AP

2011-09-13 15:51:11

PhoneGap AP

2011-09-13 13:17:27

PhoneGap AP

2011-12-20 17:15:52

PhoneGap APEvents

2011-07-05 17:29:53

PhoneGapevents

2011-10-11 09:50:44

PhoneGap常见问题

2011-10-11 09:03:57

常见问题PhoneGap

2011-12-20 11:20:46

PhoneGap APCompass

2011-12-19 16:09:32

PhoneGap APCamera

2009-07-26 20:36:07

EclipseJDKAPI帮助文档

2011-12-22 09:54:40

PhoneGap APMedia

2011-12-22 09:27:36

PhoneGap APGeolocation

2011-12-19 16:26:39

PhoneGap APCapture

2011-12-22 10:45:32

PhoneGap APStorage
点赞
收藏

51CTO技术栈公众号