MUI框架开发HTML5手机APP

出处：http://www.cnblogs.com/jerehedu/p/7832808.html

前言

JRedu

　随着HTML5的不断发展，移动开发成为主流趋势！越来越多的公司开始选择使用HTML5开发手机APP，而随着手机硬件设备配置的不断提升，各种开发框架的不断优化，也使着H5开发的混合APP的体验越来越趋于原生！那么在本系列博客中，我们就来一探H5开发APP的神秘面纱吧~~

一、移动APP项目搭建

由于我们的H5编写的都是一个个网页，需要使用浏览器打开才能使用，这显然不是APP的使用方式。那么我们才能将一个手机网站，封装成一个APP呢？时下热门的Cordova、PhoneGap、appMobi、WeX5等…都是主流的构建APP工具！但是这些工具有一个共同的特点——使用麻烦！！

所以，我们介绍一种最简便的构建的方式，使用HBuilder一键打包！HBuilder是数字天堂旗下的一款前端开发IDE，其功能强大远超你想象，我们使用的MUI框架，HTML5+框架，都是数字天堂旗下产品，Hbuilder+MUI这对好基友，简直就是绝配！

HBuilder下载地址：http://www.dcloud.io/ ，下载完成后傻瓜式安装即可。

1使用HBuilder新建移动APP项目

HBuilder安装成功以后，就可以新建一个移动APP项目啦！点击“文件—>新建—>移动APP”,输入你的项目名称，就可以搭建完成一个移动APP项目啦！

项目的目录结构如下：

2manifest.json文件介绍

项目目录中的css/img/js/html等文件就不一一赘述了，建好项目后我们需要新增页面只需要新建HTML文件即可，与开发手机网站的操作一模一样。

而这里面最重要的应该就是manifest.json这个文件了，这个文件几乎包含了我们APP的所有设置，双击打开，可以看到这个界面：

底部的选项卡可以看到，这里面包含了我们APP的名称、版本号、首页文件、应用的图标、应用的启动图片以及我们需要的各种SDK。大家可以根据自己的需求自行设置，此处不再一一赘述。

二、APP程序的打包与调试

在上面的操作中，我们搭建了一款属于自己的移动APP项目，那么这个项目怎么运行调试，又是怎么打包成Android以及IOS能够安装的APP呢？

1将项目打包成APP

首先，我们来看一下如何和将项目打包成一个能够安装的应用程序，这是Hbuilder最便捷的一步，也是杰小瑞老师选择Hbuilder这款IDE的主要原因之一。

选中项目，点击Hbuilder顶部导航栏的“发行—>发行为原生安装包”，可以看到如下页面：

点击打包，就可以在不需要Xcode和 Android SDK的情况下，直接在云端打包。

打包完成后，就可以得到安卓的apk文件和苹果的ipa文件。

2直接运行调试

上面介绍的是将项目打包成应用程序，但是开发过程中，我们每个页面都要进行大量的调试测试，HBuilder也是支持的。常用的方式有多种，直接通过浏览器调试，通过手机运行调试，通过模拟器调试，都是可以。

点击运行，就可以选择调试模式啦~~此处不再赘述，如果需要可以评论留言哦！

三、MUI框架与HTML5+框架介绍

上面提到，HBuilder编辑器、MUI框架、HTML5+框架都是数字天堂公司的知名产品。那么MUI框架和HTML5+框架都是干什么的呢？

1MUI框架

MUI框架号称是“最接近原生APP体验的高性能前端框架”，当然这是官方的口号，杰小瑞老师不负责吹牛~ 官方文档地址：http://dev.dcloud.net.cn/mui/

经过我们的亲身体验，MUI框架确实对得起他的口号，当然也有很大的进步空间需要提升。但是配合HBuilder的使用，如此般顺滑的操作体验会让你不敢相信自己在敲代码。 MUI给我们提供了大量的组件，只需要在HBuilder中输入一个”m”开头，就可以同列表中选择形形色色各种组件！

