欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

微信小程序分享功能onShareAppMessage(options)用法分析

程序员文章站 2023-11-14 13:50:34
本文实例讲述了微信小程序分享功能onshareappmessage(options)用法。分享给大家供大家参考,具体如下: 在页面的js文件中定义了 onshareapp...

本文实例讲述了微信小程序分享功能onshareappmessage(options)用法。分享给大家供大家参考,具体如下:

在页面的js文件中定义了 onshareappmessage 函数时,页面可以表示改页面可以转发。可以在函数中设置页面转发的信息。

1. 只有定义了该函数,小程序右上角的菜单中才会有转发按钮

2. 用户点击转发按钮的时候回调用该函数

3. 该函数内需要 return 一个 object,object中包含转发的信息(可自定义转发的内容)

页面中有可以触发转发时间的地方有两个:

  一个是右上角菜单中的转发按钮
  另一个是页面中具有属性open-type且其值为share的button。(注:必须是button组件,其他组件中设置 open-type="share" 无效)
  即:

<button data-name="sharebtn" open-type="share">转发</button>

  注意:实际开发中会发现这个 button 自带有样式,当背景颜色设置为白色的时候还有一个黑色的边框,刚开始那个边框怎么都去不掉,后来给button加了一个样式属性 plain="true" 以后,再在样式文件中控制样式 button[plain]{ border:0 } ,就可以比较随便的自定义样式了,比如说将分享按钮做成一个图标等

触发分享事件后调用的函数:

onshareappmessage: function( options ){
  var that = this;
  // 设置菜单中的转发按钮触发转发事件时的转发内容
  var shareobj = {
    title: "转发的标题",    // 默认是小程序的名称(可以写slogan等)
    path: '/pages/share/share',    // 默认是当前页面,必须是以‘/'开头的完整路径
    imageurl: '',   //自定义图片路径,可以是本地文件路径、代码包文件路径或者网络图片路径,支持png及jpg,不传入 imageurl 则使用默认截图。显示图片长宽比是 5:4
    success: function(res){
      // 转发成功之后的回调
      if(res.errmsg == 'shareappmessage:ok'){
      }
    },
    fail: function(){
      // 转发失败之后的回调
      if(res.errmsg == 'shareappmessage:fail cancel'){
        // 用户取消转发
      }else if(res.errmsg == 'shareappmessage:fail'){
        // 转发失败,其中 detail message 为详细失败信息
      }
    },
    complete: fucntion(){
      // 转发结束之后的回调(转发成不成功都会执行)
    }
  };
  // 来自页面内的按钮的转发
  if( options.from == 'button' ){
    var edata = options.target.dataset;
    console.log( edata.name );   // sharebtn
    // 此处可以修改 shareobj 中的内容
    shareobj.path = '/pages/btnname/btnname?btn_name='+edata.name;
  }
  // 返回shareobj
  return shareobj;
}

希望本文所述对大家微信小程序开发有所帮助。