模块events

Events模块管理客户端事件,包括系统事件,如扩展API加载完毕、程序前后台切换等。

比如说:网络的链接的和断开这种事件,系统从前台走到后台这种事件;

不包括:点击和滑动页面事件;

应用场景

等待事件完成:例如 plusready();

应用从前台传入后台时停止一些占用资源的服务:和服务器做交互的时候;

应用从后台转到前台时开启一些服务;

断网时提示用户:网络不给力,断网了;可以通过device 获取网络的状态;

加载错误时提示用户;

document.addEventListener(event,callback,capture);

这个时没有对象,就一个核心方法:document.addEventListener(event,callback,capture);

event:字符串类型:plusready , pause 暂停 , newintent 意图;

  pause:当用户跳转到其他应用,或者点击了home键了都触发这个事件;

  error:error事件:当webview加载某一个页面失败的时候,会触发这个事件,会在错误页面去执行这个(也就是这个是在错误页面执行这个的,所以必须要指定一个错误页面);

  错误页面有两种方式:第一种是Dcloud自己定的,在打包的时候会加上这个页面;第二种是打开窗口指定一个错误页面;

callback:事件发生之后我要做什么;

capture:可以忽略;

常用event

"plusready": 扩展API加载完成事件
"pause": 运行环境从前台切换到后台事件
"resume": 运行环境从后台切换到前台事件
"netchange": 设备网络状态变化事件
"newintent": 新意图事件
"plusscrollbottom": 窗口滚动到底部事件
"error": 页面加载错误事件
"background": 应用切换到后台运行事件
"foreground": 应用切换到前台运行事件
"trimmemory": 应用需要清理内存事件
"splashclosed": 应用启动界面已关闭事件

示例:点击返回键,会弹出“再按一次退出应用”:

<script type="text/javascript">
mui.plusReady(function(){
    document.addEventListener('pause',function(){
        console.log('pause');
    });
});
</script>

具体示例

<header class="mui-bar mui-bar-nav">
    <a class="mui-action-back mui-icon mui-icon-left-nav mui-pull-left"></a>
    <h1 class="mui-title">系统事件管理</h1>
</header>
<div class="mui-content mui-content-padded">
    <button type="button" id="btnErr" class="mui-btn mui-btn-blue mui-btn-block">错误页面</button>
</div>
<script src='http://libs.baidu.com/jquery/1.8.3/jquery.min.js'></script>
<script src="js/mui.min.js"></script>
<script type="text/javascript">
mui.plusReady(function(){
    document.addEventListener('pause',function(){
        console.log('pause');
    });
    document.addEventListener('resume',function(){
        console.log('resume');
    });
    document.addEventListener('netchange',function(){
        console.log(plus.networkinfo.getCurrentType());
    });
    // error事件 :error事件
    $("#btnErr").bind('tap',function(){
        mui.alert('aaa');
        mui.openWindow({
            url:'http://www.1234567.com',
            style:{
                errorPage:'error.html'
            }
        });
    });
});
</script>