选中你需要的任意一个组件，回车，一大段代码直接生成！比如我们选择第一个maccordion回车，就会直接生成一大段代码，如下：

运行之后，就可以看到一个折叠面板：

这相比于其他框架需要自己手写Class的方式，这种操作是不是顺滑到不能想象呀！麻麻再也不用担心你记不住这么多class名字了~~ 所以，MUI提供了这么多的组件，使用如此简单，我们也就不再一一讲解了。感兴趣的同学，可以进入帮助文档http://dev.dcloud.net.cn/mui/ui/ 查看所有组件。

我们后面的内容，将主要针对MUI中的页面跳转、选项卡切换、Ajax、下拉刷新&上拉加载、调取底层摄像头的功能展开讲解。

2HTML5+框架介绍

上面我们介绍了MUI框架的基本使用。也了解到了MUI的主要功能是搭建APP的页面布局所使用的框架。那么HTML5+则是增强版的手机浏览器引擎，让HTML5达到原生水平！二维码、语音输入、摇一摇、摄像头、文件系统、微信分享……等几乎你能想到的原生底层功能，HTML5+都能帮你实现。

官方给出了一句话： 40万原生API能力随意调用。功能可谓强大，可以点击进入详细了解：http://www.dcloud.io/runtime.html

后续的文章中，我们也会使用到HTML5+调用原生摄像头、写入原生文件等能力进行演示。

四、搭建第一个APP应用

介绍完了APP搭建的基本内容，我们就开始制作我们第一个移动APP吧。首先，我们为我们的APP制作一个首页。

1创建第一个首页

首先，我们应该新建一个index.html文件，注意新建的时候选择“含MUI的html文件”，这样可以帮助我们自动导入所需要的各种默认配置。

创建完成后的第一个文件，代码以及详细解释如下：

<!doctype html>
<html><head><meta charset="UTF-8"><title></title><!--设置页面的视口宽度--><meta name="viewport" content="width=device-width,initial-scale=1,minimum-scale=1,maximum-scale=1,user-scalable=no" /><!--导入页面所需要的MUI的CSS文件--><link href="css/mui.min.css" rel="stylesheet" /></head><body><!--导入页面所需要的MUI的JS文件--><script src="js/mui.min.js"></script><script type="text/javascript">// MUI页面初始化函数mui.init()</script></body>
</html>

2搭建首页HTML布局

首先，我们先在body中输入“m”选择mHead，生成头部导航栏。

<!--头部APP顶部导航栏区域-->
<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">杰瑞教育APPDemo</h1>
</header>

在导航栏下面，输入mbody，生成页面的主体部分，其实就是一个div。页面中除了Header和Footer以外的全部内容，必须包裹在body中。

<div class="mui-content"></div>

紧接着，我们在body中，输入一个mList，生成一个列表。

<ul class="mui-table-view"><li class="mui-table-view-cell"><a class="mui-navigate-right">1、页面加载子页&列表跳转详情页并传参</a></li><li class="mui-table-view-cell"><a class="mui-navigate-right">2、 底部选项卡切换(Div模式)</a></li><li class="mui-table-view-cell"><a class="mui-navigate-right">3、底部选项卡切换(WebView模式)</a></li><li class="mui-table-view-cell"><a class="mui-navigate-right">4、底部选项卡切换(自定义)</a></li><li class="mui-table-view-cell"><a class="mui-navigate-right">5、图片轮播组件</a></li><li class="mui-table-view-cell"><a class="mui-navigate-right">6、HTML5+摄像头使用</a></li><li class="mui-table-view-cell"><a class="mui-navigate-right">7、下拉刷新&上拉加载更多&Ajax</a></li>
</ul>

这里面的7个功能，也就是我们将逐一讲解的7个重要功能~！是不是剧透了呢~~生成的页面效果如下：

3为每个列表添加点击事件跳转页面

添加点击事件肯定就要用到JS啦~~先介绍几个非常常用的MUI方法。

3.1 mui.init({})

mui.init方法时MUI的初始化函数，接受一个对象参数，用于进行页面的各种配置，比如子页面的加载、页面预加载等。。。

