MUI框架开发HTML5手机APP(二)--页面跳转传值&底部选项卡切换

  概 述

JRedu

　　在上一篇博客中，我们学习了如何使用Hbuilder创建一个APP，同时如何使用MUI搭建属于自己的第一款APP，没有学习的同学可以戳链接学习：   

　　今天这篇博客，我们继续深入学习MUI框架，主要学习这几个方面：加载子页面、页面跳转并传值，底部选项卡的多种实现方式。

一、MUI加载子页面

 

1加载子页面详解

在mobile app开发过程中，经常遇到卡头卡尾的页面，也就是说头部和尾部保持不动，而只有中间区域可以滚动，常见的就是新闻列表与详情页等情况：

如上图所示，头部和尾部不会跟着滚动，而是只有中间列表区域正常滚动。但这种局部滚动，在android手机上会出现滚动不流畅的问题；

针对这个问题，mui的解决思路是：将需要滚动的区域通过单独的webview实现，完全使用原生滚动。也就是说，将页面分为主页面和子页面两部分，主页面只有头部和尾部，而需要滚动的区域放置到子页面中，并在mui.init()方法中加载。大约就是这么一个效果：

 

 

 

2加载子页面的实现

在上篇博客中，我们介绍了mui.init()方法，这个方法主要用于mui页面的初始化，进行页面加载时的各种配置，接受一个对象类型的参数。

那么，在mui中加载子页面非常简单，只需要对象中传入subpages属性，用数组格式表示多个页面，subpages数组的格式要求如下：

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:{}//额外扩展参数
    }]
  });

具体的实现步骤如下：

① 新建主页面，只保留头部和尾部

主页面中输入mHeader、mfooter即可快速生成头尾

        <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>
        
        
        <nav class="mui-bar mui-bar-tab">
            <a class="mui-tab-item mui-active">
                <span class="mui-icon mui-icon-home"></span>
                <span class="mui-tab-label">首页</span>
            </a>
            <a class="mui-tab-item">
                <span class="mui-icon mui-icon-phone"></span>
                <span class="mui-tab-label">电话</span>
            </a>
            <a class="mui-tab-item">
                <span class="mui-icon mui-icon-email"></span>
                <span class="mui-tab-label">邮件</span>
            </a>
            <a class="mui-tab-item">
                <span class="mui-icon mui-icon-gear"></span>
                <span class="mui-tab-label">设置</span>
            </a>
        </nav>

② 新建子页面，承载一个列表页

子页面中输入mList，即可快速生成一个列表页面。注意子页面中无需头部尾部，也无需将内容包裹在mBody中。

        <ul class="mui-table-view">
            <li class="mui-table-view-cell">
                <a class="mui-navigate-right">
                    Item 1
                </a>
            </li>
            <li class="mui-table-view-cell">
                <a class="mui-navigate-right">
                     Item 2
                </a>
            </li>
            。。。。。。
        </ul>

③ 主页面的mui.init()方法中加载子页面

mui.init({
    /* 在页面的指定位置，加载子页面，实现卡头卡尾的效果 */
    subpages:[{
      url:"0101-ziye.html",//子页面HTML地址，支持本地地址和网络地址
      id:"0101-ziye.html",//子页面标志
      styles:{
        top:"45px",//子页面顶部位置(顶部选项卡默认高度45px)
        bottom:"51px",//子页面底部位置(顶部导航栏默认高度51px)
        //width:100%,//子页面宽度，默认为100%
        //height:100%,//子页面高度，默认为100%
      },
//    extras:{}//额外扩展参数,页面传值时使用
    }]
})

上述配置代码的详细解释已经在注释中说明，大家按照注释内容配置即可，其中extras:{}用于页面间传值使用，下个章节讲解。

 

二、 页面间跳转并传值

 

1页面间跳转传值概述

在移动APP中，页面之间的跳转传值是非常常用的，一种典型的应用就是从新闻列表页点击每一条新闻，将新闻的id传递到详情页显示，例如下述情况：

在这里需要强调一下，虽然我们使用MUI制作的APP也是有网页组成，但是页面之间跳转尽量不要使用超链接标签<a></a>进行跳转，MUI给我们提供了更加好用而且性能更优的方式：mui.openWindow()，这个函数我们在上篇博客中已经使用过，此处不再赘述。

但是从效果图可以看到，我们从列表页跳转到详情页时，标题上面的内容也在发生着变化，那么我们就需要用到另一个函数：mui.openWindowWithTitle()，这个方法是对mui.openWindow()的扩展，支持nativeObj绘制标题栏,加快页面展现。

 

2mui.openWindowWithTitle()介绍

 

这个函数是对mui.openWindow()的扩展，因此mui.openWindow()方法需要配置的参数，在这个方法中依然支持，同时这个方法要求传入一个新对象，表示对标题栏的配置：

mui.openWindowWithTitle({
        // mui.openWindow()方法的各种配置项，依然写在这里
},{
    title:{//标题配置
        text:"",//标题文字
    },
    back:{//左上角返回箭头
        image:{//图片格式
            base64Data:''//加载图片的Base64编码格式数据 base64Data 和 imgSRC 必须指定一个.否则不显示返回箭头
        }
    }
})

 

