SpringBoot系列——基于mui的H5套壳APP开发web框架

  前言

  大致原理:创建一个main主页面,只有主页面有头部、尾部,中间内容嵌入iframe内容子页面,如果在当前页面进行跳转操作,也是在iframe中进行跳转,而如果点击尾部按钮切换模块、页面,那就切换iframe标签的src进行更新url,这样我们在跳转页面时,头部、尾部都不会刷新,浏览效果更佳,配合mui前端框架,使操作体验更接近原生App

  如果不用考虑APP上架审核的问题,可以采用H5套壳的方式开发APP,可以降低开发人员的学习成本,uni-app + H5这样的套壳Web App,会Web项目开发的开发就能轻松上手

  得益于之前的总结,基于mui的H5套壳APP开发web框架,逐步完善,开源分享

 

   技术栈

  springboot + thymelea + mui

 

  效果演示

  目录结构

 

  uni-app套壳

  1、新建uni-app项目,页面仅使用webview组件,直接指定服务地址

<web-view id="webView" :src="url"></web-view>

  

  2、配置沉浸式

  需要设置page.json

 {
   "globalStyle": {
        "navigationStyle":"custom"
    },
    "usingComponts": true 
 }

  以及manifest.json

 "app-plus" : {
        "statusbar" : {
            "immersed" : true
        }
 }

  其他的暂时不配置,比如APP图标、启动图等,提交云端打包、下载安装

 

  App 版比H5版多一个系统状态栏占高

    //h5端默认隐藏
    mui.plusReady(function(){
        //显示系统状态栏占高
        $(".huanzi-header .statusbar").css("display","block");

        //自适应高度
        adaptiveHeight();
    });

      

 

  头、尾操作

  分为标题头部按钮操作、底部按钮操作

  

  按钮切换模式

  按钮切换分为两种模式:1 切换立即加载初始url       2 切换仅回显页面,在当前页面点击才加载(切换为首次加载除外)

  切换方式也很简单,在配置文件进行修改即可

#底部按钮切换模式:1 切换立即加载初始url  2 切换仅回显页面,在当前页面点击才加载(切换为首次加载除外)
huanzi.buttom.switch.mode=1

 

  1 切换立即加载初始url 

 

  2 切换仅回显页面,在当前页面点击才加载(切换为首次加载除外)

 

  mui loading

  显示:mui.showLoading('加载中...','div');

  隐藏:mui.hideLoading();

  其他mui弹窗效果,请移步官网文档查看!

 

  自定义封装

 

  物理按钮监听

 

  顶部进度条

  顶部进度条采用NProgress插件

  在main主页面中引入,head.html的最开始处调用start

 

    <!-- 顶部进度条开始 -->
    <head>
        <script>
            //顶部进度条开始,子页面加载才调用
            if(window.location.pathname !== "/muiwrapper/main"){
                window.parent.NProgress.start();
            }
        </script>
    </head>

 

  在iframe的onload回调中调用done

        //顶部进度条结束
        window.NProgress.done();

 

 

  更新、补充

  2020-04-27更新:

  1、新增底部按钮动态配置,真正项目应用中,可以从数据库动态读取,这样的话后面需要调整按钮配置也不需要修改代码,直接改配置即可

  底部按钮

 

   以及对于的iframe

 

 

  2、自定义弹窗,告警、确认弹窗内部调用父类显示,回调依旧执行子iframe的方法,效果就是遮阴层能后覆盖标题栏、底部按钮

 

   3、优化代码main.html代码,尽量使用thymeleaf语法;开启初始化所有页面功能,页面提前加载、提高后续切换页面体验;

   

 

  2020-06-01更新

  1、优化tab页切换效果,实现过渡动画,而不是直接切换;

 

  2、同tab页中,div窗体切换效果实现;

 

  3、新增自定义键盘(来自大佬的开源组件分享:https://www.jianshu.com/p/cb21ca8786a4,不支持中文),主要用于输入密码等对安全行为要求较高的动作

 

 

  后记

  注意,浏览器访问需要打开控制台,切换到移动端模式,还有我们的适配器判断过于简单,有些情况下会判断错误,例如360浏览器

  

  代码其实不多,主要涉及都父、子窗口相互调用的问题,基于mui的H5套壳APP开发web框架暂时记录到这,后续再进行补充

 

  代码开源

  代码已经开源、托管到我的GitHub、码云:

  GitHub:https://github.com/huanzi-qch/springBoot

  码云:https://gitee.com/huanzi-qch/springBoot

posted @ 2020-04-18 18:05  huanzi-qch  阅读(855)  评论(0编辑  收藏