属性说明
属性 | 类型 | 默认值 | 必填 | 说明 | 最低版本 |
---|---|---|---|---|---|
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} |
ug & Tip
tip
:canvas 标签默认宽度300px、高度150pxtip
:同一页面中的 canvas-id 不可重复,如果使用一个已经出现过的 canvas-id,该 canvas 标签对应的画布将被隐藏并不再正常工作tip
:请注意原生组件使用限制tip
:开发者工具中默认关闭了 GPU 硬件加速,可在开发者工具的设置中开启“硬件加速”提高 WebGL 的渲染性能tip
: WebGL 支持通过 getContext('webgl', { alpha: true }) 获取透明背景的画布tip
: WebGL 暂不支持真机调试,建议使用真机预览tip
: Canvas 2D(新接口)需要显式设置画布宽高,默认:300*150
,最大:1365*1365
bug
: 避免设置过大的宽高,在安卓下会有crash的问题tip
: iOS 暂不支持 pointer-eventstip
: 在 mac 或 windows 小程序下,若当前组件所在的页面或全局开启了enablePassiveEvent
配置项,该内置组件可能会出现非预期表现(详情参考 enablePassiveEvent 文档)
Canvas 2D 示例代码