看到很多去年甚至前年没有回答的双指放大缩小问题，自己折腾了半天实现了，感觉挺简单的，为什么没人回答呢，所以我把自己弄出来的写出来给大家瞅瞅。是原生的mui解决，不需要第三方

<meta name="viewport" content="user-scalable=yes,width=device-width,minimum-scale=1.0"> 

先写这个，重点是这句user-scalable=yes
引入mui.js之后

var wv =null;  
mui.plusReady(function()  
{  
  var wv=plus.webview.currentWebview();  
  wv.setStyle({'scalable':'true'});  
 });  

在文件底下写js，直接把上面这段copy，有bug的话估计也是括号之类的问题，然后运行吧
基本上这样就能实现了
对大家的有帮助的话请务必给我回复鼓励，靴靴

为了良好的阅读体验，推荐转到本人博客小青年博客或者segmentfault

文章来源：小青年原创
发布时间：2016-05-29
关键词：mui,html5+,XMLHttpRequest ,ajax，懒加载
转载需标注本文原始地址: http://zhaomenghuan.github.io/#!/blog/20160529

写在前面

这是这个系列的的第三篇文章，前面的文章在多个地方（本人github博客、dcloud ask社区、segmentfault）发出来了，很多朋友收藏点赞，只是没有多少人反映内容的深浅，也没有人提出意见，所以实话说不知道符不符合大家胃口，不过我写博客一向以详细为标准，尽可能照顾到各种人群，特别是入门级的同学，力求还原我学习这个东西的一个思路和过程，在文章中也分享一些不错的干货，最近在折腾博客，用webpack和vue-cli打包了一下，目前还有些问题有待解决，自己尝试写一个markdown编辑器因为bug过多的问题，然后开始使用马克飞象写博客，毕竟生成的界面美观多了，这样可以方便大家阅读吧。废话不多说，开始我们今天的内容，今天主要是学习一下html5+的XMLHttpRequest以及mui的基本用法。

基础铺垫

Javascript XMLHttpRequest网络请求

XMLHttpRequest 是一个 JavaScript 对象，它最初由微软设计,随后被 Mozilla、Apple 和 Google采纳. 如今,该对象已经被 W3C组织标准化. 通过它,你可以很容易的取回一个URL上的资源数据. 尽管名字里有XML, 但 XMLHttpRequest 可以取回所有类型的数据资源，并不局限于XML。 而且除了HTTP ,它还支持file 和 ftp 协议. —— MDN XMLHttpRequest

XMLHttpRequest 让发送一个HTTP请求变得非常容易。你只需要简单的创建一个请求对象实例，打开一个URL，然后发送这个请求。当传输完毕后，结果的HTTP状态以及返回的响应内容也可以从请求对象中获取。

XMLHttpRequest网络请求的一般步骤：

第一步：创建一个 XMLHttpRequest 实例

new XMLHttpRequest();

第二步：初始化HTTP请求参数

void open(  
   DOMString method,  
   DOMString url,  
   optional boolean async,  
   optional DOMString user,  
   optional DOMString password  
);

• method：请求所使用的HTTP方法; 例如 "GET", "POST", "PUT", "DELETE"等. 如果下个参数是非HTTP(S)的URL,则忽略该参数.
• url：该请求所要访问的URL
• async：一个可选的布尔值参数，默认为true,意味着是否执行异步操作，如果值为false,则send()方法不会返回任何东西，直到接受到了服务器的返回数据。如果为值为true，一个对开发者透明的通知会发送到相关的事件监听者。这个值必须是true,如果multipart属性是true，否则将会出现一个意外。
• user：用户名,可选参数,为授权使用;默认参数为空string.
• password：密码,可选参数,为授权使用;默认参数为空string.

第三步：发送请求

send();

发送请求. 如果该请求是异步模式(默认),该方法会立刻返回. 相反,如果请求是同步模式,则直到请求的响应完全接受以后,该方法才会返回.

如下例：

var xhr = new XMLHttpRequest();  
xhr.onload = function () {  
    console.log(this.responseText);  
};  
xhr.onreadystatechange = function() {  
    console.log(this.readyState);  
};  
xhr.open("get", "https://www.baidu.com", true);  
xhr.send();

我们在hbuilder里面打开，控制台会报错：

[Web浏览器] "XMLHttpRequest cannot load https://www.baidu.com/. No 'Access-Control-Allow-Origin' header is present on the requested resource. Origin 'http://127.0.0.1:8020' is therefore not allowed access."

用浏览器打开，按F12在控制台console下查看也会发现上述错误，这是为啥呢？

这是因为普通网页能够使用XMLHttpRequest对象发送或者接受服务器数据, 但是它们受限于同源策略。只要先获取了跨域请求许可，就可以进行跨域请求。

同源策略：如果两个页面的协议、域名和端口是完全相同的，那么它们就是同源的。同源策略是为了防止从一个地址加载的文档或脚本访问或者设置从另外一个地址加载的文档的属性。如果两个页面的主域名相同，则还可以通过设置 document.domain属性将它们认为是同源的。

跨域请求的几种常用方法：

第一种：CORS，使用XMLHttpRequest对象
CORS 的全称是 Cross-Origin Resource Sharing，即跨域资源共享。他的原理就是使用自定义的 HTTP 头部，让服务器与浏览器进行沟通，主要是通过设置响应头的 Access-Control-Allow-Origin 来达到目的的。这样，XMLHttpRequest 就能跨域了。

