mui初级入门教程(二)— html5+ webview 底部栏用法详解

文章来源:小青年原创
发布时间:2016-05-19
关键词:mui,html5+,webview
转载需标注本文原始地址: http://zhaomenghuan.github.io...javascript

写在前面

本系列文章咱们将利用mui基于网易云音乐API实现一个音乐播放器APP,同时基于环形或者融云实现聊天功能。做为本系列文章的第一篇,本文会详细讲解html5+中管理应用窗口界面的Webview模块的用法,由于是初级教程篇不过多讲解原理部分,初级用户只须要知道基本用法就能够,并使用mui.js中的组件进行页面效果展现。css

webview基本知识

Webview模块管理应用窗口界面,实现多窗口的逻辑控制管理操做。经过plus.webview可获取应用界面管理对象。html

什么是窗口?什么是webview?

这里咱们首先来举个例子,你们都用过浏览器,经常使用的浏览器能够打开多个网页。电脑屏幕就是一个窗口,不一样的页面咱们能够什么是不一样的webview,咱们能够经过控制webview的切换从而控制浏览不一样的页面。前端

对于咱们这里就是一个html页面就是一个窗口,一个html页面能够建立多个webview。这个webview是原生APP中浏览网页的组件,android和iOS都有,html5plus中的webview是对原生webview的封装,能够用js进行调用,因此它的运行环境是APP环境,普通浏览器不支持。html5

首先咱们如今html5plus官网看一下webview API文档,这里咱们重点看一下下面几个方法:java

建立新的Webview窗口

WebviewObject plus.webview.create( url, id, styles, extras );

说明:

建立Webview窗口,用于加载新的HTML页面,可经过styles设置Webview窗口的样式,建立完成后须要调用show方法才能将Webview窗口显示出来。jquery

显示Webview窗口

void plus.webview.show( id_wvobj, aniShow, duration, showedCB, extras );

说明:

显示已建立或隐藏的Webview窗口,需先获取窗口对象或窗口id,并可指定显示窗口的动画及动画持续时间。android

隐藏Webview窗口

void plus.webview.hide( id_wvobj, aniHide, duration, extras );

说明:

根据指定的WebviewObject对象或id隐藏Webview窗口,使得窗口不可见。git

获取当前窗口的WebviewObject对象

WebviewObject plus.webview.currentWebview();

说明:

获取当前页面所属的Webview窗口对象。github

查找指定标识的WebviewObject窗口

WebviewObject plus.webview.getWebviewById( id );

说明:

在已建立的窗口列表中查找指定标识的Webview窗口并返回。 若没有查找到指定标识的窗口则返回null,若存在多个相同标识的Webview窗口,则返回第一个建立的Webview窗口。 若是要获取应用入口页面所属的Webview窗口,其标识为应用的%APPID%,可经过plus.runtime.appid获取。

建立并打开Webview窗口

WebviewObject plus.webview.open( url, id, styles, aniShow, duration, showedCB );

说明:

建立并显示Webview窗口,用于加载新的HTML页面,可经过styles设置Webview窗口的样式,建立完成后自动将Webview窗口显示出来。

以上来源于html5plus文档,只列举了部分最经常使用的方法,旨在为后文作铺垫,因为不是文档,因此也得也不清楚,若是想详细了解请看这里html5plus webview API

mui双webview模式

首先咱们要了解mui为了解决窗体切换白屏和区域滚动提出的双webview模式。

页面初始化

mui框架将不少功能配置都集中在mui.init方法中,要使用某项功能,只须要在mui.init方法中完成对应参数配置便可,目前支持在mui.init方法中配置的功能包括:建立子页面、关闭页面、手势事件配置、预加载、下拉刷新、上拉加载、设置系统状态栏背景颜色。mui须要在页面加载时初始化不少基础控件,如监听返回键,所以务必在每一个页面中调用.

如下是能够配置的参数:

mui.init({
    //子页面
    subpages: [{
        //...
    }],
    //预加载
    preloadPages:[
        //...
     ],
    //下拉刷新、上拉加载
     pullRefresh : {
       //...
    },
    //手势配置
      gestureConfig:{
       //...
    },
    //侧滑关闭
    swipeBack:true, //Boolean(默认false)启用右滑关闭功能

    //监听Android手机的back、menu按键
    keyEventBind: {
        backbutton: false,  //Boolean(默认truee)关闭back按键监听
        menubutton: false   //Boolean(默认true)关闭menu按键监听
    },
    //处理窗口关闭前的业务
    beforeback: function() {
        //... //窗口关闭前处理其余业务详情点击 ↑ "关闭页面"连接查看
    },
    //设置状态栏颜色
    statusBarBackground: '#9defbcg', //设置状态栏颜色,仅iOS可用
    preloadLimit:5//预加载窗口数量限制(一旦超出,先进先出)默认不限制
})

app开发中,若要使用HTML5+扩展api,必须等plusready事件发生后才能正常使用,mui将该事件封装成了mui.plusReady()方法,涉及到HTML5+api,建议都写在mui.plusReady方法中。

以下为打印当前页面URL的示例:

mui.plusReady(function(){
     console.log("当前页面URL:"+plus.webview.currentWebview().getURL());
});

建立子页面

在mobile app开发过程当中,常常遇到卡头卡尾的页面,此时若使用局部滚动,在android手机上会出现滚动不流畅的问题; mui的解决思路是:将须要滚动的区域经过单独的webview实现,彻底使用原生滚动。具体作法则是:将目标页面分解为主页面和内容页面,主页面显示卡头卡尾区域,好比顶部导航、底部选项卡等;内容页面显示具体须要滚动的内容,而后在主页面中调用mui.init方法初始化内容页面。

mui.init({
    subpages:[{
      url:your-subpage-url,//子页面HTML地址,支持本地地址和网络地址
      id:your-subpage-id,//子页面标志
      styles:{
        top:subpage-top-position,//子页面顶部位置
        bottom:subpage-bottom-position,//子页面底部位置
        width:subpage-width,//子页面宽度,默认为100%
        height:subpage-height,//子页面高度,默认为100%
        ......
      },
      extras:{}//额外扩展参数
    }]
  });

参数说明:

styles:表示窗口属性,参考5+规范中的WebviewStyle;特别注意,height和width两个属性,即便不设置,也默认按100%计算;所以若设置了top值为非"0px"的状况,建议同时设置bottom值,不然5+ runtime根据高度100%计算,可能会形成页面真实底部位置超出屏幕范围的状况;left、right同理。

示例:Hello mui的首页其实就是index.html加list.html合并而成的,以下:

index.html的做用就是显示固定导航,list.html显示具体列表内容,列表项的滚动是在list.html所在webview中使用原生滚动,既保证了滚动条不会穿透顶部导航,符合app的体验,也保证了列表流畅滚动,解决了区域滚动卡顿的问题。 list.html就是index.html的子页面,建立代码比较简单,以下:

mui.init({
    subpages:[{
      url:'list.html',
      id:'list.html',
      styles:{
        top:'45px',//mui标题栏默认高度为45px;
        bottom:'0px'//默认为0px,可不定义;
      }
    }]
});

打开新页面

web app,一个没法避开的问题就是转场动画;web是基于连接构建的,从一个页面点击连接跳转到另外一个页面,若是经过有刷新的打开方式,用户要面对一个空白的页面等待;若是经过无刷新的方式,用Javascript移入DOM节点(常见的SPA解决方案),会碰到很高的性能挑战:DOM节点繁多,页面太大,转场动画不流畅甚至致使浏览器崩溃; mui的解决思路是:单webview只承载单个页面的dom,减小dom层级及页面大小;页面切换使用原生动画,将最耗性能的部分交给原生实现。

