Taro小程序中web-view组件实现H5页面跳转与通信详解

作者:小满时间:2026-10-31 14:48:01浏览:336

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

小程序web-view组件基础配置

微信官方文档关于 web-view 组件的说明

小程序web-view组件基础配置

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

小程序web-view组件基础配置

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

小程序web-view组件基础配置

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 页面需提供返回小程序页面及向小程序传递数据的方法

小程序web-view组件基础配置

小程序与网页间的通信机制为单向,即仅允许网页向小程序发送消息,反之不可

// 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 页面的介绍结束,更多相关内容请参阅本站历史文章或继续浏览后续文章,感谢支持!

作者最新文章