HTML5+API device
Device Device模块管理设备信息,用于获取手机设备的相关信息,如IMEI、IMSI、型号、厂商等。通过plus.device获取设备信息管理对象。
对象: networkinfo
- networkinfo模块用于获取网络信息
networkinfo
常量
- CONNECTION_UNKNOW: 网络连接状态未知
- CONNECTION_NONE: 未连接网络
- CONNECTION_ETHERNET: 有线网络
- CONNECTION_WIFI: 无线WIFI网络
- CONNECTION_CELL2G: 蜂窝移动2G网络
- CONNECTION_CELL3G: 蜂窝移动3G网络
- CONNECTION_CELL4G: 蜂窝移动4G网络
方法
- getCurrentType: 获取设备当前连接的网络类型
演示代码
<div class="mui-content">
<button type="button" id="btn1">获取设备信息</button>
</div>
</body>
<script type="text/javascript">
mui.init();
document.getElementById("btn1").addEventListener('tap', function(){
mui.alert(plus.networkinfo.getCurrentType());
});
</script>
使用网络前建议先判断网络情况
<script type="text/javascript">
mui.init();
document.getElementById("btn1").addEventListener('tap', function(){
var connectionStatus = plus.networkinfo.getCurrentType();
if(connectionStatus == 0 || connectionStatus == 1){
mui.toast('无法连接网络');
}else if(connectionStatus == 3){
mui.toast('使用wifi');
}
//......................
});
</script>
检测网络状态变化
<script type="text/javascript">
mui.init();
mui.plusReady(function(){
document.addEventListener("netchange", function(){
var nt = plus.networkinfo.getCurrentType();
switch ( nt ) {
case plus.networkinfo.CONNECTION_ETHERNET: //网络状态常量,当前设备连接到有线网络,固定值2
case plus.networkinfo.CONNECTION_WIFI: //网络状态常量,当前设备连接到无线WIFI网络,固定值3
alert("切换到wifi!");
break;
case plus.networkinfo.CONNECTION_CELL2G: //网络状态常量,当前设备连接到蜂窝移动2G网络,固定值为4。
alert('切换到2G网络!')
case plus.networkinfo.CONNECTION_CELL3G: //网络状态常量,当前设备连接到蜂窝移动3G网络,固定值为5。
alert('切换到3G网络!')
case plus.networkinfo.CONNECTION_CELL4G: //网络状态常量,当前设备连接到蜂窝移动4G网络,固定值为6。
alert("切换到4G网络!");
break;
default:
alert("无网络!");
break;
}
}, false );
});
</script>
- 原文地址: http://www.hcoder.net/tutorials/info_98.html
- 官网地址: http://www.html5plus.org/doc/zh_cn/device.html#plus.networkinfo
HTML5+ - 窗口事件及原生dom事件
addEventListener 添加事件监听函数
- document.addEventListener(event,callback,capture);
参数
- event: (DOMString) 必选要添加监听的事件类型,可取下面列出的所有事件常量
- callback: (EventTrigCallback) 必选扩展API加载完毕触发的回调函数
- capture:(Boolean) 可选 事件流捕获顺序,可忽略
事件常量
- 'plusready': 扩展API加载完成事件
- 'pause': 运行环境从前台切换到后台事件
- 'resume': 运行环境从后台切换到前台事件
- 'netchange': 设备网络状态变化事件
- 'newintent': 新意图事件
- 'plusscrollbottom': 窗口滚动到底部事件
- 'error': 页面加载错误事件
- 'background': 应用切换到后台运行事件
- 'foreground': 应用切换到前台运行事件
- 'trimmemory': 应用需要清理内存事件
- 'splashclosed':应用启动界面已关闭事件
plusready: 扩展API加载完成事件
document.addEventListener( "plusready", plusreadyCallback, capture )
-
说明:
String 类型
为了保证扩展API的有效调用,所有应用页面都会用到的重要事件。
应用页面显示时需要首先加载扩展和API代码库,当扩展API代码库加载完成时会触发pluseready事件,
当设备触发该事件后,用户就可以安全的调用扩展API。 如果程序中打开多个页面,每个都会收到此事件。 -
示例:
// 扩展API加载完毕后调用onPlusReady回调函数
document.addEventListener( "plusready", onPlusReady, false );
function onPlusReady() {
// 扩展API加载完毕,现在可以正常调用扩展API
}
pause: 运行环境从前台切换到后台事件
document.addEventListener( "pause", pauseCallback, capture );
-
当程序从前台切换到后台时会触发此事件。 若应用需要处理从前台切换到后台的事件行为,
可通过注册事件监听器来监听“pause”事件,此事件需要在plusready事件后通过document进行注册。mui.plusReady(function(){
document.addEventListener('pause',function(){
mui.toast('app 在后端运行');
},false)
});
resume: 运行环境从后台切换到前台事件
document.addEventListener( "resume", resumeCallback, capture );
mui.plusReady(function(){
document.addEventListener('pause',function(){
mui.toast('app 在后端运行');
},false);
document.addEventListener('resume',function(){
mui.toast('app 在前端端运行');
},false)
});
netchange:设备网络状态变化事件
document.addEventListener("netchange", netchangeCallback, capture);
String 类型
-
设备网络状态发生时会触发此事件。 若应用需要处理网络状态变化的事件行为,
可通过注册事件监听器来监听“netchange”事件,此事件需要在plusready事件后通过document进行注册// 扩展API加载完毕后调用onPlusReady回调函数
document.addEventListener("plusready", onPlusReady, false);
function onPlusReady(){
document.addEventListener("netchange", onNetChange, false);
}
function onNetChange(){
var nt = plus.networkinfo.getCurrentType();
switch (nt){
case plus.networkinfo.CONNECTION_ETHERNET:
case plus.networkinfo.CONNECTION_WIFI:
alert();
break;
case plus.networkinfo.CONNECTION_CELL2G:
case plus.networkinfo.CONNECTION_CELL3G:
case plus.networkinfo.CONNECTION_CELL4G:
alert();
break;
default:
alert();
break;
}
}
newintent:新意图事件
document.addEventListener("newintent", newintentCallback, capture);
String 类型
-
程序从后台被第三方程序调用并传入新意图事件。 此时程序将切换到前台运行,若应用需要处理新意图的事件行为,可通过注册事件监听器来监听“newintent”事件,此事件需要在plusready事件后通过document进行注册。
// 扩展API加载完毕后调用onPlusReady回调函数
document.addEventListener("plusready", onPlusReady, false);
function onPlusReady(){
document.addEventListener("newintent", onNetIntent, false);
}
function onNetIntent(){
// 获取新意图传入的参数
var args = plus.runtime.arguments;
// 处理意图事件
}
plusscrollbottom: 窗口滚动到底部事件
document.addEventListener( "plusscrollbottom", eventCallback, capture );
当滚动Webview窗口到底部时触发此事件。
mui.plusReady(function(){
document.addEventListener( "plusscrollbottom", onScrollToBottom, false );
function onScrollToBottom() {
mui.toast('窗口滚动到底部');
}
});
background:应用切换到后台运行事件
document.addEventListener("background", backgroundCallback, capture);
String 类型
-
在多应用运行环境(如流应用)中,启动一个新应用时,之前运行的应用将会自动切换到后台运行。 切换到后台运行的应用将会触发此事件。
// 扩展API加载完毕后调用onPlusReady回调函数
document.addEventListener("plusready", onPlusReady, false);
function onPlusReady(){
document.addEventListener("background", onAppBackground, false);
}
function onAppBackground(){
console.log("Application background!");
}
foreground:应用切换到前台运行事件
document.addEventListener("foreground", foregroundCallback, capture);
String 类型
-
在多应用运行环境(如流应用)中,应用切换到后台运行后再次被启动时,不会创建新的应用实例,而是将后台应用激活到前台运行。此时切换到前台运行的应用将会触发foreground事件。 回调函数原型为void onForeground(e){}其中e.active表明激活应用到
前台来源,可取值:"default"-默认激活方式,通常表示通过应用列表启动激活,或者关闭前一个应用后自动激活等;"stream"-通过流应用api(plus.stream.open)激活;"scheme"-通过urlscheme方式触发激活; "push"-通过点击系统通知方式触发激活;"barcode"-通过二维码扫描激活; "myapp"-通过应用收藏列表([流应用]独立App中"我的"列表)触发激活。// 扩展API加载完毕后调用onPlusReady回调函数
document.addEventListener("plusready", onPlusReady, false);
function onPlusReady(){
document.addEventListener("foreground", onAppForeground, false);
}
function onAppForeground(e){
console.log("Application foreground!");
var activeType = e.active; // 获取激活到前台来源
}
trimmemory:应用需要清理内存事件
document.addEventListener("trimmemory", trimmemoryCallback, capture);
String 类型
-
在多应用运行环境(如流应用)中,可同时运行多个应用,当运行过多应用时会导致内存占用过多的情况,此时切换到后台运行的应用会收到清理内存事件。 此时应用应该释放资源来减少内存的使用(如关闭非必要的Webview窗口等)。
// 扩展API加载完毕后调用onPlusReady回调函数
document.addEventListener("plusready", onPlusReady, false);
function onPlusReady(){
document.addEventListener("trimmemory", onAppTrimMemory, false);
}
function onAppTrimMemory(){
console.log("Trim Memory!");
}
splashclosed:应用启动界面已关闭事件
document.addEventListener("splashclosed", splashClosedCallback, capture);
String 类型
-
应用启动后关闭启动界面时触发,不管是应用自动关闭还是调用plus.navigator.closeSplashscreen方法,都会触发此事件。
// 扩展API加载完毕后调用onPlusReady回调函数
document.addEventListener("plusready", onPlusReady, false);
function onPlusReady(){
document.addEventListener("splashclosed", onSplashClosed, false);
}
function onSplashClosed(){
console.log("Splash closed!");
}
原生dom事件
-
1、利用dom元素的 onclick="" 属性
<input type="button" id="btn" value="test" onclick="test();"></input>
//js代码
function test(){alert(1);} -
2、获取dom对象,从写dom元素的 onclick 方法
<input type="button" id="btn" value="test"></input>
//js代码
document.addEventListener('plusready', function(){
var btn = document.getElementById('btn');
btn.onclick = function(){alert(1);}
}); -
3、a 元素的href属性
<a href="javascript:test();">test</a>
//js代码
function test(){alert(1);}