mui.openWindow({
    url:new-page-url,
    id:new-page-id,
    styles:{
      top:newpage-top-position,//新页面顶部位置
      bottom:newage-bottom-position,//新页面底部位置
      width:newpage-width,//新页面宽度,默认为100%
      height:newpage-height,//新页面高度,默认为100%
      ......
    },
    extras:{
      .....//自定义扩展参数,能够用来处理页面间传值
    },
    createNew:false,//是否重复建立一样id的webview,默认为false:不重复建立,直接显示
    show:{
      autoShow:true,//页面loaded事件发生后自动显示,默认为true
      aniShow:animationType,//页面显示动画,默认为”slide-in-right“;
      duration:animationTime//页面动画持续时间,Android平台默认100毫秒,iOS平台默认200毫秒;
    },
    waiting:{
      autoShow:true,//自动显示等待框,默认为true
      title:'正在加载...',//等待对话框上显示的提示内容
      options:{
        width:waiting-dialog-widht,//等待框背景区域宽度,默认根据内容自动计算合适宽度
        height:waiting-dialog-height,//等待框背景区域高度,默认根据内容自动计算合适高度
        ......
      }
    }
})

参数说明:

  • styles:表示窗口参数,参考5+规范中的WebviewStyle;特别注意,heightwidth两个属性,即便不设置,也默认按100%计算;所以若设置了top值为非"0px"的状况,建议同时设置bottom值,不然5+ runtime根据高度100%计算,可能会形成页面真实底部位置超出屏幕范围的状况,leftright同理。

  • extras:新窗口的额外扩展参数,可用来处理页面间传值;例如:

var webview = mui.openWindow({
    url:'info.html',
    extras:{
        name:'mui'
    }
});
console.log(webview.name);

控制台会输出"mui"字符串;
注意:扩展参数仅在打开新窗口时有效,若目标窗口为预加载页面,则经过mui.openWindow方法打开时传递的extras参数无效。

  • createNew:是否重复建立相同id的webview;为优化性能、避免app中重复建立webview,mui v1.7.0开始增长createNew参数,默认为false;判断逻辑以下:若createNew为true,则不判断重复,每次都新建webview;若为fasle,则先计算当前App中是否已存在一样id的webview,若存在则直接显示;不然新建立并根据show参数执行显示逻辑;该参数可能致使的影响:若业务写在plusReady事件中,而plusReady事件仅首次建立时会触发,则下次再次经过mui.openWindow方法打开一样webview时,是不会再次触发plusReady事件的,此时可经过自定义事件触发;案例参考:http://ask.dcloud.net.cn/question/6514;

  • show:表示窗口显示控制。autoShow:目标窗口loaded事件发生后,是否自动显示;若目标页面为预加载页面,则该参数无效;aniShow表示页面显示动画,好比从右侧划入、从下侧划入等,具体可参考5+规范中的AnimationTypeShow

  • waiting:表示系统等待框;mui框架在打开新页面时等待框的处理逻辑为:显示等待框-->建立目标页面webview-->目标页面loaded事件发生-->关闭等待框;所以,只有当新页面为新建立页面(webview)时,会显示等待框,不然若为预加载好的页面,则直接显示目标页面,不会显示等待框。waiting中的参数:autoShow表示自动显示等待框,默认为true,若为false,则不显示等待框;注意:若显示了等待框,但目标页面不自动显示,则需在目标页面中经过以下代码关闭等待框plus.nativeUI.closeWaiting();。title表示等待框上的提示文字,options表示等待框显示参数,好比宽高、背景色、提示文字颜色等,具体可参考5+规范中的WaitingOption

示例1:Hello mui中,点击首页右上角的图标,会打开关于页面,实现代码以下:

//tap为mui封装的单击事件,可参考手势事件章节
document.getElementById('info').addEventListener('tap', function() {
  //打开关于页面
  mui.openWindow({
    url: 'examples/info.html',
    id:'info'
  });
});

