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

写在前面

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

webview 基本知识

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

什么是窗口?什么是 webview?

这里我们首先来举个例子,大家都用过浏览器,常用的浏览器可以打开多个网页。电脑屏幕就是一个窗口,不同的页面我们可以什么是不同的 webview,我们可以通过控制 webview 的切换从而控制浏览不同的页面。

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

首先我们现在 html5plus 官网看一下**webview API 文档**,这里我们重点看一下下面几个方法:

创建新的 Webview 窗口

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

说明: 创建 Webview 窗口,用于加载新的 HTML 页面,可通过 styles 设置 Webview 窗口的样式,创建完成后需要调用 show 方法才能将 Webview 窗口显示出来。

显示 Webview 窗口

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

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

隐藏 Webview 窗口

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

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

获取当前窗口的 WebviewObject 对象

WebviewObject plus.webview.currentWebview();

说明: 获取当前页面所属的 Webview 窗口对象。

查找指定标识的 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一起讲解。

mui-demo 仓库地址:

https://github.com/zhaomenghuan/mui-demo

写这些代码也许就一两个小时的事,写一篇大家好接受的文章需要几天的酝酿,如果文章对您有帮助请我喝杯咖啡吧!