Skip to content

MakerGYT/share

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Mini-share

GitHub stars

微信小程序分享组件,可通过可视化设计并导出json,生成分享海报模板

虽然目前提供了监听右上角菜单“分享到朋友圈”按钮行为的接口(beta版,暂仅在Android平台支持),但是限制众多。图片式分享仍然是目前可以跨越朋友关系,跨越平台的较好方式。

效果展示

截图 截图 使用案例

如何使用

  1. 获取组件
git clone https://github.com/MakerGYT/share.git
  1. 引入组件
└── components
    ├── painter
    └── share

将share和painter复制到组件文件夹下,并通过配置文件引入本组件:

{
  "usingComponents":{
    "share":"/components/share/share"
  }
}
  1. 使用组件
<!-- index.wxml -->
<button bindtap="toShare" type="primary">分享</button>
<share show="{{shareShow}}" bind:setPoster="toMoments" palette="{{palette}}"></share>
// index.js
import Poster from 'poster.js';
Page({
  data: {
    shareShow: false
  },
  toShare: function(e) {
    this.setData({
      shareShow: true
    })
  },
  toMoments: function () {
    this.setData({
      palette: new Poster(params).palette()
    })
  },
})

海报模板文件通过工具绘制,保存到poster.js

// poster.js
export default class Poster{
  constructor(params) {
    this.params = params;
  }
  palette() {
    return ({
      ...
    })
  }
}

Tips:

  • 如果是在Tab页调用组件,由于底部Tabbar层级较高,海报尺寸较长时会被其遮挡操作,可以通过showPosterclosePoster两个事件状态控制Tabbar的显隐。
  • 尺寸单位支持rpx
  • 可通过提取公共样式来简化和压缩海报模板文件

属性列表

属性 类型 默认值 必填 说明
show Boolean false 是否显示
palette Object 是  海报数据源
mask Boolean true 是否显示背景蒙层
maskClosable Boolean false 点击背景蒙层是否可以关闭
bind:setPoster eventhandler 点击分享到朋友圈时触发的事件,一般用来生成和传入实例化后的海报数据
bind:showPoster eventhandler 海报生成后触发的事件,,event.detail = {path}
bind:closePoster eventhandler 关闭海报后触发的事件,event.detail = {saved}

依赖

Painter,修复了一些问题,pull257:

  • 支持canvas2D
  • 修复保存图片出错
  • 修复真机自定义字体无法显示
  • 修复画布尺寸较大导致的出错
  • 修复真机图片模糊
  • 规范部分语法

License

Apache-2.0 © MakerGYT