leafer-ui
Web 版 | Worker 版 | Node 版 | 小程序版
如果您仅需绘图功能,推荐更轻量的 leafer-draw。
安装
在小程序环境中运行,了解小程序使用 npm 包的注意事项。
sh
npm install @leafer-ui/miniapp
sh
pnpm add @leafer-ui/miniapp
sh
yarn add @leafer-ui/miniapp
sh
bun add @leafer-ui/miniapp
下载
你也可以将库文件直接下载到本地 import 引入。
sh
https://unpkg.com/@leafer-ui/miniapp@1.0.0-rc.27/dist/miniapp.module.js
https://unpkg.com/@leafer-ui/miniapp@1.0.0-rc.27/dist/miniapp.module.min.js
环境
微信小程序基础库 >= 2.30.0
其他平台等小程序也会陆续支持(先支持 canvas 2d 接口)
注意
微信小程序自身加载 svg 图片有问题。
阴影、遮罩等正在适配兼容性。
重要警告
微信小程序 iOS 端 3.0.0 之后 view 中的 canvas drawImage 无法绘制离屏画布 导致白屏(leafer-draw 的纯离屏画布模式可用)。
体验
创建一个交互应用,能够横屏,可以缩放平移视图、拖拽矩形。
将小程序 miniprogram/pages/index 文件夹下的页面替换成如下内容:
ts
import { Leafer, Rect } from '@leafer-ui/miniapp'
Page({
onReady() {
// this 为当前小程序页面实例
const leafer = new Leafer({ view: 'leafer', eventer: this })
const rect = new Rect({
x: 100,
y: 100,
width: 100,
height: 100,
fill: '#32cd79',
draggable: true,
})
leafer.add(rect)
},
receiveEvent() {}, // 约定接收交互事件的方法名
})
xml
<canvas
id="leafer"
type="2d"
catchtouchstart="receiveEvent"
catchtouchmove="receiveEvent"
catchtouchend="receiveEvent"
catchtouchcancel="receiveEvent"
></canvas>
css
page {
height: 100%;
}
#leafer {
width: 100%;
height: 100%;
}
json
{
"navigationStyle": "custom",
"pageOrientation": "auto"
}
生成海报
自动保存到相册。
ts
leafer.export('album.png').then(() => {
// 提示保存到相册成功逻辑
})
体验产品案例
采用小程序的 web-view 组件实现。