在服务器端添加响应头Access-Control-Allow-Origin，使用XMLHttpRequest对象请求。值得注意的是，正常情况下的 XMLHttpRequest 是只发送一次请求的，但是跨域问题下很可能是会发送两次的请求（预发送）。

PHP:

header('Access-Control-Allow-Origin: *');

java:

response.addHeader( "Access-Control-Allow-Origin", "*" ); 

第二种：Jsonp，只适用于get请求

Jsonp的跨域不是用XMLHttpRequest实现的，而是一个script标签，script是可以跨域的，回调函数作为get参数传入请求里。

原理很简单，比如你在A域名请求B域名：

• 在A域名的页面中使用script标签src写成B域名中服务器的URL
  script标签是可以跨域的，比如你调用Google Map或Google Analytics时引入的js就是google域名下的。
• 后端程序在最后需要把一段js代码的字符串print出来，这样就可以运行A域名js中写好的callback方法，将要返回的数据放入参数就可以了

A域名中的js文件：

<script type="text/javascript" src="http://www.b.com/action?callback=myCallback"></script>  
<script type="text/javascript">  
    function myCallback (data) {  
        alert(data);  
    }  
</script>

B域名中服务器

String cb = get('callback');  
Int b = '我是数据';  
print('<script type="text/javascript"> ' + cb + '(' + b + '); </script>');

后端print数据到页面中后就会这样

<script type="text/javascript">  
    myCallback('我是数据');  
</script>

注：引用自segmentfault 的tychio的回答。

总之，不论是XMLHttpRequest的跨域，还是Jsonp，都是需要请求的网站服务器端提供支持，在愿意分享给你数据的情况下你才能得到。在对方没有提供支持的情况下，你是取不到它的数据的。当然跨域的解决方案有很多种，由于本人没有实践过，没有实践就没有发言权，这里给大家贴一个帖子，自己跨域自行验证，浅谈浏览器端JavaScript跨域解决方法。

html5+ XMLHttpRequest网络请求

上面我们花了很大篇幅讲解了JavaScript XMLHttpRequest对象，而且也简单的讲解了同源策略和跨域请求的常用方法，我们注意到无论是JavaScript XMLHttpRequest还是jsonp都需要通过服务器端的支持才能实现跨域，另外还有几种也有一定的局限性，所以总还是让人觉得美中不足。html5+提供了一个XMLHttpRequest模块，在APP端很完美的解决了这种问题，而且提供了和JavaScript XMLHttpRequest对象用法类似的一系列属性方法。由于本文的重在在于讲解html5+ XMLHttpRequest,所以前面的JavaScript XMLHttpRequest相关的属性方法只是初略介绍了一下，下面重点介绍html5+ XMLHttpRequest模块。

适用范围：

由于html5+ XMLHttpRequest是一种拓展方案，所以需要底层支持，基于html5+ XMLHttpRequest的方法不能用于非5+环境，如果对这些概念不清楚的欢迎先阅读我之前写的文章mui初级入门教程（一）— 菜鸟入手mui的学习路线。

我们用hbuilder新建一个app工程，然后运行下面的代码：

<!DOCTYPE html>  
<html>  
<head>  
    <meta charset="utf-8">  
    <meta name="viewport" content="initial-scale=1.0, maximum-scale=1.0, user-scalable=no" />  
    <title></title>  
</head>  
    <body>  
        <script type="text/javascript">  
            document.addEventListener('plusready', function(){  
                var xhr = new plus.net.XMLHttpRequest();  
                xhr.onreadystatechange = function () {  
                    switch ( xhr.readyState ) {  
                        case 0:  
                            console.log( "xhr请求已初始化" );  
                        break;  
                        case 1:  
                            console.log( "xhr请求已打开" );  
                        break;  
                        case 2:  
                            console.log( "xhr请求已发送" );  
                        break;  
                        case 3:  
                            console.log( "xhr请求已响应");  
                            break;  
                        case 4:  
                            if ( xhr.status == 200 ) {  
                                alert( "xhr请求成功："+xhr.responseText );  
                            } else {  
                                console.log( "xhr请求失败："+xhr.readyState );  
                            }  
                            break;  
                        default :  
                            break;  
                    }  
                }  
                xhr.open("GET", "https://www.baidu.com/");  
                xhr.send();  
            }, false );  
        </script>  
</body>  
</html>

我们会发现最后弹出了弹框，里面写有百度首页的代码。

XMLHttpRequest对象：

创建一个XMLHttpRequest 对象，对象创建时不触发任何时间和网络请求，需和open，send方法配合使用。

var xhr = new plus.net.XMLHttpRequest();  
xhr.open(method, url);  
xhr.send();

XMLHttpRequest的属性：

• readyState: HTTP 请求的状态
• response: 请求从服务器接收到的响应数据
• responseText: 请求从服务器接收到的响应数据（字符串数据）
• responseType:请求响应数据response的类型
• responseXML: 请求响应的Document对象
• status: 服务器返回的HTTP状态代码
• statusText: 服务器返回的HTTP状态描述
• timeout: 请求服务器的超时时间，单位为毫秒（ms）
• withCredentials: 是否支持跨域请求

