canvas

画布。

属性名 类型 默认值 说明
canvas-id String canvas 组件的唯一标识符
disable-scroll Boolean false 当在 canvas 中移动时且有绑定手势事件时，禁止屏幕滚动以及下拉刷新
bindtouchstart EventHandle 手指触摸动作开始
bindtouchmove EventHandle 手指触摸后移动
bindtouchend EventHandle 手指触摸动作结束
bindtouchcancel EventHandle 手指触摸动作被打断，如来电提醒，弹窗
bindlongtap EventHandle 手指长按 500ms 之后触发，触发了长按事件后进行移动不会触发屏幕的滚动
binderror EventHandle 当发生错误时触发 error 事件，detail = {errMsg: 'something wrong'}

注：

    • canvas 标签默认宽度300px、高度225px
    • 同一页面中的 canvas-id 不可重复，如果使用一个已经出现过的 canvas-id，该 canvas 标签对应的画布将被隐藏并不再正常工作

示例代码：下载

在开发者工具中预览效果

  1. <!-- canvas.wxml -->
  2. <canvas style="width: 300px; height: 200px;" canvas-id="firstCanvas"></canvas>
  3. <!-- 当使用绝对定位时，文档流后边的 canvas 的显示层级高于前边的 canvas -->
  4. <canvas style="width: 400px; height: 500px;" canvas-id="secondCanvas"></canvas>
  5. <!-- 因为 canvas-id 与前一个 canvas 重复，该 canvas 不会显示，并会发送一个错误事件到 AppService -->
  6. <canvas style="width: 400px; height: 500px;" canvas-id="secondCanvas" binderror="canvasIdErrorCallback"></canvas>
  1. // canvas.js
  2. Page({
  3.   canvasIdErrorCallback: function (e) {
  4.     console.error(e.detail.errMsg)
  5.   },
  6.   onReady: function (e) {
  7.     // 使用 wx.createContext 获取绘图上下文 context
  8.     var context = wx.createCanvasContext('firstCanvas')
  10.     context.setStrokeStyle("#00ff00")
  11.     context.setLineWidth(5)
  12.     context.rect(0, 0, 200, 200)
  13.     context.stroke()
  14.     context.setStrokeStyle("#ff0000")
  15.     context.setLineWidth(2)
  16.     context.moveTo(160, 100)
  17.     context.arc(100, 100, 60, 0, 2 * Math.PI, true)
  18.     context.moveTo(140, 100)
  19.     context.arc(100, 100, 40, 0, Math.PI, false)
  20.     context.moveTo(85, 80)
  21.     context.arc(80, 80, 5, 0, 2 * Math.PI, true)
  22.     context.moveTo(125, 80)
  23.     context.arc(120, 80, 5, 0, 2 * Math.PI, true)
  24.     context.stroke()
  25.     context.draw()
  26.   }
  27. })

相关api：wx.createCanvasContext

Bug & Tip
  • tip: canvas 组件是由客户端创建的原生组件，它的层级是最高的，不能通过 z-index 控制层级。
  • tip: 请勿在 scroll-view、swiper、picker-view、movable-view 中使用 canvas 组件。
  • tip: css 动画对 canvas 组件无效。
  • bug: 避免设置过大的宽高，在安卓下会有crash的问题

原文:

https://developers.weixin.qq.com/miniprogram/dev/component/canvas.html#canvas