3列表页打开详情页，并传值

 

要实现页面之间的跳转传值，首先要为列表页的所有list添加点击事件，并获取到每个list的id，同时将ID传入到详情页。 当然，这些操作都需要在mui.plusReady方法中写入：

mui.plusReady(function(){
    var arr = document.getElementsByTagName("a");
for(var i=0; i<arr.length; i++){
    !function(i){
        arr[i].addEventListener("tap",function(){
            mui.openWindowWithTitle({
                url:"0102-detail.html",
                id:"0102-detail.html",
                styles:{
                },
                extras:{
                    // 打开页面的同时，向新页面传递数据。
                    newsId : i
                }
            },{
                //标题栏的背景色和底边线配置
                backgroundColor:"#C9302C",
                //bottomBorderColor:"#00ff00",
                title:{
                    //标题文字的内容和样式配置
                    text:"新闻详情"+(i+1),
                    styles:{
                        color:"#FFFFFF",
                        align:"center",
                        family:"'Helvetica Neue',Helvetica,sans-serif",
                        size:"20px",
                        style:"normal",
                        weight:"bold",
                    }
                },
                back:{
                    image:{
                /*返回箭头图片可以使用imgSrc，也可以使用base64编码*/
                        //imgSrc:"img/back.png"
                        base64Data:"data:image/png;base64,……"
                    }
                }
            })
        })
    }(i);
}
}）；    

这里面，除了mui.openWindowWithTitle()之外，还有一个重要的代码：

extras:{
    // 打开页面的同时，向新页面传递数据。
    newsId : i
}

这就是页面之间传值的关键所在，使用extras对象，将我们需要传递给新页面的数据以键值对的形式送达。

  

4详情页接受列表页传值

 

当列表页当id传给详情页以后，详情页接受就很简单了，只需要先取到当前详情页的WebView，并从当前WebView中取到传过来的newsId：

mui.plusReady(function(){
    // 取到当前的webview
    //var slef = plus.webview.currentWebview();
    
    // 通过webview的id，获取指定的webview
    var slef = plus.webview.getWebviewById("0102-detail.html");
    
    document.getElementById("num").innerText = slef.newsId+1;
})

上述代码可以看到，取到当前WebView的方式有两种，一种是直接取到当前WebView，一种是使用WebView的id获得指定的WebView。 不管哪种方式取到，拿到WebView以后，就可以直接以键取值。

 

三、底部选项卡切换页面

 

底部选项卡的切换，可以说是APP的标志之一。 几乎主流的所有APP，都会在底部有多个选项卡，可以点击切换不同页面。而这个功能，MUI也很友好的给我们提供了两种方式：DIV模式和WebView模式。两种模式的显示效果差不多，如下图可见：

 

1两种模式的区别

 

顾名思义，DIV模式是将所有子页面的内容，分别放置到主页不同的DIV中，当我们点击主页的不同选项卡时，切换不同DIV的显示。 这种方式显然要比加载子页的方式快很多，但是也显然不能承载很多布局的页面，毕竟要在一个主页中写入所有子页面的代码，显得不太现实。

而WebView模式则是将所有子页面都写入到不同的子页面中，再通过主页连接到一起，点击不同的选项卡 ，加载不同的子页面，显然这种方式更符合我们的预期和要求。

 

2底部选项卡切换(DIV模式)

 

DIV模式的选项卡切换非常的简单，无需一行JS代码，直接使用HTML代码即可实现代码的切换：

        <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">底部选项卡切换(Div模式)</h1>
        </header>
        
        <nav class="mui-bar mui-bar-tab">
            <a class="mui-tab-item mui-active" href="#page1">
                <span class="mui-icon mui-icon-home"></span>
                <span class="mui-tab-label">首页</span>
            </a>
            <a class="mui-tab-item" href="#page2">
                <span class="mui-icon mui-icon-phone"></span>
                <span class="mui-tab-label">电话</span>
            </a>
            <a class="mui-tab-item" href="#page3">
                <span class="mui-icon mui-icon-email"></span>
                <span class="mui-tab-label">邮件</span>
            </a>
            <a class="mui-tab-item" href="#page4">
                <span class="mui-icon mui-icon-gear"></span>
                <span class="mui-tab-label">设置</span>
            </a>
        </nav>
        
        
        <div class="mui-content">
            <div id="page1" class="mui-control-content mui-active">
                这是第一个页面
            </div>
            <div id="page2" class="mui-control-content">
                这是第二个页面
            </div>
            <div id="page3" class="mui-control-content">
                这是第三个页面
            </div>
            <div id="page4" class="mui-control-content">
                这是第四个页面
            </div>
        </div>

代码解释：

这种方式的实现，只需要给代表每个子页面的div，添加mui-control-content类即可，同时用mui-active表示默认加载的第一个子页。

写好子页DIV后，给每个div起一个id，并且将这个id与底部选项卡中的每个a标签的href属性相关联，即可实现选项卡的切换。

 

3底部选项卡切换(WebView模式)

 

使用WebView模式的选项卡切换，首先需要创建多个子页面的HTML文件，而主页中，只需要头部和尾部即可，其他功能交给JS操作：

<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" id="title">首页</h1>
        </header>
        
        <nav class="mui-bar mui-bar-tab">
            <a id="defaultTab" class="mui-tab-item mui-active" href="a.html">
                <span class="mui-icon mui-icon-home"></span>
                <span class="mui-tab-label">首页</span>
            </a>
            <a class="mui-tab-item" href="b.html">
                <span class="mui-icon mui-icon-email"></span>
                <span class="mui-tab-label">消息</span>
            </a>
            <a class="mui-tab-item" href="c.html">
                <span class="mui-icon mui-icon-contact"></span>
                <span class="mui-tab-label">通讯录</span>
            </a>
            <a class="mui-tab-item" href="d.html">
                <span class="mui-icon mui-icon-gear"></span>
                <span class="mui-tab-label">设置</span>
            </a>
        </nav>

HTML代码的简洁，必然造成JS代码的相对复杂，但是也很简单，大家使用粘贴复制大法即可：

        var subpages = ['a.html', 'b.html', 'c.html', 'd.html'];
        var subpage_style = {
            top: '45px',
            bottom: '51px'
        };
            
        var aniShow = {};
            
         //创建子页面，首个选项卡页面显示，其它均隐藏；
        mui.plusReady(function() {
            var self = plus.webview.currentWebview();
            for (var i = 0; i < 4; i++) {
                var temp = {};
                var sub = plus.webview.create(subpages[i], subpages[i], subpage_style);
                if (i > 0) {
                    sub.hide();
                }
            /* 让新创建的webview，追加合并到当前的窗口上。合并成一个窗口。
                * 目的：将父子窗口合并成一个页面，实现同开同关的效果。 避免点击返回安监室，子页面先关闭，而父页面的头部和尾部没有关闭的BUG。
             */
                self.append(sub);
            }
        });
         //当前激活选项
        var activeTab = subpages[0];
        var title = document.getElementById("title");
        //选项卡点击事件
        mui('.mui-bar-tab').on('tap', 'a', function(e) {
            var targetTab = this.getAttribute('href');
                
            if (targetTab == activeTab) {
                return;
            }
            //更换标题
            title.innerHTML = this.querySelector('.mui-tab-label').innerHTML;
            //显示目标选项卡
            //若为iOS平台或非首次显示，则直接显示
            if(mui.os.ios||aniShow[targetTab]){
                plus.webview.show(targetTab);
            }else{
                //否则，使用fade-in动画，且保存变量
                var temp = {};
                temp[targetTab] = "true";
                mui.extend(aniShow,temp);
                plus.webview.show(targetTab,"fade-in",300);
            }
            //隐藏当前;
            plus.webview.hide(activeTab);
            //更改当前活跃的选项卡
            activeTab = targetTab;
    });

每一行代码的详细作用，均已在代码注释中详细说明 ，但是对于很多新手同学，可能理解起来依然存在一定的问题，所以贴心的杰小瑞老师准备了极大程度的简化版本。

 

4底部选项卡切换(杰小瑞老师简化版)

 

上面的代码虽然功能强大，但是代码杂乱，很不容易理解，我们可以在保留原来的HTML的基础上，将JS代码进行极大程度的简化处理：

mui.plusReady(function(){
    var pages = ["a.html","b.html","c.html","d.html"];
    var arr = document.getElementsByClassName("mui-tab-item")
    var styles = {
        top:"45px",
        bottom:"51px"
    }
    var pageArr = [];
    var slef = plus.webview.currentWebview();
    for(var i=0; i<arr.length; i++){
        // 有几个选项卡，需要创建几个子页面
        var page = plus.webview.create(pages[i],pages[i],styles);
        pageArr.push(page);
        !function(i){
            arr[i].addEventListener("tap",function(){
                // 让当前页面(i)显示，不是当前页面隐藏
                for(var j=0; j<pageArr.length; j++){
                    if(j!=i) pageArr[j].hide();
                    else pageArr[j].show();
                }
                /* 让新创建的webview，追加合并到当前的窗口上。合并成一个窗口。
                 * 目的：将父子窗口合并成一个页面，实现同开同关的效果。 避免点击返回安监室，子页面先关闭，而父页面的头部和尾部没有关闭的BUG。
                 */
                slef.append(pageArr[i]);
            })
        }(i);
    }
    // 默认触发第0个选项卡的tap事件。
    mui.trigger(arr[0],"tap");
});

 

怎么样，代码是不是简洁很多了呢？一起来看看最终效果吧！！

 

　　好了，今天的内容就先到这了，下篇博客让我们继续探讨MUI的更高级功能吧！由于博客描述有限，使用过程中有任何问题，欢迎评论留言讨论哦~~

　　

　　如果需要源码，请点击进行下载。

 

作者：杰瑞教育
出处： 
版权声明：本文版权归烟台科技有限公司和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。
技术咨询：