XMLHttpRequest的方法：

• abort: 取消当前响应，关闭连接并且结束任何未决的网络活动
• getAllResponseHeaders: 获取HTTP响应头部信息
• getResponseHeader: 获取指定的HTTP响应头部的值
• open: 初始化HTTP请求参数，例如URL和HTTP方法，但是并不发送请求
• send: 发送HTTP请求
• setRequestHeader: 指定一个HTTP请求的Header

XMLHttpRequest的事件：

• onreadystatechange: 网络请求状态发生变化事件
• onloadstart: 网络请求开始事件
• onprogress: 网络请求传输数据事件
• onabort: 网络请求取消事件
• onerror: 网络请求错误事件
• onload: 网络请求成功事件
• ontimeout: 网络请求超时事件
• onloadend: 网络请求结束事件

mui ajax

mui框架基于htm5plus的XMLHttpRequest，封装了常用的Ajax函数，支持GET、POST请求方式，支持返回json、xml、html、text、script数据类型； 本着极简的设计原则，mui提供了mui.ajax方法，并在mui.ajax方法基础上，进一步简化出最常用的mui.get()、mui.getJSON()、mui.post()三个方法。

mui.ajax( url [,settings] )

• url：请求发送的目标地址
• settings：key/value格式的json对象，用来配置ajax请求参数，支持的参数如下：
  • data：发送到服务器的业务数据；
  • type：请求方式，目前仅支持'GET'和'POST'，默认为'GET'方式；
  • dataType：预期服务器返回的数据类型；如果不指定，mui将自动根据HTTP包的MIME头信息自动判断；
    支持设置的dataType可选值：
    • "xml": 返回XML文档
    • "html": 返回纯文本HTML信息；
    • "script": 返回纯文本JavaScript代码
    • "json": 返回JSON数据
    • "text": 返回纯文本字符串
  • success：Type: Functon（Anything data,String textStatus,XMLHttpRequest xhr）
    请求成功时触发的回调函数，该函数接收三个参数：
    • data：服务器返回的响应数据，类型可以是json对象、xml对象、字符串等；
    • textStatus：状态描述，默认值为'success'
    • xhr：xhr实例对象
  • error：Type: Functon（XMLHttpRequest xhr,String type,String errorThrown）请求失败时触发的回调函数；
    该函数接收三个参数：
    • xhr：xhr实例对象
    • type：错误描述，可取值："timeout", "error", "abort", "parsererror"、"null"
    • errorThrown：可捕获的异常对象
  • timeout：Type: Number，请求超时时间（毫秒），默认值为0，表示永不超时；若超过设置的超时时间(非0的情况)，依然未收到服务器响应，则触发error回调；
  • headers：Type: Object,格式为：{'Content-Type'：'application/json'}，
    详情参考html5+ setRequestHeader。

基本格式如下：

mui.ajax(url,{  
    data:{  
        username:'username',  
        password:'password'  
    },  
    dataType:'json',//服务器返回json格式数据  
    type:'post',//HTTP请求类型  
    timeout:10000,//超时时间设置为10秒；  
    success:function(data){  
        //服务器返回响应，根据响应结果，分析是否登录成功；  
        ...  
    },  
    error:function(xhr,type,errorThrown){  
        //异常处理；  
        console.log(type);  
    }  
});

mui.post( url [,data] [,success] [,dataType] )

mui.post()方法是对mui.ajax()的一个简化方法，直接使用POST请求方式向服务器发送数据、且不处理timeout和异常（若需处理异常及超时，请使用mui.ajax()方法）

mui.post('http://server-name/login.php',{  
        username:'username',  
        password:'password'  
    },function(data){  
        //服务器返回响应，根据响应结果，分析是否登录成功；  
        ...  
    },'json'  
);

mui.get( url [,data] [,success] [,dataType] )

mui.get()方法和mui.post()方法类似，只不过是直接使用GET请求方式向服务器发送数据、且不处理timeout和异常（若需处理异常及超时，请使用mui.ajax()方法）。如下为获得某服务器新闻列表的代码片段，服务器以json格式返回数据列表：

mui.get('http://server-name/list.php',  
    {category:'news'},  
    function(data){  
        //获得服务器响应  
        ...  
    },'json'  
);

mui.get( url [,data] [,success] )

mui.getJSON()方法是在mui.get()方法基础上的更进一步简化，限定返回json格式的数据，其它参数和mui.get()方法一致，如上获得新闻列表的代码换成mui.getJSON()方法后，更为简洁，如下：

mui.getJSON('http://server-name/list.php',  
    {category:'news'},  
    function(data){  
        //获得服务器响应  
        ...  
    }  
);

注：初学者肯对于GET与POST的区别不是很清楚，这里不做详细介绍，若要深入了解请查看：GET，POST — 简述

项目实战

我们接着上一篇文章的项目开始进行本节的内容，上一篇我们讲解了html5+ webview的使用方法，并且实现了一个基于父子webview的tab bar切换的案例，我们这次利用网易音乐API接口请求数据，完成我们后续的音乐播放器功能。

API分析

网易音乐搜索API：

• url：http://s.music.163.com/search/get/
• type："GET"或“POST" //HTTP请求类型
• 请求参数：
  • type: 1
  • s: //关键词
  • limit: 10 //限制返回结果数为10
  • offset: 0 //偏移
  • src: lofter //可为空
  • filterDj: true | false //可为空
  • callback: //为空时返回json，反之返回jsonp callback

