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标签对应的画布将被隐藏并不再正常工作
示例代码:
<canvas style="width: 300px; height: 200px;" canvas-id="firstCanvas"></canvas>
<canvas style="width: 400px; height: 500px;" canvas-id="secondCanvas"></canvas>
<canvas style="width: 400px; height: 500px;" canvas-id="secondCanvas" binderror="canvasIdErrorCallback"></canvas>
Page({
canvasIdErrorCallback: function (e) {
console.error(e.detail.errMsg)
},
onReady: function (e) {
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()
}
})
相关api:wx.createCanvasContext
Bug & Tip
-
tip
:canvas
组件是由客户端创建的原生组件,它的层级是最高的。
-
tip
: 请勿在scroll-view
中使用canvas
组件。
-
tip
:css
动画对canvas
组件无效。
更多
微信小程序开发教程,可以关注hi小程序。