基于mui的H5套壳APP开发web框架分享

时间:2022-11-01 20:25:11

  前言

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

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

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

  技术栈

  springboot + thymelea + mui

  效果演示

  目录结构

基于mui的H5套壳APP开发web框架分享

基于mui的H5套壳APP开发web框架分享

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

基于mui的H5套壳APP开发web框架分享  基于mui的H5套壳APP开发web框架分享  基于mui的H5套壳APP开发web框架分享基于mui的H5套壳APP开发web框架分享  基于mui的H5套壳APP开发web框架分享

  头、尾操作

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

基于mui的H5套壳APP开发web框架分享基于mui的H5套壳APP开发web框架分享

  

  按钮切换模式

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

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

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

  1 切换立即加载初始url

基于mui的H5套壳APP开发web框架分享

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

基于mui的H5套壳APP开发web框架分享

  mui loading

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

  隐藏:mui.hideLoading();

基于mui的H5套壳APP开发web框架分享

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

  自定义封装

基于mui的H5套壳APP开发web框架分享

  物理按钮监听

基于mui的H5套壳APP开发web框架分享

  顶部进度条

  顶部进度条采用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();

基于mui的H5套壳APP开发web框架分享

  更新、补充

  2020-04-27更新:

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

基于mui的H5套壳APP开发web框架分享

  底部按钮

基于mui的H5套壳APP开发web框架分享

  以及对于的iframe

基于mui的H5套壳APP开发web框架分享

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

基于mui的H5套壳APP开发web框架分享

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

基于mui的H5套壳APP开发web框架分享

  

  2020-06-01更新

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

基于mui的H5套壳APP开发web框架分享

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

基于mui的H5套壳APP开发web框架分享

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

基于mui的H5套壳APP开发web框架分享

  后记

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

  基于mui的H5套壳APP开发web框架分享

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

  代码开源

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

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

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