由于HTTP请求类型包含get，我们只需要把请求的参数拼接到url里面就可以得到返回的数据，格式为url?key1=value1&key2=value2。

在这个例子中我们打开这个网址http://s.music.163.com/search/get/?type=1&limit=5&s=喜欢你,我们会发现一些数据返回了，如下图：

OK，我们下面讲解怎么通过程序得到这些数据，并且我们并且怎么解析这些数据。

在开始之前我们先对我们要得到的数据进行美化，这里我在网上随便搜了一个
在线JSON校验格式化工具，我们只需要把刚刚那些数据复制粘贴到我给的这个工具里面，然后点击校验就变整齐了。

{  
    "result": {  
        "songCount": 3224,  
        "songs": [  
            {  
                "id": 28949444,  
                "name": "喜欢你",  
                "artists": [  
                    {  
                        "id": 7763,  
                        "name": "G.E.M.邓紫棋",  
                        "picUrl": null  
                    }  
                ],  
                "album": {  
                    "id": 2956076,  
                    "name": "喜欢你",  
                    "artist": {  
                        "id": 0,  
                        "name": "",  
                        "picUrl": null  
                    },  
                    "picUrl": "http://p1.music.126.net/u_1EudmF8Swgow6vfgYe1g==/8896148580676276.jpg"  
                },  
                "audio": "http://m2.music.126.net/_icR1apQHVl8wa0EP_REkQ==/3269947581061892.mp3",  
                "djProgramId": 0  
            }  
        ]  
    },  
    "code": 200  
}

我们可以看到

"picUrl":"http://p1.music.126.net/u_1EudmF8Swgow6vfgYe1g==/8896148580676276.jpg"

打开这个图片地址我们就可以看到邓紫棋了，哈哈，也就是说我们只需要抓取到这个地址就可以进行下面的工作咯，其他的类似。

mui.ajax请求实例

我们在上次新建的M-BOX下的home.html下写这个例子：

<script src="../js/mui.min.js"></script>  
<script type="text/javascript">  
    var url = "http://s.music.163.com/search/get/";         
    mui.ajax(url,{  
        data: {  
           'type': 1,  
            's': "喜欢你",  
            'limit': 10  
        },  
        dataType:'json',//服务器返回json格式数据  
        type:'post',//HTTP请求类型  
        timeout:10000,//超时时间设置为10秒；  
        success:function(data){  
            console.log(JSON.stringify(data));  
        },  
        error:function(xhr,type,errorThrown){  
            //异常处理；  
            console.log(type);  
        }  
    });  
</script>

hbuilder很方便的一个功能就是真机调试，我们直接将电脑与手机连接，通过console.log() 函数可以很方便的将数据在控制台打印出来，例如上述例子如果我们在success的回调函数中执行console.log(data);,在控制台会输出[object Object]，我们只需要利用JSON.stringify() 方法可以将任意的JavaScript 值序列化成 JSON 字符串。

Javascript语法基础

每次看到很多同学在解析json的时候错误百出，严重暴漏了基本功，这里我就总结几条与解析json可能相关的知识点。

什么是JSON？

JSON:JavaScript Object Notation(JavaScript 对象表示法)，JSON 是存储和交换文本信息的语法,独立于语言。类似 XML。JSON 比 XML 更小、更快，更易解析,具有自我描述性，更易理解的特点。

JSON就是一串字符串，只不过元素会使用特定的符号标注。

• {} 双括号表示对象
• [] 中括号表示数组
• "" 双引号内是属性或值
• ：表示后者是前者的值(这个值可以是字符串、数字、也可以是另一个数组或对象)

{"name": "Dcloud"}可以理解为是一个包含name为Dcloud的对象;
[{"name": "mui"},{"name": "html5+"}]就表示包含两个对象的数组。

通过JavaScript，您可以创建一个对象数组，并像这样进行赋值：

var employees = [  
    { "firstName":"John" , "lastName":"Doe" },   
    { "firstName":"Anna" , "lastName":"Smith" },   
    { "firstName":"Peter" , "lastName": "Jones" }  
];

可以像这样访问 JavaScript 对象数组中的第一项：
employees[0].lastName;
返回的内容是：
Doe
可以像这样修改数据：
employees[0].firstName = "Jonatan";

运算符[ ] 和 .

[ ]可以用于数组和对象取值，数组中按下边取值。

var array=["one","two","three","four"];  
array[0];

对象属性取值时，当我们不知道属性名或属性名本身包含点（.）的键，应当使用[ ]。

for(var key in obj){  
   console.log(key + ":" + obj[key]);  
}

var obj={  
  id:"obj",  
  "self.ref":ref  
}  
console.log(obj["self.ref"]);

.运算符的左边为一个对象，右边为属性名。如：obj.id

可以动态访问属性：

var key="property";  
console.log(key);  

var obj={  
  property:"hello word"  
}  

console.log(obj[key]);

数组的map方法：

var array=[1,2,3,4,5];  
array.map(function(item){  
  return item*2;  
});

数组map方法可以接受一个匿名函数，数组中每个元素都会调用这个匿名函数，并且讲返回结果放在一个数组中。

