微信小程序画布 canvas

本文整理自网络，侵删。

基础库 1.0.0 开始支持，低版本需做兼容处理。

画布。2.9.0 起支持一套新 Canvas 2D 接口（需指定 type 属性），同时支持同层渲染，原有接口不再维护。相关api：获取 canvas 实例。

属性	类型	默认值	必填	说明	最低版本
type	string		否	指定 canvas 类型，支持 2d (2.9.0) 和 webgl (2.7.0)	2.7.0
canvas-id	string		否	canvas 组件的唯一标识符，若指定了 type 则无需再指定该属性	1.0.0
disable-scroll	boolean	false	否	当在 canvas 中移动时且有绑定手势事件时，禁止屏幕滚动以及下拉刷新	1.0.0
bindtouchstart	eventhandle		否	手指触摸动作开始	1.0.0
bindtouchmove	eventhandle		否	手指触摸后移动	1.0.0
bindtouchend	eventhandle		否	手指触摸动作结束	1.0.0
bindtouchcancel	eventhandle		否	手指触摸动作被打断，如来电提醒，弹窗	1.0.0
bindlongtap	eventhandle		否	手指长按 500ms 之后触发，触发了长按事件后进行移动不会触发屏幕的滚动	1.0.0
binderror	eventhandle		否	当发生错误时触发 error 事件，detail = {errMsg}	1.0.0

Bug & Tip

1. tip：canvas 标签默认宽度300px、高度150px
2. tip：同一页面中的 canvas-id 不可重复，如果使用一个已经出现过的 canvas-id，该 canvas 标签对应的画布将被隐藏并不再正常工作
3. tip：请注意原生组件使用限制
4. tip：开发者工具中默认关闭了 GPU 硬件加速，可在开发者工具的设置中开启“硬件加速”提高 WebGL 的渲染性能
5. tip: WebGL 支持通过 getContext('webgl', { alpha: true }) 获取透明背景的画布
6. tip: Canvas 2D（新接口）需要显式设置画布宽高 (默认为 300x150)
7. bug: 避免设置过大的宽高，在安卓下会有crash的问题

Canvas 2D 示例代码

在开发者工具中预览效果

  <!-- canvas.wxml -->  <canvas type="2d" id="myCanvas"></canvas>

// canvas.jsPage({  onReady() {    const query = wx.createSelectorQuery()    query.ｓｅｌｅｃｔ('#myCanvas')      .fields({ node: true, size: true })      .ｅｘｅｃ((res) => {        const canvas = res[0].node        const ctx = canvas.getContext('2d')        const dpr = wx.getSystemInfoSync().pixelRatio        canvas.width = res[0].width * dpr        canvas.height = res[0].height * dpr        ctx.scale(dpr, dpr)        ctx.fillRect(0, 0, 100, 100)      })  }})

WebGL 示例代码

在开发者工具中预览效果

  <!-- canvas.wxml -->  <canvas type="webgl" id="myCanvas"></canvas>

// canvas.jsPage({  onReady() {    const query = wx.createSelectorQuery()    query.ｓｅｌｅｃｔ('#myCanvas').node().ｅｘｅｃ((res) => {      const canvas = res[0].node      const gl = canvas.getContext('webgl')      gl.clearColor(1, 0, 1, 1)      gl.clear(gl.COLOR_BUFFER_BIT)    })  }})

示例代码（旧的接口）

在开发者工具中预览效果 下载

<!-- canvas.wxml --><canvas style="width: 300px; height: 200px;" canvas-id="firstCanvas"></canvas><!-- 当使用绝对定位时，文档流后边的 canvas 的显示层级高于前边的 canvas --><canvas style="width: 400px; height: 500px;" canvas-id="secondCanvas"></canvas><!-- 因为 canvas-id 与前一个 canvas 重复，该 canvas 不会显示，并会发送一个错误事件到 AppService --><canvas style="width: 400px; height: 500px;" canvas-id="secondCanvas" binderror="canvasIdErrorCallback"></canvas>

Page({  canvasIdErrorCallback: function (e) {    console.error(e.detail.errMsg)  },  onReady: function (e) {    // 使用 wx.createContext 获取绘图上下文 context    var context = wx.createCanvasContext('firstCanvas')    context.setStrokeStyle("#00ff00")    context.setLineWidth(5)    context.rect(0, 0, 200, 200)    context.stroke()    context.setStrokeStyle("#ff0000")    context.setLineWidth(2)    context.moveTo(160, 100)    context.arc(100, 100, 60, 0, 2 * Math.PI, true)    context.moveTo(140, 100)    context.arc(100, 100, 40, 0, Math.PI, false)    context.moveTo(85, 80)    context.arc(80, 80, 5, 0, 2 * Math.PI, true)    context.moveTo(125, 80)    context.arc(120, 80, 5, 0, 2 * Math.PI, true)    context.stroke()    context.draw()  }})

标签：微信小程序

相关阅读 >>

微信小程序 模板(template)

微信小程序 运力方使用onaddorder

微信小程序云开发sdk文档 微信支付查询订单

微信小程序 运力方使用onriderscoreset

微信小程序 基础组件

微信小程序 weuiuploader

在微信小程序api绘图中创建三次方贝塞尔曲线路径

微信小程序 城市服务快速填写组件

微信小程序云开发服务端存储api 从云存储空间删除文件

微信小程序 getplugindevapplylist

更多相关阅读请进入《微信小程序》频道 >>

书籍

Vue.js 设计与实现 基于Vue.js 3 深入解析Vue.js 设计细节

￥83.86元   人民邮电出版社

本书对 Vue.js 3 技术细节的分析非常可靠，对于需要深入理解 Vue.js 3 的用户会有很大的帮助。——尤雨溪，Vue.js作者