微信小程序嵌入 H5 页面(webview)基本用法和父子传参数说明

背景:

最近实现一个功能需要在小程序嵌入其它系统内部的一个页面(用vue写的H5页面),但小程序是无法使用iframe的,所以最终选择小程序官方的webview实现,本文对基本用法和父子传参进行说明。 所以下面将说明:

  1. 小程序官网配置业务域名
  2. 标签的用法。
  3. 父子传参数。
  4. H5 跳转回小程序。

一、 小程序官网配置业务域名

小程序官方要求配置,如果不配置在趁机上会无法打开,但在微信开发者工具正常
步骤: 在微信小程序后台,开发-开发管理-开发设置-业务域名 这里添加需要嵌入到小程序里面 H5 页面的合法域名(最多200个);

二、标签的用法

web-view 承载网页的容器。会自动铺满整个小程序页面,不能像iframe那样能设置某个区域

ini 复制代码
直接使用标签即可
 <web-view src="xxxxxxxxxx"></web-view>

三、父子传参数

以下我把本地小程序形容为父,被嵌入系统形容为子
父传子:

ini 复制代码
 <web-view src="{{webUrl}}"/>
javascript 复制代码
created() { 
    // H5获取token const wxobj = {} 
    window.location.href.replace(/([^?&=]+)=([^&]+)/g, (_, k, v) => (wxobj[k] = v)) 
    if ( wxobj.token) { 
        store.commit( 'user/setToken', wxobj.token) 
    } 
}

父用url拼接过去,子通过window.location.href.replace获取到内容

子传父:

在子系统(被嵌入) 需要安装官方的weixin-js-sdk包:

(1)安装:

csharp 复制代码
 pnpm add weixin-js-sdk

(2)使用的页面引入:

javascript 复制代码
import wx from "weixin-js-sdk";

(3)使用传参给父:

css 复制代码
wx.miniProgram.postMessage({ 
    data: { token } 
});

父系统(小程序)

ini 复制代码
<web-view src="{{webUrl}}" bindmessage="getMessage"/>
javascript 复制代码
//接收网页数据
 getMessage: function (res) {
    let token = res.detail.data;
    this.setData({ token });
  },

四、 H5 跳转回小程序。

需要用到上面引入的weixin-js-sdk包

javascript 复制代码
const name = '天天'
wx.miniProgram.navigateTo({
  url: `/pages/my/my?name=${name}` , // 小程序地址
  success () {
    console.log('question success')
  },
  fail (error) {
    console.log(error)
  }
})

父系统能拿到?后面的传参数

javascript 复制代码
onLoad(option) { 
    this.name = JSON.parse(option.name); 
},

更多weixin-js-sdk包的API可以去官网查:点击跳去

相关推荐
粉嘟小飞妹儿2 分钟前
JavaScript对象创建的几种灵活方法
前端
前端小万5 分钟前
2026年了,为什么我突然开始做GZH?
前端
子兮曰12 分钟前
Harness 驾驭工程深度教程:从 AGENTS.md 到全链路 AI 编码基础设施
前端·后端·ai编程
木子雨廷37 分钟前
Flutter 桌面小组件开发
前端·flutter
还有多久拿退休金40 分钟前
我在自家页面嵌了个 iframe,结果对方说"你不配"——跨域和 CSP 的那些坑
前端·架构
Awu122741 分钟前
🍎Google Stitch :用自然语言做 UI 设计,把设计师的活也抢了
前端·aigc·ai编程
竹林8181 小时前
从“连接不上”到“交易成功”:我用 @solana/web3.js 在 React 中搞定 Solana 钱包交互的全过程
前端
YouCanYouUp.1 小时前
掌控感心理学解析:人类最底层的心理需求
前端
wyc是xxs1 小时前
浏览器解析HTML头部的底层逻辑
前端·html
义嘉泰1 小时前
一颗 NAND Flash 的自我修养
前端·人工智能·芯片