获取数据更新UI

mui中的each()方法既是一个类方法，同时也是一个对象方法，两个方法适用场景不同；换言之，你可以使用mui.each()去遍历数组或json对象，也可以使用mui(selector).each()去遍历DOM结构。

mui.each( obj , handler )

• obj :
  Type: Array||JSONObj
  需遍历的对象或数组；若为对象，仅遍历对象根节点下的key
• handler :
  Type: Function( Integer||String index,Anything element)
  为每个元素执行的回调函数；其中，index表示当前元素的下标或key，element表示当前匹配元素

对于前面说到的音乐api返回的json数据，首先我们要通过var songs=data.result.songs;获取"songs"的值，然后遍历"songs"对象的子对象。

···  
success:function(data){  
    // console.log(JSON.stringify(data));  
    var songs=data.result.songs;  
    mui.each(songs,function(index,item){  
        var id = item.id,  
            name = item.album.name,  
            author = item.artists[0].name,  
            picUrl = item.album.picUrl,  
            audio = item.audio;       
    })  
},  
···

我们用上述代码可以得到我们想要的数据，下面就是需要将信息展示出来，这里我们只获取 歌曲id、歌曲所属专辑名name、歌曲第一作者author、歌曲所属专辑图片picUrl 、歌曲音频文件audio。

考虑到要加载很多图片，这里我们使用懒加载实现效果，这里我们直接使用hello mui里面的模板页面lazyload-image.html，我们需要引入mui.lazyload.js和mui.lazyload.img.js两个文件，还有占位图。下面先贴出修改后的基本的代码，然后再讲解其中的内容。
home.html:

<!DOCTYPE html>  
<html>  
    <head>  
        <meta charset="utf-8">  
        <title>M-BOX</title>  
        <meta name="viewport" content="width=device-width, initial-scale=1,maximum-scale=1,user-scalable=no">  
        <meta name="apple-mobile-web-app-capable" content="yes">  
        <meta name="apple-mobile-web-app-status-bar-style" content="black">  
        <!--标准mui.css-->  
        <link rel="stylesheet" href="../css/mui.min.css">  
        <style type="text/css">  
            .mui-content>.mui-table-view:first-child {  
                margin-top: 0px;  
            }  
        </style>  
    </head>  

    <body>  
        <div class="mui-content">  
            <ul id="list" class="mui-table-view mui-table-view-chevron"></ul>  
        </div>  
    </body>  

    <script src="../js/mui.min.js "></script>  
    <script src="../js/mui.lazyload.js"></script>  
    <script src="../js/mui.lazyload.img.js"></script>  
    <script>  
        mui.init();  

        var url = "http://s.music.163.com/search/get/";         
        mui.ajax(url,{  
            data: {  
                'type': 1,  
                's': "喜欢你",  
                'limit': 10  
            },  
            dataType:'json',//服务器返回json格式数据  
            type:'post',//HTTP请求类型  
            timeout:10000,//超时时间设置为10秒；  
            success:function(data){  
                //console.log(JSON.stringify(data));  
                var songs=data.result.songs;  

                var list = document.getElementById("list");  
                var fragment = document.createDocumentFragment();  
                var li;  
                mui.each(songs,function(index,item){  
                     var id = item.id,  
                        name = item.album.name,  
                        author = item.artists[0].name,  
                        picUrl = item.album.picUrl,  
                        audio = item.audio;     

                    li = document.createElement('li');  
                    li.className = 'mui-table-view-cell mui-media';  
                    li.innerHTML = '<a class="mui-navigate-right" id='+ id +' data-audio='+ audio +'>'+  
                                        '<img class="mui-media-object mui-pull-left" data-lazyload="'+picUrl+'">'+  
                                        '<div class="mui-media-body">'+name+  
                                            '<p class="mui-ellipsis">'+author+'</p>'+  
                                        '</div>'+  
                                    '</a>';  
                    fragment.appendChild(li);  
                })  

                list.appendChild(fragment)  

                mui(document).imageLazyload({  
                    placeholder: '../img/60x60.gif'  
                });  
            },  
            error:function(xhr,type,errorThrown){  
                //异常处理；  
                console.log(type);  
            }  
        });  

        //列表点击事件  
        mui("#list").on('tap','li a',function(){  
            var id = this.getAttribute('id');  
            var audio = this.getAttribute('data-audio');  
            //打开详情页面  
            mui.openWindow({  
                url:'music.html',  
                id:'music.html',  
                extras:{  
                    musicId:id,  
                    audioUrl:audio  
                }  
            });  
        });  
    </script>  
</html>

music.html:

<!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></title>   
    <link href="../css/mui.min.css" rel="stylesheet"/>  
</head>  
<body>  
    <script src="../js/mui.min.js"></script>  
    <script type="text/javascript">  
        mui.init();  
        mui.plusReady(function(){  
            var self = plus.webview.currentWebview();  
            var musicId = self.musicId;  
            var audioUrl = self.audioUrl;  
            document.write("musicId:" + musicId + "<br />");  
            document.write("audioUrl:" + audioUrl);  
        });  
    </script>  
</body>  
</html>

我们这里说几个开发者常见的问题：

拼接html字符串

首先打开hello mui里面的模板页面lazyload-image.html，我们打开控制台查看elements，结构如下：

