写在前面
最近在做小程序,发现制作分享到朋友圈图片是每个项目必须的。遇到坑比较多,写起来也比较繁琐,也没有找到类似组件,所以就自己动手写了一个。
演示
左侧是 canvasdrawer 绘制的,右侧是UI给的图
特性
- 简单易用 —— 一个
json 搞定绘制图片
- 功能全 —— 满足
90% 的使用场景
- 绘制文本(换行、超出内容省略号、中划线、下划线、文本加粗)
- 绘制图片
- 绘制矩形
- 保存图片
- 多图绘制
- ...
- 代码量小
体验
git clone https://github.com/kuckboy1994/mp_canvas_drawer
复制代码
想在手机上使用配置自己的 appid 即可。
编译模式中已经为你配置好比较常用的两种模式:
- 普通绘制,绘制单张分享图。
- 多图绘制,连续绘制分享图
使用
-
git clone https://github.com/kuckboy1994/mp_canvas_drawer 到本地
-
把 components 中的 canvasdrawer 拷贝到自己项目下。
-
在使用页面注册组件
{
"usingComponents": {
"canvasdrawer": "/components/canvasdrawer/canvasdrawer"
}
}
复制代码
-
在页面 **.wxml 文件中加入如下代码
<canvasdrawer painting="{{painting}}" bind:getImage="eventGetImage"/>
复制代码
painting 是需要传入的 json 。 getImage 方法是绘图完成之后的回调函数,在 event.detail 中返回绘制完成的图片地址。
-
当前栗子中的 painting 简单展示一下。详细配置请看 API
painting(点击展开)
{
width: 375,height: 555,views: [
{
type: 'image',url: 'https://hybrid.xiaoying.tv/miniprogram/viva-ad/1/1531103986231.jpeg',top: 0,left: 0,width: 375,height: 555
},{
type: 'image',url: 'https://wx.qlogo.cn/mmopen/vi_32/DYAIOgq83epJEPdPqQVgv6D8bojGT4DrGXuEC4Oe0GXs5sMsN4GGpCegTUsBgL9SPJkN9UqC1s0iakjQpwd4h4A/132',top: 27.5,left: 29,width: 55,height: 55
},url: 'https://hybrid.xiaoying.tv/miniprogram/viva-ad/1/1531401349117.jpeg',{
type: 'text',content: '您的好友【kuckboy】',fontSize: 16,color: '#402D16',textAlign: 'left',top: 33,left: 96,bolder: true
},content: '发现一件好货,邀请你一起0元免费拿!',fontSize: 15,color: '#563D20',top: 59.5,left: 96
},url: 'https://hybrid.xiaoying.tv/miniprogram/viva-ad/1/1531385366950.jpeg',top: 136,left: 42.5,width: 290,height: 186
},url: 'https://hybrid.xiaoying.tv/miniprogram/viva-ad/1/1531385433625.jpeg',top: 443,left: 85,width: 68,height: 68
},content: '正品MAC魅可口红礼盒生日唇膏小辣椒Chili西柚情人',lineHeight: 21,color: '#383549',top: 336,left: 44,width: 287,MaxLineNumber: 2,breakWord: true,content: '¥0.00',fontSize: 19,color: '#E62004',top: 387,left: 44.5,content: '原价:¥138.00',fontSize: 13,color: '#7E7E8B',top: 391,left: 110,textDecoration: 'line-through'
},content: '长按识别图中二维码帮我砍个价呗~',fontSize: 14,top: 460,left: 165.5,lineHeight: 20,width: 125
}
]
}
复制代码
API
对象结构一览
{
width: 375,url: 'url',content: 'content',{
type: 'rect',background: 'color',height: 555
}
]
}
复制代码
数据对象的第一层需要三个参数: width 、height 、views 。配置中所有的数字都是没有单位的。这就意味着 canvas 绘制的是一个比例图。具体显示的大小直接把返回的图片路径放置到 image 标签中即可。
当前可以绘制3种类型的配置: image 、text 、rect 。配置的属性基本上使用的都是 css 的驼峰名称,还是比较好理解的。
image(图片)
text(文本)
rect (矩形,线条)
Q&A
-
最佳实践
绘制操作的时候最好 锁住屏幕 ,例如在点击绘制的时候
wx.showLoading({
title: '绘制分享图片中',mask: true
})
复制代码
绘制完成之后
wx.hideLoading()
复制代码
具体可以参考项目下的 /pages/multiple
-
二维码和小程序码如何绘制?
- 二维码和小程序码可以通过调用微信官方的接口产生,需要后端配合。
- 然后走
type: image 类型进行绘制即可。
-
绘制流程相关
-
views 数组中的顺序代表绘画的先后顺序,会有覆盖的现象。请各位使用者注意。
-
如何实现圆形头像?
-
canvas 中没有绘制圆形图片的方法,所以使用了 hack 的方式来实现的。使用一张中间镂空的图片盖在头像上就可实现当前效果。
-
canvas drawer 组件为什么不直接显示canvas画板和其内容呢?
- 考虑到大部分场景,我们都是用来把图片保存到本地,或用以展示。
- 保存到本地,返回临时文件给调用者一定是最佳的解决方式。
- 展示,转化成图片之后,就可以使用
image 基础组件的所有显示模式了,还能设置宽高。
TIPS?
如果有什么疑问,欢迎 issues 。 如果觉得不错,能不能送我小 ? ? ,然我有更多的动力更新。
github:github.com/kuckboy1994…
(编辑:李大同)
【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!
|