news 2026/8/7 15:06:26

小程序中web-view加载uni-app H5如何使用postMessage方法的解决方案

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
小程序中web-view加载uni-app H5如何使用postMessage方法的解决方案

【问题1】怎么在uniapp H5中嵌入uni sdk?
根据官方提供的,h5配置中有个index.html模板路径,默认为空,可定制生成的html代码,自定义meta、引入外部js等,参考
在项目根目录建立一个template.h5.html(仿照hello-uni-app项目),然后在h5配置中填入template.h5.html

template.h5.html中的代码可以直接先复制官方提供的h5-template自定义模板的代码,或者下面的代码
然后将uni-sdk等第三方引入到html中,注意这里就有个小坑: uni sdk放到body下面!下面!下面! 这里不注意的话,可能会根据我们的习惯放到body里面。
template.h5.html:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title> <%= htmlWebpackPlugin.options.title %> </title>
<!-- Open Graph data -->
<!-- <meta property="og:title" content="Title Here" /> -->
<!-- <meta property="og:url" content="http://www.example.com/" /> -->
<!-- <meta property="og:image" content="http://example.com/image.jpg" /> -->
<!-- <meta property="og:description" content="Description Here" /> -->
<script>
var coverSupport = 'CSS' in window && typeof CSS.supports === 'function' && (CSS.supports('top: env(a)') || CSS.supports('top: constant(a)'))
document.write('<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0' + (coverSupport ? ', viewport-fit=cover' : '') + '" />')
</script>
<link rel="stylesheet" href="<%= BASE_URL %>static/index.<%= VUE_APP_INDEX_CSS_HASH %>.css" />
</head>
<body>
<noscript>
<strong>Please enable JavaScript to continue.</strong>
</noscript>
<div id="app"></div>
<!-- built files will be auto injected -->
</body>
<script type="text/javascript">
var userAgent = navigator.userAgent;
if (userAgent.indexOf('AlipayClient') > -1) {
// 支付宝小程序的 JS-SDK 防止 404 需要动态加载,如果不需要兼容支付宝小程序,则无需引用此 JS 文件。
document.writeln('<script src="https://appx/web-view.min.js"' + '>' + '<' + '/' + 'script>');
} else if (/QQ/i.test(userAgent) && /miniProgram/i.test(userAgent)) {
// QQ 小程序
document.write('<script type="text/javascript" src="https://qqq.gtimg.cn/miniprogram/webview_jssdk/qqjssdk-1.0.0.js"><\/script>');
} else if (/miniProgram/i.test(userAgent) && /micromessenger/i.test(userAgent)) {
// 微信小程序 JS-SDK 如果不需要兼容微信小程序,则无需引用此 JS 文件。
document.write('<script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.4.0.js"><\/script>');
} else if (/toutiaomicroapp/i.test(userAgent)) {
// 头条小程序 JS-SDK 如果不需要兼容头条小程序,则无需引用此 JS 文件。
document.write('<script type="text/javascript" src="https://s3.pstatp.com/toutiao/tmajssdk/jssdk-1.0.1.js"><\/script>');
} else if (/swan/i.test(userAgent)) {
// 百度小程序 JS-SDK 如果不需要兼容百度小程序,则无需引用此 JS 文件。
document.write('<script type="text/javascript" src="https://b.bdstatic.com/searchbox/icms/searchbox/js/swan-2.0.18.js"><\/script>');
} else if (/quickapp/i.test(userAgent)) {
// quickapp
document.write('<script type="text/javascript" src="https://quickapp/jssdk.webview.min.js"><\/script>');
}
if (!/toutiaomicroapp/i.test(userAgent) && document.querySelector('.post-message-section')) {
document.querySelector('.post-message-section').style.visibility = 'visible';
}
</script>
<!-- uni 的 SDK -->
<script type="text/javascript" src="https://js.cdn.aliyun.dcloud.net.cn/dev/uni-app/uni.webview.1.5.2.js"></script>
<script>
document.addEventListener('UniAppJSBridgeReady', function() {
console.log(uni, uni.webView)
uni.webView.getEnv(function(res) {
console.log('当前环境:' + JSON.stringify(res));
});
<!--经过测试验证这里已经成功了-->
uni.webView.navigateTo({
url:'/pages/test1/test1'
})
});
</script>
</html>

【问题2】web-view 加载 uni-app H5,内部跳转冲突如何解决?
该问题也是在web-view的下面的FAQ中有说明
使用 uni.webView.navigateTo…,这样就避免了与内部uni.navigateTo的冲突
注意:再次提醒下uni sdk放到body下面,否则uni.webView是找不到的