<ul id="list" class="mui-table-view mui-table-view-chevron">  
    <li class="mui-table-view-cell mui-media">  
        <a class="mui-navigate-right">  
            <img class="mui-media-object mui-pull-left" data-lazyload-id="0" src="http://www.dcloud.io/hellomui/images/1.jpg?version=447.4190210457891">  
            <div class="mui-media-body">  
                主标题  
                <p class="mui-ellipsis">列表二级标题</p>  
            </div>  
        </a>  
    </li>  
</ul>

我们需要将获取的内容动态的填充到这个里面，这里常用的方法就是动态的生成节点，这里我们就要用到DOM的创建方法document.createElement,通过这个方法我们可以生成一个节点:
li = document.createElement('li');这个可以生成一个li节点，我们需要为这个li指定class,通过对对象的className赋值实现，如：li.className = 'mui-table-view-cell mui-media';,我们使用appendChild(li)方法将li节点挂着父节点上，比如:

var list = document.getElementById("list");  
list.appendChild(li);

这个就是把li节点挂在list下，同理我们可以在li节点下 创建子节点，上面为了简单，我们使用给innerHTML属性赋值的做法，这样innerHTML的值同样会挂在li节点下，大家需要注意的是innerHTML属性的值我字符串，所以我们往中间插入了变量，要使用+连接起来。我们可以通过循环创建多个节点，如下面这样创建十个段落：

for(var i = 0 ; i < 10; i ++) {  
    var p = document.createElement("p");  
    var oTxt = document.createTextNode("段落" + i);  
    p.appendChild(oTxt);  
    document.body.appendChild(p);  
}

上面我们使用的是mui.each()方法，效果类似。

如果细心的同学或许注意到我们使用了一个奇怪的写法：

var fragment = document.createDocumentFragment();  
mui.each(songs,function(index,item){  
    ...  
    fragment.appendChild(li);  
});  
list.appendChild(fragment);

为啥我们要在这里使用fragment呢？

如果是对前端技术感兴趣的同学说不定回去查一下，我相信大部分人可能就放过了吧！这里我查了一下资料：

在《javascript高级程序设计》一书的6.3.5:创建和操作节点一节中，介绍了几种动态创建html节点的方法，其中有以下几种常见方法：

• crateAttribute(name)：　　　　　 　　用指定名称name创建特性节点
• createComment(text)：　　　　　　　创建带文本text的注释节点
• createDocumentFragment()：　　　　 创建文档碎片节点
• createElement(tagname)：　　　　　 创建标签名为tagname的节点
• createTextNode(text)：　　　　　　 创建包含文本text的文本节点

其中最感兴趣且以前没有接触过的一个方法是createComment(text)方法，书中介绍说：在更新少量节点的时候可以直接向document.body节点中添加，但是当要向document中添加大量数据是，如果直接添加这些新节点，这个过程非常缓慢，因为每添加一个节点都会调用父节点的appendChild()方法，为了解决这个问题，可以创建一个文档碎片，把所有的新节点附加其上，然后把文档碎片一次性添加到document中。—— document的createDocumentFragment()方法

页面传值

我们点击了列表，我们会进入一个详情页，我们肯定是想知道我们究竟点了哪一个我们想把一些数据传入到详情页面，这里我们使用了mui.openWindow()方法中的拓展参数extras传入几个值，在详情页面通过plus.webview.currentWebview获取：

mui.plusReady(function(){  
    var self = plus.webview.currentWebview();  
    var musicId = self.musicId;  
    var audioUrl = self.audioUrl;  
    document.write("musicId:" + musicId + "<br />");  
    document.write("audioUrl:" + audioUrl);  
});

这是在页面初始化时，通过扩展参数extras传值；另外还有页面已创建，通过自定义事件传值，参考mui官网中自定义事件的介绍，这里先不讲得太多，后面会专门花时间详细讲解相关细节。

当我们写到这里，发现这篇依然是长长的一篇干货，很多内容摘自文档，主要是为了新手可以详细去了解整个流程。其实还有很多没有写出来，限于篇幅还是后面再写吧！由于代码在文章中写得很详细，工程代码先不给出来，最后整个系列写完了再放出来吧！

山东五颗牙技术工作室
网站：山东五颗牙技术工作室 www.wukeya.com

擅长：Html5plus + mui ， android原生 ios原生

案例：
商城+社交系统 商城系统采用的开源destoon 系统 具有完整的聊天 建群 商城 购物 支付等全部功能

农场：

商城

原生 、混合模式APP都可以开发。
联系方式
QQ：2367844223

外部工具指将一些外部程序、命令配置为HBuilder可通过菜单直接操作的命令

如何添加外部工具

运行-外部工具-外部工具配置如下图

echo “文件名:  C:\Users\wu\Documents\HBuilderProjects\calendar\index.html” & echo “文件路径:  C:\Users\wu\Documents\HBuilderProjects\calendar\index.html“ > 1.txt & echo “文件所在目录: C:\Users\wu\Documents\HBuilderProjects\calendart” > 2.txt & echo “文件所在项目路径: C:\Users\wu\Documents\HBuilderProjects\calendar” > 3.txt

如何为外部工具添加快捷键

依次点击工具-选项-常规-快捷键，在过滤文本中输入外部工具，回车如下图

模板组指讲html文件及其使用的文件（如js、css、字体、图片等）整体作为模板的功能

