H5跳转小程序,uniapp跳转小程序

以你之姓@ 2023-01-17 07:48 350阅读 0赞

网页跳转小程序需要使用微信的开放标签 wx-open-launch-weapp ,使用开放标签需要使用微信的jssdk,然后sdk的版本不能低,低版本点击无效。

先给官方文档的链接 点击跳转

建议认真看完,这个坑有点多

1.必须有插槽的代码,以下二选一,不用会报错,并且设置不了样式,样式需要在插槽里面设置

  1. <wx-open-launch-weapp id="launch-btn" username="gh_837e1111111">
  2. <template>
  3. <style>.btn { padding: 12px }</style>
  4. <button class="btn">打开小程序</button>
  5. </template>
  6. </wx-open-launch-weapp>

vue

  1. <wx-open-launch-weapp id="launch-btn" username="gh_837e1111111">
  2. <script type="text/wxtag-template">
  3. <style>.btn { display: flex;align-items: center; }</style>
  4. <div> <button class="wx-btn">跳转小程序4</button> </div>
  5. </script>
  6. </wx-open-launch-weapp>

2.必须确保jssdk ready ,并且在config里面设置了 openTagList:[‘wx-open-launch-weapp’] ,没设置会点击无效

  1. $wx.config({
  2. debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印。
  3. appId: configData.appid, // 必填,公众号的唯一标识
  4. timestamp: configData.timestamp, // 必填,生成签名的时间戳
  5. nonceStr: configData.noncestr, // 必填,生成签名的随机串
  6. signature: configData.signature, // 必填,签名
  7. jsApiList: ['openEnterpriseChat', 'openEnterpriseContact'],
  8. openTagList:['wx-open-launch-weapp']
  9. });

3.sdk的版本不能低,低版本点击无效,导入jssdk包

  1. npm install jweixin-module --save

使用:

  1. let jweixin = require('jweixin-module')
  2. Vue.prototype.$wx = jweixin

4.一定要配置JS接口安全域名,只有在配置的JS接口安全域名访问,才能跳转小程序

开放标签开放对象

  1. 已认证的服务号,服务号绑定“JS接口安全域名”下的网页可使用此标签跳转任意合法合规的小程序。
  2. 已认证的非个人主体的小程序,使用小程序云开发的静态网站托管绑定的域名下的网页,可以使用此标签跳转任意合法合规的小程序。

实现网页跳转小程序的操作步骤:

使用步骤

微信开放标签使用步骤与微信JS-SDK类似,也需要引入JS文件等步骤。如果是公众号身份的网页,需要绑定安全域名,如果是使用小程序云开发静态网站托管的小程序网页,则不需绑定安全域名即可直接使用(即跳过下面”步骤一:绑定安全域名”)。

  1. 绑定域名

登录微信公众平台进入“公众号设置”的“功能设置”里填写“JS接口安全域名”。

  1. 引入JS文件

在需要调用JS接口的页面引入如下JS文件:http://res.wx.qq.com/open/js/jweixin-1.6.0.js (支持https)

如需进一步提升服务稳定性,当上述资源不可访问时,可改访问:http://res2.wx.qq.com/open/js/jweixin-1.6.0.js (支持https)

备注:支持使用 AMD/CMD 标准模块加载方法加载。

  1. 通过config接口注入权限验证配置并申请所需开放标签

与使用JS-SDK配置方式相同,所有需要使用开放标签的页面必须先注入配置信息,并通过openTagList字段申请所需要的开放标签,否则将无法使用(同一个url仅需调用一次)。开放标签的申请和JS接口的申请相互独立,因此是可以同时申请的。

  1. wx.config({
  2. debug: true, // 开启调试模式,调用的所有api的返回值会在客户端alert出来,若要查看传入的参数,可以在pc端打开,参数信息会通过log打出,仅在pc端时才会打印
  3. appId: '', // 必填,公众号的唯一标识
  4. timestamp: , // 必填,生成签名的时间戳
  5. nonceStr: '', // 必填,生成签名的随机串
  6. signature: '',// 必填,签名
  7. jsApiList: [], // 必填,需要使用的JS接口列表
  8. openTagList: [] // 可选,需要使用的开放标签列表,例如['wx-open-launch-app']
  9. });

签名算法见JS-SDK说明文档的附录,所有开放标签列表见文末的附录1。

  1. 通过ready接口处理成功验证

    wx.ready(function () {
    // config信息验证后会执行ready方法,所有接口调用都必须在config接口获得结果之后,config是一个客户端的异步操作,所以如果需要在页面加载时就调用相关接口,则须把相关接口放在ready函数中调用来确保正确执行。对于用户触发时才调用的接口,则可以直接调用,不需要放在ready函数中
    });

  1. 通过error接口处理失败验证

    wx.error(function (res) {
    // config信息验证失败会执行error函数,如签名过期导致验证失败,具体错误信息可以打开config的debug模式查看,也可以在返回的res参数中查看,对于SPA可以在这里更新签名
    });

使用说明

所有开放标签都能像普通的HTML标签一样在页面中直接使用,不需要再进行额外的处理。

如果所使用的标签允许提供插槽,由于插槽中模版的样式是和页面隔离的,因此需要注意在插槽中定义模版的样式。插槽模版及样式均需要通过<template></template>进行包裹。对于Vue等视图框架,为了避免template标签冲突的问题,可使用<script type="text/wxtag-template"></script>进行代替,来包裹插槽模版和样式。另外,对于具名插槽还需要通过slot属性声明插槽名称,下文标签插槽中的default插槽为默认插槽,可不声明插槽名称。

对于标签事件,均可通过event.detail获得详细信息。如果无特殊说明,下文标签事件说明中的返回值均指代event.detail中的内容。

另外,需要注意以下几点:

  1. 页面中与布局和定位相关的样式,如position: fixed; top -100;等,尽量不要写在插槽模版的节点中,请声明在标签或其父节点上;
  2. 对于有CSP要求的页面,需要添加白名单frame-src https://*.qq.com webcompt:,才能在页面中正常使用开放标签。

发表评论

表情:
评论列表 (有 0 条评论,350人围观)

还没有评论,来说两句吧...

相关阅读

    相关 H5网页程序

    现在小程序越来越普遍了,从H5网页(要在微信浏览器下打开的)跳转到相应小程序的场景也越来越多。至此微信提供了相应的[微信开放标签][Link 1]让网页开发者可安全便捷地使用微

    相关 程序

    一.跳转问题 (1).小程序跳转H5:     官网暂不支持直接跳转H5,只能通过嵌套web-view,来访问H5的页面。 [web-view注意事项][web-view