微信小程序开发者交流群

admin

admin

发表于 2017-02-05 23:49:55

微信 小程序开发组件:画布canvas-微信 小程序开发教程


canvas

画布。

属性名类型默认值说明
canvas-idString
canvas 组件的唯一标识符
disable-scrollBooleanfalse当在 canvas 中移动时,禁止屏幕滚动以及下拉刷新
bindtouchstartEventHandle
手指触摸动作开始
bindtouchmoveEventHandle
手指触摸后移动
bindtouchendEventHandle
手指触摸动作结束
bindtouchcancelEventHandle
手指触摸动作被打断,如来电提醒,弹窗
bindlongtapEventHandle
手指长按 500ms 之后触发,触发了长按事件后进行移动不会触发屏幕的滚动
binderrorEventHandle
当发生错误时触发 error 事件,detail = {errMsg: 'something wrong'}

注:

  1. canvas 标签默认宽度300px、高度225px

  2. 同一页面中的 canvas-id 不可重复,如果使用一个已经出现过的 canvas-id,该 canvas 标签对应的画布将被隐藏并不再正常工作

示例代码:下载

<!-- 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>
// canvas.jsPage({
  canvasIdErrorCallback: function (e) {    console.error(e.detail.errMsg)
  },
  onReady: function (e) {    // 使用 wx.createContext 获取绘图上下文 context
    var context = wx.createContext()

    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()    // 调用 wx.drawCanvas,通过 canvasId 指定在哪张画布上绘制,通过 actions 指定绘制行为
    wx.drawCanvas({
      canvasId: 'firstCanvas',
      actions: context.getActions() // 获取绘图动作数组
    })
  }
})

相关api:wx.createCanvasContext

Bug & Tip

  1. tipcanvas 组件是由客户端创建的原生组件,它的层级是最高的。

  2. tip: 请勿在 scroll-view 中使用 canvas 组件。

  3. tipcss 动画对 canvas 组件无效。

扩展阅读:

微信 小程序开发组件-微信 小程序开发教程

微信 小程序开发组件:视图容器view,scroll-view,swiper-微信 小程序开发教程

微信 小程序开发组件:基础内容icon,text,progress-微信 小程序开发教程

微信 小程序开发组件:表单组件button,form,input,picker-微信 小程序开发教程

微信 小程序开发组件:导航navigator-微信 小程序开发教程

微信 小程序开发组件:媒体组件audio,image,video-微信 小程序开发教程

微信 小程序开发组件:地图map-微信 小程序开发教程

[文章]  微信 小程序开发组件:画布canvas-微信 小程序开发教程

微信 小程序开发组件:客服会话contact-button-微信 小程序开发教程


404阅读 | 0评论
你的回应