Taro小程序中web-view组件实现H5页面跳转与通信详解
本文介绍在Taro框架下使用web-view组件实现小程序内嵌H5页面的完整流程。涵盖路由配置、参数传递、页面跳转封装以及H5与小程序间通过postMessage进行单向通信的具体实现方法,帮助开发者解决小程序与H5交互中的数据传递问题。
小程序web-view组件基础配置
微信官方文档关于 web-view 组件的说明

本示例构建了一个仅用于渲染 webView 组件的页面

配置路由跳转时,路径前缀需指定为‘/subPages/webView/index?weburl=https://xxxxx’

webview页面参数获取与渲染
在 componentDidMount 生命周期中,从路由参数里提取 weburl 地址
async componentDidMount() {
const router = getCurrentInstance().router;
const params = router.params;
let url = params.weburl;
// 对url进行参数处理 ,可以增加需要传递给H5的token等其他参数
this.setState({
url: url, // 获取其他小程序页面 请求跳转的地址
});
}
render() {
const { url } = this.state;
return (
<WebView
src={decodeURIComponent(url)} // H5地址 加上域名的全链路地址
onMessage={(res) => {
this.setPostMessage(res.detail.data); // 存储H5传回来的数据 可以存到公共区域 方便使用
}}
/>
);
}
小程序跳转H5页面的实现方式
执行页面跳转的具体方式如下:
const token=''; // 自行获取token
const weburl='' ;// 自行定义地址
Taro.navigateTo({
url: `/subPages/webView/index?weburl=${weburl}&token=${token}` ,
});
上述代码演示了跳转至小程序内的 webview.jsx 页面,并传递目标 H5 地址 weburl
在 webview 页面加载阶段,获取 H5 地址并将其赋值给 web-view 组件
H5跳转逻辑的封装优化
若多处需跳转至域名固定的 H5 页面,建议封装 Taro.navigateTo 方法
具体封装案例如下:
const toWebFun = (type = 'navigateTo') => {
return function (url, isRequireToken) {
const params = queryToObj(url); //
const token = Taro.getStorageSync(ConstantList.TOKEN); //
const host = Config.HOST_H5; // H5固定域名
const TaroNavigate = type === 'redirectTo' ? Taro.redirectTo : Taro.navigateTo;
let path = '';
let tokenKey = '?token=';
let ismini = '?ismini=1'; // 个人定义代表小程序内打开H5 方便区分
// 带有https链接情况 就不使用host固定域名
if (url.includes('https://')) {
path = `/subPages/webView/index?weburl=${encodeURIComponent(
`${url}${url.indexOf('?') > -1 ? '&token=' : '?token='}${token}&ismini=1`,
)}`;
TaroNavigate({
url: path,
});
return;
}
// 如果连接本身带有?后面参数 则不要覆盖 而是追加
if (url.indexOf('?') !== -1) {
tokenKey = '&token=';
ismini = '&ismini=1';
}
if (isRequireToken) { // 是否需要登录的页面
if (token) {
path = `/subPages/webView/index?weburl=${encodeURIComponent(`${host}#${url + tokenKey + token}${ismini}`)} `;
} else {
// 需要登录 有没有token的情况 先跳转登录 然后 带上url登陆后继续执行跳转操作 又会继续执行toWebFun 函数
Taro.navigateTo({
url: `/subPages/login/index?redirectTo=${url}`,
});
return;
}
} else {
// 无需token
path = `/subPages/webView/index?weburl=${encodeURIComponent(`${host}#${url}${ismini}`)}`;
}
TaroNavigate({
url: path,
});
};
};
export const navigateToWeb = toWebFun();
在其他页面中,通过调用 navigateToWeb 函数来跳转 H5 页面
H5与小程序的通信机制
H5 页面需提供返回小程序页面及向小程序传递数据的方法

小程序与网页间的通信机制为单向,即仅允许网页向小程序发送消息,反之不可
// H5与小程序交互的方式
// 返回小程序首页
wx.miniProgram.navigateTo({url: '/pages/home/index'})
// 给小程序传递参数
wx.miniProgram.postMessage({ data: 'foo' })
// 给小程序传递复杂参数
wx.miniProgram.postMessage({ data: {foo: 'bar'} })
// 小程序web-view 存储H5传回来的数据
// onMessage={(res) => {
// this.setPostMessage(res.detail.data); // 存储H5传回来的数据
// }}
// 获取当前环境
wx.miniProgram.getEnv(function(res) { console.log(res.miniprogram) })
// 小程序下的H5 去小程序的虚拟订单页
wx.miniProgram.navigateTo({url:`/subPages/virtualOrderList/virtualOrderList?type=coupon`});小程序可在跳转前通过 URL 携带参数,或利用后端缓存获取 ID 后拼接至 URL,H5 端通过该 ID 获取缓存数据
内容总结
至此,关于小程序利用 webView 实现内嵌 H5 页面的介绍结束,更多相关内容请参阅本站历史文章或继续浏览后续文章,感谢支持!
JS空字符串、null和undefined转数字的结果是什么
2026-11-05 14:49:16
CodePen、JSFiddle与StackBlitz:主流JS在线编辑器对比
2026-11-05 13:38:29
JS怎么将时间戳转换为“刚刚”、“几分钟前”等相对时间
2026-11-05 12:55:14
JavaScript将儒略日逆向还原为公历日期时间的实现方法
2026-11-04 23:51:05
能在我的世界手机版直接修改JS代码吗
2026-11-04 19:02:53