因没有传入styles参数,故默认全屏显示;也没有传入show参数,故使用slide-in-right动画,新页面从右侧滑入。

示例2:从A页面打开B页面,B页面为一个须要从服务端加载的列表页面,若在B页面loaded事件发生时就将其显示出来,因服务器数据还没有加载完毕,列表页面为空,用户体验很差;可经过以下方式改善用户体验(最好的用户体验应该是经过预加载的方式)

第一步,B页面loaded事件发生后,不自动显示

//A页面中打开B页面,设置show的autoShow为false,则B页面在其loaded事件发生后,不会自动显示;
mui.openWindow({
    url: 'B.html',
    show:{
      autoShow:false
    }
});

第二步,在B页面获取列表数据后,再关闭等待框、显示B页面

//B页面onload从服务器获取列表数据;
window.onload = function(){
  //从服务器获取数据
  ....
  //业务数据获取完毕,并已插入当前页面DOM;
  //注意:若为ajax请求,则需将以下代码放在处理完ajax响应数据以后;
  mui.plusReady(function(){
    //关闭等待框
    plus.nativeUI.closeWaiting();
    //显示当前页面
    mui.currentWebview.show();
  });
}

关闭页面

mui框架将窗口关闭功能封装在mui.back方法中,具体执行逻辑是:
若当前webview为预加载页面,则hide当前webview;不然,close当前webview。

在mui框架中,有三种操做会触发页面关闭(执行mui.back方法)。

  • 点击包含.mui-action-back类的控件

  • 在页面上,向右快速滑动

  • Android手机按下back按键

hbuilder中敲mheader生成的代码块,会自动生成带有返回导航箭头的标题栏,点击返回箭头可关闭当前页面,缘由就是由于该返回箭头包含.mui-action-back类,代码以下:

<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>

若但愿在顶部导航栏以外的其它区域添加关闭页面的控件,只须要在对应控件上添加.mui-action-back类便可,以下为一个关闭按钮示例:

<button type="button" class='mui-btn mui-btn-danger mui-action-back'>关闭</button>

mui框架封装的页面右滑关闭功能,默认未启用,若要使用右滑关闭功能,须要在mui.init();方法中设置swipeBack参数,以下:

mui.init({
    swipeBack:true //启用右滑关闭功能
});

mui框架默认会监听Android手机的back按键,而后执行页面关闭逻辑; 若不但愿mui自动处理back按键,可经过以下方式关闭mui的back按键监听;

mui.init({
    keyEventBind: {
        backbutton: false  //关闭back按键监听
    }
});

除了如上三种操做外,也能够直接调用mui.back()方法,执行窗口关闭逻辑;mui.back()仅处理窗口逻辑,若但愿在窗口关闭以前再处理一些其它业务逻辑,则可将业务逻辑抽象成一个具体函数,而后注册为mui.init方法的beforeback参数;beforeback的执行逻辑为:

执行beforeback参数对应的函数若返回false,则再也不执行mui.back()方法;不然(返回true或无返回值),继续执行mui.back()方法;

示例:从列表打开详情页面,从详情页面再返回后但愿刷新列表界面,此时可注册beforeback参数,而后经过自定义事件通知列表页面刷新数据,示例代码以下:

mui.init({
    beforeback: function(){
        //得到列表界面的webview
        var list = plus.webview.getWebviewById('list');
        //触发列表界面的自定义事件(refresh),从而进行数据刷新
        mui.fire(list,'refresh');
        //返回true,继续页面关闭逻辑
        return true;
    }
});

