mui初级入门教程(二)
文章来源:小青年原创 发布时间:2016-05-19 关键词:mui,html5+,webview 转载需标注本文原始地址: http://zhaomenghuan.github.io/#!/blog/20160519 写在前面本系列文章我们将利用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,//等待框背景区域高度,默认根据内容自动计算合适高度 ...... } }}) 参数说明:
var webview = mui.openWindow({ url:'info.html', extras:{ name:'mui' }});console.log(webview.name); 控制台会输出"mui"字符串;注意:扩展参数仅在打开新窗口时有效,若目标窗口为预加载页面,则通过mui.openWindow方法打开时传递的extras参数无效。
示例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方法)。
hbuilder中敲mheader生成的代码块,会自动生成带有返回导航箭头的标题栏,点击返回箭头可关闭当前页面,原因就是因为该返回箭头包含.mui-action-back类,代码如下:
若希望在顶部导航栏之外的其它区域添加关闭页面的控件,只需要在对应控件上添加.mui-action-back类即可,如下为一个关闭按钮示例: 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.backvar 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中,否则就有可能被固定栏遮罩,原因:固定栏基于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 ,回车试试。 哈哈,页面头部出来了,不错,这里我们然后删除下面的: 先去掉返回箭头。
然后继续输入 mtab ,回车,底部导航栏也出来了,我们修改一下导航栏的内容,把代码稍微调整一下。 整体代码如下:
首页的静态布局我们写完了,我们接下来新建三个含mui的html文件:
动态页面切换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()方法在html5plus文档中没有提到,这里的这个方法是将webview对象填充到窗口的方法。 2.选项卡点击事件mui 内部封装了一些常用的方法,其中DOM选择器、事件绑定等事件管理。具体可以参考文档: 选择器 、 事件管理 。
mui() mui使用css选择器获取HTML元素,返回mui对象数组。
若要将mui对象转化成dom对象,可使用如下方法(类似jquery对象转成dom对象): //obj1是mui对象var obj1 = mui("#title");//obj2是dom对象var obj2 = obj1[0];
.on( event , selector , handler )
除了可以使用addEventListener()方法监听某个特定元素上的事件外, 也可以使用.on()方法实现批量元素的事件绑定。 这里我们将为底部导航按钮添加事件: //选项卡点击事件mui('.mui-bar-tab').on('tap', 'a', function(e) { alert(true);}); 当我们点击底部选项卡的时候会弹出 true ,这不够,我们要能够分辨当前对象具体是哪一个,有两种思路:
第一种方法需要遍历此案获取 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 最近在开始写MUI小白文档,地址:
https://zhaomenghuan.gitbooks.io/mui/content/ MUI小白文档git仓库地址:
https://git.gitbook.com/zhaomenghuan/mui.git |