返回

H5页面跳转小程序的正确打开方式

前端

小程序的流行让用户逐渐养成了扫码打开小程序的习惯。但是,在H5页面跳转小程序时,却没有提供可视化的操作引导,这往往会给用户带来不便。为了解决这个问题,本文将手把手教你使用<wx-open-launch-weapp>组件,让H5页面也能实现无缝跳转小程序的功能。

<wx-open-launch-weapp>组件详解

<wx-open-launch-weapp>组件是微信官方提供的H5跳转小程序的专用组件,它提供了两种跳转方式:

  • 直接跳转:通过appidpath参数,直接跳转到指定的小程序页面。
  • 弹窗授权跳转:通过appidextUrldesc参数,先弹出授权窗口,用户同意授权后,再跳转到指定的小程序页面。

H5跳转小程序的步骤

1. 引入<wx-open-launch-weapp>组件

在H5页面头部引入<wx-open-launch-weapp>组件:

<script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script>

2. 定义跳转逻辑

在H5页面中定义<wx-open-launch-weapp>组件,并设置必要的参数:

<wx-open-launch-weapp
  id="launch-btn"
  appid="wx123456789"
  path="/pages/index/index"
></wx-open-launch-weapp>

其中:

  • appid:小程序的唯一标识符。
  • path:要跳转到的小程序页面的路径。

3. 绑定点击事件

<wx-open-launch-weapp>组件绑定点击事件,触发跳转动作:

const launchBtn = document.getElementById('launch-btn');
launchBtn.addEventListener('click', function() {
  wx.miniProgram.navigateLaunch({
    appId: 'wx123456789',
    path: '/pages/index/index'
  });
});

4. 处理授权

如果需要弹出授权窗口,需要额外设置extUrldesc参数:

<wx-open-launch-weapp
  id="launch-btn"
  appid="wx123456789"
  extUrl="https://www.example.com/authorize"
  desc="点击按钮授权登录小程序"
></wx-open-launch-weapp>
const launchBtn = document.getElementById('launch-btn');
launchBtn.addEventListener('click', function() {
  wx.miniProgram.navigateTo({
    appId: 'wx123456789',
    extUrl: 'https://www.example.com/authorize',
    desc: '点击按钮授权登录小程序'
  });
});

注意事項

  • <wx-open-launch-weapp>组件只支持在微信浏览器中使用。
  • <wx-open-launch-weapp>组件不能使用HTML格式,所有属性值都必须用双引号包裹。
  • <wx-open-launch-weapp>组件的<wx-open-launch-weapp>组件不能嵌套在其他<wx-open-launch-weapp>组件中。