注意:beforeback的执行返回必须是同步的(阻塞模式),若使用nativeUI这种异步js(非阻塞模式),则可能会出现意想不到的结果;好比:经过plus.nativeUI.confirm()弹出确认框,可能用户还没有选择,页面已经返回了(beforeback同步执行完毕,无返回值,继续执行mui.back()方法,nativeUI不会阻塞js进程):在这种状况下,若要自定义业务逻辑,就须要复写mui.back方法了;以下为一个自定义示例,每次都须要用户确认后,才会关闭当前页面。

//备份mui.back,mui.back已将窗口关闭逻辑封装的比较完善(预加载及父子窗口),所以最好复用mui.back
var old_back = mui.back;
mui.back = function(){
  var btn = ["肯定","取消"];
  mui.confirm('确认关闭当前窗口?','Hello MUI',btn,function(e){
    if(e.index==0){
        //执行mui封装好的窗口关闭逻辑;
        old_back();
    }
  });
}

注意:自定义关闭逻辑时,必定要重写mui.back,不能简单经过addEventListener增长back按键监听, 由于addEventListener只会增长新的执行逻辑,老的监听逻辑依然会执行;

项目实战

这个系列的教程我准备带你们一块儿实现音乐播放器和即时通信的功能,先上图很少说:

开始的页面效果很简单,就是一个tab bar页面切换组件,咱们重点讲解实现方法,至于美化是后面的事。在开始项目以前我先抄了文档的内容,不是为了凑内容,只是想让新手在开始项目以前仍是多看看基本概念,俗话说磨刀不误砍柴工,咱们对mui的设计思路有必定了解以后写起来才能驾轻就熟。

相信你们对于mui的双webview模式有初步认识,咱们能够分析一下咱们接下来要作的这个的实际例子,首先咱们的入口文件index.html是一个包括头部和底部的导航栏的webview,中间是一个动态的webview,咱们经过点击底部导航栏进行页面切换,而且动态的改变顶部导航栏的内容。

下面咱们新建一个mui项目,这里我命名为M-BOX:

开始写布局文件

相信不少人看了前面那么多文档介绍心里确定是崩溃的,其实我也是,毕竟写了那么多尚未开始写代码我也是拒绝的,只是考虑到不少新手对于找文档这事不必定有经验,那仍是先贴一下,大不了回过头再去看咯。

好,那咱们开始写布局文件:

MUI开发注意事项这篇文章中提到了几个重要的注意事项,咱们在一个就注意一下会比较好,这里再也不一一详细列举了,读者本身去看。

文章中DOM结构提到:

  • 固定栏靠前

所谓的固定栏,也就是带有.mui-bar属性的节点,都是基于fixed定位的元素;常见组件包括:顶部导航栏(.mui-bar-nav)、底部工具条(.mui-bar-footer)、底部选项卡(.mui-bar-tab);这些元素使用时需遵循一个规则:放在.mui-content元素以前,即便是底部工具条和底部选项卡,也要放在.mui-content以前,不然固定栏会遮住部分主内容;

  • 一切内容都要包裹在mui-content中

除了固定栏以外,其它内容都要包裹在.mui-content中,不然就有可能被固定栏遮罩,缘由:固定栏基于Fixed定位,不受流式布局限制,普通内容依然会从top:0的位置开始布局,这样就会被固定栏遮罩,mui为了解决这个问题,定义了以下css代码:

.mui-bar-nav ~ .mui-content {
    padding-top: 44px;
}
.mui-bar-footer ~ .mui-content {
    padding-bottom: 44px;
}
.mui-bar-tab ~ .mui-content {
    padding-bottom: 50px;
}

咱们这里重点看这两条规则,由于这个对于咱们正确布局是相当重要的。

下面咱们体验一下hbuilder的代码块功能,在index.html文件的body之间输入mheader,回车试试。

哈哈,页面头部出来了,不错,这里咱们而后删除下面的:

<a class="mui-action-back mui-icon mui-icon-left-nav mui-pull-left"></a>

先去掉返回箭头。

而后继续输入mtab,回车,底部导航栏也出来了,咱们修改一下导航栏的内容,把代码稍微调整一下。
总体代码以下:

<!DOCTYPE html>
<html>
<head>
        <meta charset="utf-8">
        <meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no" />
        <title>M-BOX</title>
        <link href="css/mui.min.css" rel="stylesheet"/>
</head>
<body>
    <header class="mui-bar mui-bar-nav">
            <h1 class="mui-title">标题</h1>
    </header>
    <nav class="mui-bar mui-bar-tab">
            <a class="mui-tab-item mui-active" href="html/home.html">
                    <span class="mui-icon mui-icon-home"></span>
                    <span class="mui-tab-label">首页</span>
            </a>
            <a class="mui-tab-item" href="html/message.html">
                    <span class="mui-icon mui-icon-chatboxes"></span>
                    <span class="mui-tab-label">消息</span>
            </a>
            <a class="mui-tab-item" href="html/setting.html">
                    <span class="mui-icon mui-icon-gear"></span>
                    <span class="mui-tab-label">设置</span>
            </a>
    </nav>
    <script src="js/mui.min.js"></script>;
    <script type="text/javascript" charset="utf-8">
     // 初始化mui.init()写在这里
    </script>
</body>
</html>

首页的静态布局咱们写完了,咱们接下来新建三个含mui的html文件:

  • 选择工程名,邮件就能够看到【新建】,而后就是选择【目录】新建文件夹和【html文件】新建含mui的html文件。咱们新建一个文件夹html,而且在html文件夹下新建,home.htmlmessage.html,setting.html

  • 在三个页面body之间分别输入mbody,就能够开始分别写页面了,好比能够先在页面上写上文件名,咱们先来完善首页的子页切换逻辑。

动态页面切换

1.建立子页面,首个选项卡页面显示,其它均隐藏;

主要方法就是用plus.webview.createplus.webview.hide();

//设置默认打开首页显示的子页序号;
var Index=0;
//把子页的路径写在数组里面
var subpages = ['html/home.html','html/message.html','html/setting.html'];

//全部的plus-*方法写在mui.plusReady中或者后面。
mui.plusReady(function() {
    //获取当前页面所属的Webview窗口对象
    var self = plus.webview.currentWebview();
    for (var i = 0; i < 3; i++) {
        //建立webview子页
        var sub = plus.webview.create(
            subpages[i], //子页url
            subpages[i], //子页id
            {
                top: '45px',//设置距离顶部的距离
                bottom: '50px'//设置距离底部的距离
            }
        );
        //如不是咱们设置的默认的子页则隐藏,不然添加到窗口中
        if (i != Index) {
            sub.hide();
        }
    //将webview对象填充到窗口
        self.append(sub);
    }
});

注:若是Index不是0,须要将nav下的a标签中的.mui-active属性写到对应的a标签下。

执行完咱们会发现home.html的内容显示出来了,可是底部切换还不能,由于这里咱们尚未监听底部的点击事件。在进行下一步以前,咱们能够先作一个小实验,将上面的代码中的top或者bottom改成0,咱们会发现,底部栏或者底部栏会被覆盖,这是由于mui一个重要的潜规则父子结构的页面子页面会比父页面层级高,说白了就是子页面能够盖住父页面。这会致使开发者常犯的一个错误:将弹出层或者弹出菜单写在父页面被子页面盖住的bug。

这里的apend()方法在html5plus文档中没有提到,这里的这个方法是将webview对象填充到窗口的方法。

2.选项卡点击事件

mui 内部封装了一些经常使用的方法,其中DOM选择器、事件绑定等事件管理。具体能够参考文档:选择器事件管理

mui()

mui使用css选择器获取HTML元素,返回mui对象数组。

  • mui("p"):选取全部p元素

  • mui("p.title"):选取全部包含.title类的<p>元素

若要将mui对象转化成dom对象,可以使用以下方法(相似jquery对象转成dom对象):