如何新建模板组

点击菜单-文件-HTML文件，点击“自定义模板组”如下图

问题反馈云服务上线

为简化广大开发者的开发工作量，HBuilder 7.2.0版本新增问题反馈云服务，大家在HBuilder中选择问题反馈模板，集成发布，然后登陆DCloud开发者中心，就可以查看用户的反馈情况。整个过程基本无需开发，即可实现问题反馈全流程的功能。

客户端集成

在HBuilder中新建HTML页面，选择“问题反馈”模板，如下图所示：

会自动生成问题反馈模板所需的html、js、css资源文件；

问题反馈模板依赖mui框架，请注意修改mui.min.js及mui.min.css的引用路径，其它代码无需修改即可直接使用。

快捷输入

反馈模板将软件使用中的常见问题，整理成了“快捷输入”功能，如下图所示：

用户点击快捷输入中的项，可以直接将该短语插入到“问题和意见”输入框中。开发者可根据实际情况修改常见问题，变成新的常用语，无需其它JS逻辑。

云端查看反馈数据

开发者使用 HBuilder 账号或 ASK 社区账号登录 开发者中心 。

登录成功后如下图所示：

问题反馈列表

点击列表中的应用名称进入二级页面，点击左侧导航“问题反馈”，进入问题反馈列表，如下图所示：

说明：列表中内容为粗体的表示未读内容。

问题详情

点击问题列表中的内容列，可以查看反馈问题的详细信息，如下图所示：

在详情页面可以设置该问题的解决方案，如图中红框部分所示。

备注：
HBuilder真机调试时，appid默认为"HBuilder"，因此真机运行时反馈的问题，登录 开发者中心无法查看，需要云端打包后运行才能查看数据。
如果想在真机运行时就体验效果，可以手动修改feedback.js文件，将如下代码修改为自己真实的Appid

appid: plus.runtime.appid, 

例如修改为：

appid: "HelloMUI", 

由于没有收藏功能，只能发文章收藏，方便查找，以下是三叔的开发心得
转载：http://ask.dcloud.net.cn/article/399（三叔的开发心得）
由于我经常问问题,每次找这篇文章都好麻烦,所以吧这个弄成文章。
其实我也是菜鸟,这里开一贴,记录我的学习开发中遇到的问题和解决方案,希望能帮助到后来的兄弟们。
openWindow方法

mui.openWindow({"url":"reg_wx.html","extras":{
"openId":openid

}

这样传值到reg_wx.html

在reg_wx.html里

function plusReady(){
var currentView = plus.webview.currentWebview();
document.getElementById("wx_appid").value = currentView.openId;
}
document.addEventListener('plusready',plusReady,false);

这么获取值

=============关于跨域==============================
通过mui的ajax请求是可以实现跨域的。
跨域是浏览器安全里的一个名词。记住了 是浏览器。
而我们的是app,请求并不是走浏览器脚本,而是用的H5+底层请求的。所以不存在什么跨域。直接调用。

===========获取应用入口页面的方法======================

var h=plus.webview.getWebviewById( plus.runtime.appid );
console.log( "应用首页Webview窗口："+h.getURL() );

==========判断plus对象是否生效=======================

if(window.plus){
plusReady();
}else{
document.addEventListener("plusready",plusReady,false);
}

============获取上一页(获取父页面)的方法==============================

var preUrl = plus.webview.currentWebview().opener().getURL();
console.log(preUrl);

===========双击回退按钮后关闭app的方法==========================

//首页返回键处理
//处理逻辑：1秒内，连续两次按返回键，则退出应用；
var first = null;
mui.back = function() {
//首次按键，提示‘再按一次退出应用’
if (!first) {
first = new Date().getTime();
mui.toast('再按一次退出应用');
setTimeout(function() {
first = null;
}, 1000);
} else {
if (new Date().getTime() - first < 1000) {
plus.runtime.quit();
}
}

};

============手机网络状态========================================

document.addEventListener( "netchange", function() {
var network = plus.networkinfo.getCurrentType();
if(network < 2) {
if(this.network > 1) {
plus.nativeUI.toast('您的网络已断开', undefined, '期待乐');
}
}

if(this.network == 3 &amp;&amp; network &gt; 3) {
plus.nativeUI.toast('您网络已从wifi切换到蜂窝网络，浏览会产生流量', undefined, '期待乐', '我知道了');
}

this.network = network;
});

==========手机回退键的触发======================================

function plusReady(){
ws=plus.webview.currentWebview();
// Android处理返回键
plus.key.addEventListener('backbutton',function(){
back();
},false);
compatibleAdjust();
}

=============有选择项的提示框==========

//退出登录
doLogout:function(){
var btnArray = ['再逛逛','是的'];
mui.confirm('你确定退出登录吗？', '提示', btnArray, function(e) {
if (e.index == 1) {
$.get(const_server_url+"/1/login/logout.json",function(data){
if(data.code == "200"){
m_login.clear();
mui.openWindow({
id:"registerPhone"
});
}else{
mui.alert(data.message);
}
});
}
});
}

===========微信支付中提示"支付权限检查失败"=========
微信支付有两个，一个是微信公众号的微信支付，
还有一个就是上面这个地址里面的微信支付,这两个微信支付不一样。
所以存在两个APPID、mch_id。
你用对了么

=========app升级代码=======================
参照: http://ask.dcloud.net.cn/question/5022,http://ask.dcloud.net.cn/article/182

通过native.js修改系统壁纸，直接上源码：

function setwallpaper(){  
    var WallpaperManager = plus.android.importClass("android.app.WallpaperManager");  
    var Main = plus.android.runtimeMainActivity();  
    var wallpaperManager = WallpaperManager.getInstance(Main);  
    plus.android.importClass(wallpaperManager);  
    var BitmapFactory = plus.android.importClass("android.graphics.BitmapFactory");  
    var url="img/img_1.png";  // 换成要设置的壁纸图片路径  
    var path=plus.io.convertLocalFileSystemURL(url);  
    var bitmap = BitmapFactory.decodeFile(path);  
    try{  
        wallpaperManager.setBitmap(bitmap);  
        bitmap.recycle(); // 设置完毕桌面要进行 原生层的BITMAP回收 减少内存压力  
    }catch(e){  
        //TODO handle the exception  
    }  
}

注意，调用此功能需要添加<uses-permission android:name="android.permission.SET_WALLPAPER"/>权限
打开应用的manifest.json文件，切换到“模块权限配置”项，选中android.permission.SET_WALLPAPER权限

android12+部分系统设备设置壁纸后会导致app重启 需要注意

如果要频繁设壁纸，应该把重用的基础变量定义放到函数外。

文章来源：小青年原创
发布时间：2016-05-19
关键词：mui,html5+
转载需标注本文原始地址

写在前面

本系列文章我们将利用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文档:http://www.html5plus.org/doc/zh_cn/webview.html,
这里我们重点看一下下面几个方法:

创建新的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；特别注意，height和width两个属性,即使不设置，也默认按100%计算；因此若设置了top值为非"0px"的情况，建议同时设置bottom值，否则5+ runtime根据高度100%计算，可能会造成页面真实底部位置超出屏幕范围的情况,left、right同理。

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

• 点击【文件】=》【新建】=》【移动APP】
• 设置应用名称、文件存储路径、选择模板
  
• js,css,fonts文件的详细介绍请戳这里手把手教你开发HelloWord
• HBuilder对前端代码的调试方式这个是很重要的一个部分，限于篇幅，这里不能讲解，请自己看教程。

开始写布局文件

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

好，那我们开始写布局文件：

在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">  
            <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-chatboxes"></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>  

    <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.html，message.html,setting.html。
• 在三个页面body之间分别输入mbody,就可以开始分别写页面了，比如可以先在页面上写上文件名，我们先来完善首页的子页切换逻辑。

动态页面切换

1.创建子页面，首个选项卡页面显示，其它均隐藏；

主要方法就是用plus.webview.create和plus.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()方法是在Webview窗口中添加子窗口，是Webview窗口对的一个方法，具体的可以参考html5+ WebviewObject。

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;  
});

