欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

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

程序员文章站 2022-12-19 19:14:47
在上一篇博客中,我们学习了如何使用Hbuilder创建一个APP,同时如何使用MUI搭建属于自己的第一款APP,今天这篇博客,我们继续深入学习MUI框架,主要学习这几个方面:加载子页面、页面跳转并传值,底部选项卡的多种实现方式。 ......

  概 述

JRedu

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

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


一、MUI加载子页面

 

1加载子页面详解

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

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

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

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

 

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

 

 

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框架开发HTML5手机APP(二)--页面跳转传值&底部选项卡切换

在这里需要强调一下,虽然我们使用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模式。两种模式的显示效果差不多,如下图可见:

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

 

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框架开发HTML5手机APP(二)--页面跳转传值&底部选项卡切换

 

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

  

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

 

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