//obj1是mui对象
var obj1 = mui("#title");
//obj2是dom对象
var obj2 = obj1[0];

.on( event , selector , handler )

  • event

    • Type: String

    • 需监听的事件名称,例如:'tap'

  • selector

    • Type: String
      -选择器

  • handler

    • Type: Function( Event event )

    • 事件触发时的回调函数,经过回调中的event参数能够得到事件详情

除了可使用addEventListener()方法监听某个特定元素上的事件外, 也可使用.on()方法实现批量元素的事件绑定。

这里咱们将为底部导航按钮添加事件:

//选项卡点击事件
mui('.mui-bar-tab').on('tap', 'a', function(e) {
    alert(true);
});

当咱们点击底部选项卡的时候会弹出true,这不够,咱们要可以分辨当前对象具体是哪个,有两种思路:

  • 第一咱们可以知道当前点击的a标签所在序号就行了,就是找到index,而后根据上面那个subpages数组,利用plus.webview.show(subpages[index])方法显示。

  • 咱们给当前点击的a标签添加一个能够识别的属性,而后根据那个属性获取当前a的特征,而后就能够显示点击的子页,隐藏当前子页。

第一种方法须要遍历此案获取index,第二种方法添加一个href很容易拿到子页id,咱们采用第二种方案。

getAttribute()

getAttribute() 方法返回指定属性名的属性值。
提示:若是您但愿以 Attr 对象返回属性,请使用 getAttributeNode。

因而咱们能够这样写:

//当前激活选项
var activeTab = subpages[Index],title=document.querySelector(".mui-title");
//选项卡点击事件
mui('.mui-bar-tab').on('tap', 'a', function(e) {
    //获取目标子页的id
    var targetTab = this.getAttribute('href');
    if (targetTab == activeTab) {
        return;
    }
    //更换标题
    title.innerHTML = this.querySelector('.mui-tab-label').innerHTML;
    //显示目标选项卡
    plus.webview.show(targetTab);
    //隐藏当前选项卡
    plus.webview.hide(activeTab);
    //更改当前活跃的选项卡
    activeTab = targetTab;
});

兼容浏览器的处理办法

这是后面补充的内容,最开始写的时候没有这个内容,在这里加上吧。为啥要加这个内容呢,由于不少人思惟仍是比较局限,用mui依然仍是用原来的方法,有不少人依然使用href,之因此这么用就是你们改不了习惯,这就是被不少人说的坑。。。可是真的是坑吗?与其说是坑,我以为是你们思惟上没有转变过来,不明白mui为啥要禁用href这种方式,也不明白本身该怎么作。

下面贴出一个用iframe代替多子webview形式的tabbar在浏览器的兼容处理方法:

var createIframe = function (el, opt) {
    var elContainer = document.querySelector(el);
    var wrapper = document.querySelector(".mui-iframe-wrapper");
    if(!wrapper){
        // 建立wrapper 和 iframe
        wrapper = document.createElement('div');
        wrapper.className = 'mui-iframe-wrapper';
        for(var i in opt.style){
            wrapper.style[i] = opt.style[i];
        }
        var iframe = document.createElement('iframe');
        iframe.src = opt.url;
        iframe.id = opt.id || opt.url;
        iframe.name = opt.id;
        wrapper.appendChild(iframe);
        elContainer.appendChild(wrapper);
    }else{
        var iframe = wrapper.querySelector('iframe');
        iframe.src = opt.url;
        iframe.id = opt.id || opt.url;
        iframe.name = iframe.id;
    }
}

调用也很简单:

//当前激活选项
var activeTab = subpages[Index],title=document.querySelector(".mui-title");
mui('.mui-bar-tab').on('tap', 'a', function(e) {
    // 获取目标子页的id
    var targetTab = this.getAttribute('href');
    if (targetTab == activeTab) {
        return;
    }        
    // 更换标题
    title.innerHTML = this.querySelector('.mui-tab-label').innerHTML;    
    // 子页内容切换
    if(mui.os.plus){
        // 显示目标webview
        plus.webview.show(targetTab);
        // 隐藏当前webview
        plus.webview.hide(activeTab);
        // 更改当前活跃的选项卡
        activeTab = targetTab;
    }else{
        // 建立iframe代替子页面
        createIframe('.mui-content',{
            url: targetTab,
            style: {
                top: '45px',//设置距离顶部的距离
                bottom: '50px'//设置距离底部的距离
            }
        });
    }
})

这样你就能够一套代码实如今多平台的利用啦,是否是很棒。完整代码能够看这里:
iframe兼容处理tababr的方法

双首页配置的优化方案

HBuilder8.0.1版更新说明App中有一条:
【重要】新增双首页配置(manifest->plus->secondwebview),加速首页为双webview模式时的应用启动速度。
这对于咱们优化app颇有帮助,之前的方案中父子页面都在启动页,首页显示会过慢,8.0后的此次大更新能够很好的处理这个问题,官方配置说明见:【示例】双首页secondwebview配置的使用,可是官方文档中没有说明父子页的配置方法,这里给出一种方案:

1.按照文档配置manifest.json文件中的secondwebview节点
2.将动态建立子页面放在点击事件中,例如:

manifest.json文件:

...
"secondwebview": {
    "launch_path": "_www/html/home.html",
    "id": "html/home.html",
    "top": "0px",
    "bottom": "51px"
}
...

首页的逻辑:

var subpages = ['html/home.html', 'html/message.html', 'html/person.html'];
var subpage_style = {
    top: '0px',
    bottom: '51px'
};
// 当前激活选项
var activeTab = subpages[0];

// 建立子页面,首个选项卡页面显示,其它均隐藏;
var currentWebview;
mui.plusReady(function() {
    currentWebview = plus.webview.currentWebview();
    var secondWebview = plus.webview.getSecondWebview();
    currentWebview.append(secondWebview);
});

// 选项卡点击事件
mui('.mui-bar-tab').on('tap', 'a', function(e) {
    var targetTab = this.getAttribute('href');
    if (targetTab == activeTab) {
        return;
    }
    
    var targetWebview = plus.webview.getWebviewById(targetTab);
    if(!targetWebview){
        targetWebview = plus.webview.create(targetTab, targetTab, subpage_style);
        currentWebview.append(targetWebview );
    }
    targetWebview.show("fade-in",300);
    // 隐藏当前;
    plus.webview.hide(activeTab);
    // 更改当前活跃的选项卡
    activeTab = targetTab;
});

后记

虽然最后实现的效果很简单,好像直接看demo就能够写出来,可是新手甚至写了一段时间的同窗也不见得对webview掌握得很好,这篇文章花了很长的篇幅去讲解webview的用法,旨在为新手创建一种学习mui这边的思路,那就是先看html5plus里面的模块,而后看mui对应的文档,最后看hello muidemo,把握这种学习路线我的以为是一种最佳的方案。本文做为系列文章第一篇讲代码的,因此作了不少铺垫,因此有必定基础的同窗可能会以为写得并无什么看点,后面的确定会有所不同的。下一篇讲解的是网络请求XMLHttpRequest模块,下一讲会结合mui.ajax和网易云音乐API一块儿讲解。

文章原始地址是我博客地址:

http://zhaomenghuan.github.io

mui-demo仓库地址:

https://github.com/zhaomenghu...

写文章不容易,也许写这些代码就几分钟的事,写一篇你们好接受的文章或许须要几天的酝酿,而后加上几天的码字,累并快乐着。若是文章对您有帮助请我喝杯咖啡吧!

clipboard.png


近期在segmentfault讲堂开设了一场关于html5+ App开发工程化实践之路的讲座,欢迎前来围观:https://segmentfault.com/l/15...

相关文章
相关标签/搜索