后记

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

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

http://zhaomenghuan.github.io

使用uni-app

1. uni-app可直接将丰富的小程序sdk引入app中。环信等公司都有小程序sdk，可直接在小程序和app端使用。
2. app侧可集成原生的环信等sdk
3. h5侧可集成环信等h5 sdk

插件市场已经有原生sdk和小程序sdk，直接看这些就行。https://ext.dcloud.net.cn/search?q=%E8%81%8A%E5%A4%A9

如果不止是需要聊天，还需要音视频通话，在插件市场搜索：https://ext.dcloud.net.cn/search?q=webrtc

使用5+app

在Hello mui里提供了一个chat示例，可以发文字、图片、语音消息，并且可实时收发和显示聊天记录。
但这个示例连接的服务器是一个聊天机器人，一些开发者希望更全套的im服务，包括好友体系和服务器。
此时建议如下：

1. 用Hello mui的im示例的前端代码，后台自己用socket.io搭一个服务器。
2. 用Hello mui的im示例的前端代码，与leancloud的服务器配合使用，含有个推推送。这里有示例包和源码：http://ask.dcloud.net.cn/article/381
3. 使用环信的web sdk，参考https://segmentfault.com/a/1190000005729743
4. 使用融云的web sdk，这里有示例http://ask.dcloud.net.cn/article/195
5. 使用5+sdk的方式，封装一个环信或融云等im厂商的原生sdk到js层，给自己的js用。社区里有人发了自己集成后的代码，大家也可以验证下。文档参考http://ask.dcloud.net.cn/docs/#//ask.dcloud.net.cn/article/104
6. 直接调起手机qq，进入qq群或企业qq做交流或客服。参考http://ask.dcloud.net.cn/question/7425

// 保存图片到相册中
function savePicture() {
// 创建下载任务
picurl="http://192.168.1.106/Uploads/pictures/1/1454052530951.jpg";
picname="_downloads/1454052530951.jpg";
var dtask = plus.downloader.createDownload(picurl, {}, function ( d, status ) {
// 下载完成
if ( status == 200 ) {
alert( "Download success: " + d.filename );
plus.gallery.save(picname,function() {
mui.toast('保存成功');
}, function() {
mui.toast('保存失败，请重试！');
});
} else {
alert( "Download failed: " + status );
}
});
//dtask.addEventListener( "statechanged", onStateChanged, false );
dtask.start();

}

机型红米node3