canvas
画布。
属性说明
属性名 | 类型 | 默认值 | 说明 | 平台差异说明 |
---|---|---|---|---|
canvas-id | String | canvas 组件的唯一标识符 | ||
disable-scroll | Boolean | false | 当在 canvas 中移动时且有绑定手势事件时,禁止屏幕滚动以及下拉刷新 | 头条小程序不支持 |
@touchstart | EventHandle | 手指触摸动作开始 | 头条小程序不支持 | |
@touchmove | EventHandle | 手指触摸后移动 | 头条小程序不支持 | |
@touchend | EventHandle | 手指触摸动作结束 | 头条小程序不支持 | |
@touchcancel | EventHandle | 手指触摸动作被打断,如来电提醒,弹窗 | 头条小程序不支持 | |
@longtap | EventHandle | 手指长按 500ms 之后触发,触发了长按事件后进行移动不会触发屏幕的滚动 | 头条小程序不支持 | |
@error | EventHandle | 当发生错误时触发 error 事件,detail = {errMsg: 'something wrong'} | 头条小程序不支持 |
注意事项:
- canvas 标签默认宽度 300px、高度 225px,动态修改 canvas 大小后需要重新绘制。
- 同一页面中的 canvas-id 不可重复,如果使用一个已经出现过的 canvas-id,该 canvas 标签对应的画布将被隐藏并不再正常工作。
- canvas 在微信小程序、百度小程序中为原生组件,层级高于前端组件,请勿内嵌在 scroll-view、swiper、picker-view、movable-view 中使用。解决 canvas 层级过高无法覆盖,参考 native-component。
- canvas 在App端 vue 页面不是原生组件,目前App端 nvue 还不支持 canvas 组件。示例:
<template>
<view>
<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" @error="canvasIdErrorCallback"></canvas>
</view>
</template>
export default {
onReady: function (e) {
var context = uni.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()
},
methods: {
canvasIdErrorCallback: function (e) {
console.error(e.detail.errMsg)
}
}
}
相关 api:uni.createCanvasContext
扩展阅读
canvas的常用用途有图表和图片处理,在uni-app插件市场有大量基于canvas的插件,可搜索 图表 、 头像裁剪 、 海报 、 二维码 。
关于图表,H5端流行的echart报表因为涉及大量dom操作,无法跨端使用,而wx-chart在跨端和更新方面都不足,推荐使用uChart组件。但由于小程序和App在跟手操作和js操作帧动画方面性能不如web,如果这方面的需求,建议在web-view组件中使用html内嵌原版echart。
发现错误?想参与编辑?在 GitHub 上编辑此页面!