【问题】uniappzz+VUE3中的自定义模板template.h5.html不生效?
根据做项目的时候发现在使用VUE3模式下,自定义模板template.h5.html不生效,而生效是默认的index.html,那么就可以直接在index.html中写:
注意:这里还有个坑,uni.webView应该在初始的时候就用变量保存下来,后面直接用变量,不能在document.addEventListener(‘UniAppJSBridgeReady’, function() {})中去保存,否则拿不到uni.webView
index.html:

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0" />
<title></title>
<!--preload-links-->
<!--app-context-->
</head>
<body>
<div id="app"><!--app-html--></div>
<script type="module" src="/main.js"></script>
<script type="text/javascript">
var userAgent = navigator.userAgent;
if (userAgent.indexOf('AlipayClient') > -1) {
// 支付宝小程序的 JS-SDK 防止 404 需要动态加载,如果不需要兼容支付宝小程序,则无需引用此 JS 文件。
document.writeln('<script src="https://appx/web-view.min.js"' + '>' + '<' + '/' + 'script>');
} else if (/QQ/i.test(userAgent) && /miniProgram/i.test(userAgent)) {
// QQ 小程序
document.write('<script type="text/javascript" src="https://qqq.gtimg.cn/miniprogram/webview_jssdk/qqjssdk-1.0.0.js"><\/script>');
} else if (/miniProgram/i.test(userAgent) && /micromessenger/i.test(userAgent)) {
// 微信小程序 JS-SDK 如果不需要兼容微信小程序,则无需引用此 JS 文件。
document.write('<script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.4.0.js"><\/script>');
} else if (/toutiaomicroapp/i.test(userAgent)) {
// 头条小程序 JS-SDK 如果不需要兼容头条小程序,则无需引用此 JS 文件。
document.write('<script type="text/javascript" src="https://s3.pstatp.com/toutiao/tmajssdk/jssdk-1.0.1.js"><\/script>');
} else if (/swan/i.test(userAgent)) {
// 百度小程序 JS-SDK 如果不需要兼容百度小程序,则无需引用此 JS 文件。
document.write('<script type="text/javascript" src="https://b.bdstatic.com/searchbox/icms/searchbox/js/swan-2.0.18.js"><\/script>');
} else if (/quickapp/i.test(userAgent)) {
// quickapp
document.write('<script type="text/javascript" src="https://quickapp/jssdk.webview.min.js"><\/script>');
}
if (!/toutiaomicroapp/i.test(userAgent) && document.querySelector('.post-message-section')) {
document.querySelector('.post-message-section').style.visibility = 'visible';
}
</script>
<script type="text/javascript" src="https://js.cdn.aliyun.dcloud.net.cn/dev/uni-app/uni.webview.1.5.2.js"></script>
<script type="text/javascript">
var uniWebView = uni.webView;//必须在这时候保存下来
console.log(uniWebView)
uniWebView.getEnv(function(res) {
console.log('当前环境:' + JSON.stringify(res));
});
</script>
</body>
</html>

补充:h5中获取小程序或父级传递的参数
可以将此方法写到公共调用的地方,话不多说,直接上代码:

function getQuery(name) {
let reg = new RegExp("(^|&)"+ name +"=([^&]*)(&|$)");
let r = decodeURIComponent(window.location.search).substr(1).match(reg);
if(r != null) {
// 对参数值进行解码
return decodeURIComponent(r[2]);
}
return null;
}

使用的时候直接调用:const id = getQuery(‘id’);

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/8/7 23:02:44

42、Vile 9.6 选项设置与常见问题解决指南

Vile 9.6 选项设置与常见问题解决指南 1. Vile 9.6 选项介绍 Vile 9.6 拥有 167 个选项(在 Vile 中称为“模式”),这些选项根据用途可分为通用模式、缓冲区模式或窗口模式。此外,还有 101 个环境变量,这些变量在脚本中比直接供用户操作更有用。不过,并非所有选项和变量…

作者头像 李华
网站建设 2026/8/7 23:38:54

UniHacker终极指南:免费解锁Unity完整开发环境的简单方法

还在为Unity软件的高昂授权费用而烦恼吗&#xff1f;想要零成本体验完整功能的Unity开发环境吗&#xff1f;UniHacker就是你一直在寻找的完美解决方案&#xff01;这款跨平台开源工具专为Unity开发者设计&#xff0c;帮助你在Windows、MacOS和Linux系统上轻松绕过授权限制&…

作者头像 李华
网站建设 2026/8/7 18:09:03

软考-系统集成项目管理工程师案例简答题

一、项目管理概论 1&#xff0e;项目管理原则 &#xff08;1&#xff09;勤勉、尊重和关心他人&#xff1b; &#xff08;2&#xff09;营造协作的项目团队环境&#xff1b; &#xff08;3&#xff09;促进干系人有效参与&#xff1b; &#xff08;4&#xff09;聚焦于价值&…

作者头像 李华
网站建设 2026/8/7 16:01:49

4.2 技术文档自动生成:从代码到专业文档的转化

4.2 技术文档自动生成:从代码到专业文档的转化 在软件开发过程中,技术文档的编写往往是一项耗时且容易被忽视的工作。然而,高质量的技术文档对于项目的维护、团队协作和知识传承至关重要。本节课将介绍如何利用AI工具(特别是Cursor和Claude Code)自动生成专业级技术文档,…

作者头像 李华
网站建设 2026/8/7 11:40:08

FMEA在软件可靠性测试中的实践与应用

1. FMEA方法论概述与软件测试适配性 失效模式与影响分析&#xff08;Failure Mode and Effects Analysis&#xff0c;FMEA&#xff09;作为系统化的风险管理方法&#xff0c;已在制造业领域成熟应用数十年。随着软件系统复杂度的指数级增长&#xff0c;该方法在软件可靠性测试…

作者头像 李华