下面的代码是利用mui.init在页面初始化时进行页面手势操作的开关：

// 初始化页面中的MUI控件mui.init({/*设置各种手势操作的开关*/gestureConfig:{tap: true, //默认为truedoubletap: true, //默认为falselongtap: true, //默认为falseswipe: true, //默认为truedrag: true, //默认为truehold:false,//默认为false，不监听release:false//默认为false，不监听}});

3.2 mui.ready()

Mui.ready()是MUI框架中的文档就绪函数，表示mui框架已经加载完毕，接受一个回调函数，功能上有些类似于JQuery的文档就绪函数。

// 当MUI的页面DOM加载完成后，执行的函数。 但是，基本都使用mui.plusReadymui.ready(function(){//console.log("我在plusReady之前调用！");})

3.3 mui.plusReady ()

mui.plusReady()方法使用与mui.ready()类似，但是这个方法在执行时间上，略晚于mui.ready()。因为这个方法除了要求MUI框架加载完毕的基础上，还要求HTML5+运行时必须准备完毕！

所以我们一般用这个函数，来代替JS中的window.onload函数。

//页面中HTML5+相关的内容加载完毕后，执行的函数。  类似于window.onload = function(){}mui.plusReady(function(){//console.log("我在mui.ready之后调用！");})

3.4 页面跳转功能的实现

页面跳转功能的实现思路是，我们新建了一个数组，数组中存放着与列表一一对应的链接地址。然后使用循环给每一个列表list添加点击事件，并打开数组中对应的页面地址，代码如下：

var page = ["01-jiazaiziyemian.html","02-tabbarDiv.html","03-tabbarWebView.html","04-tabbarMy.html","05-imglunbo.html","06-Camera.html","07-fullPush.html"];var arr = document.getElementsByTagName("a");for(var i=0; i<arr.length; i++){!function(i){// 在手机APP中，事件绑定推荐使用DOM2模型。 用tap事件取代click事件。arr[i].addEventListener("tap",function(){mui.openWindow({url:page[i],id:page[i],})})}(i);}

3.5 跳转代码解释

上述代码中，对于很多初学者来说可能会存在一些问题，下面我们来一一解释一下这部分代码：

① 移动端开发中使用tap替代click

在移动端开发中，由于使用click事件会存在一定的延迟，严重影响用户体验，所以我们一律用tap事件取代所有的点击事件。

② 为什么for循环中嵌套一个自执行函数？

这个问题我们在JS面向对象环节探讨过，由于for循环会在页面加载时直接循环结束，所以当我们点击list时，其中的i已经变成了数组的长度。至于为什么这么解决，大家可以参考之前的博客：http://www.cnblogs.com/jerehedu/p/7592124.html

③mui.openWindow ()是个什么东西？

mui.openWindow是MUI官方给我们提供的专门用于打开一个新窗口的函数，详细的使用教程可以参考：http://dev.dcloud.net.cn/mui/window/#openwindow

而这个函数的完整配置项如下，当然我们上述的操作只需要一个URL和一个页面ID即可，而且我们以后的页面ID基本都使用URL同名的方式哦~

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事件发生后自动显示，默认为trueaniShow:animationType,//页面显示动画，默认为”slide-in-right“；duration:animationTime//页面动画持续时间，Android平台默认100毫秒，iOS平台默认200毫秒；},waiting:{autoShow:true,//自动显示等待框，默认为truetitle:'正在加载...',//等待对话框上显示的提示内容options:{width:waiting-dialog-widht,//等待框背景区域宽度，默认根据内容自动计算合适宽度height:waiting-dialog-height,//等待框背景区域高度，默认根据内容自动计算合适高度......}}
})

好了，截止到这，我们的首页就全部搭建完成啦！最终效果如下！

3.6 首页最终效果预览

当然这里面还有很多功能我们暂时没有实现，后面的博客我们继续再见吧！

如若想要源码可戳http://www.jredu100.com/index.php?m=content&c=index&a=show&catid=65&id=38自行下载。