news 2026/4/17 10:23:21

小程序中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/4/18 3:49:21

MoE架构视频生成终极指南：从技术原理到实战部署

MoE架构视频生成终极指南&#xff1a;从技术原理到实战部署 【免费下载链接】Wan2.2-T2V-A14B-Diffusers 项目地址: https://ai.gitcode.com/hf_mirrors/Wan-AI/Wan2.2-T2V-A14B-Diffusers 阿里巴巴达摩院推出的Wan 2.2模型正在重新定义视频生成技术的边界。这款基于混…

作者头像 李华
网站建设 2026/4/17 17:05:07

btpanel-v7.7.0离线部署实战指南

在当今企业级服务器管理场景中&#xff0c;网络隔离环境已成为常态。无论是金融行业的合规要求&#xff0c;还是制造企业的生产网络隔离&#xff0c;传统依赖在线安装的宝塔面板部署方式往往面临严峻挑战。本文将深度解析如何在没有外网连接的环境下&#xff0c;成功部署btpane…

作者头像 李华
网站建设 2026/4/18 3:45:11

沉浸式翻译扩展实战指南：五大典型故障深度解析与修复方案

沉浸式翻译扩展实战指南&#xff1a;五大典型故障深度解析与修复方案 【免费下载链接】immersive-translate 沉浸式双语网页翻译扩展 , 支持输入框翻译&#xff0c; 鼠标悬停翻译&#xff0c; PDF, Epub, 字幕文件, TXT 文件翻译 - Immersive Dual Web Page Translation Extens…

作者头像 李华
网站建设 2026/4/18 3:50:30

百胜软件×头部影院：以数字之力，重塑影院零售新体验

在电影开场前&#xff0c;买一桶爆米花、一杯可乐&#xff0c;几乎是每位观众的习惯动作。然而&#xff0c;在这看似简单的消费背后&#xff0c;却隐藏着一个庞大而复杂的零售系统。与百胜软件合作的某头部影院&#xff0c;在全国拥有上千家家影院&#xff0c;遍布各大核心商圈…

作者头像 李华
网站建设 2026/4/18 7:58:27

自动控制原理中，什么样的动态过程是好的？

目录 1. 核心性能指标（对单位阶跃响应而言） 2. 理想目标与工程折衷 3. 不同应用场景的侧重点 总结：一个好的动态过程应满足 在自动控制原理中，一个“好”的动态过程通常是指系统在受到输入信号（如阶跃信号）或扰动作用后，其输出响应能够快速、平稳、准确地达到并保持…

作者头像 李华
网站建设 2026/4/18 8:31:41

Qt中QSharedMemory析构处理指南

1.QSharedMemory 变量在对象析构的时候要怎么处理在Qt中使用QSharedMemory时&#xff0c;对象析构时的正确处理至关重要&#xff0c;主要涉及共享内存的释放和跨进程同步问题。以下是关键处理原则和步骤&#xff1a;1. 自动析构行为&#xff08;Qt内置机制&#xff09;自动deta…

作者头像 李华