• canvas
    • Bug & Tip

    canvas

    画布。该组件是原生组件，使用时请注意相关限制。

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

    注：

    • canvas 标签默认宽度300px、高度150px
    • 同一页面中的 canvas-id 不可重复，如果使用一个已经出现过的 canvas-id，该 canvas 标签对应的画布将被隐藏并不再正常工作
    1. <!-- canvas.qml -->
    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
    7.   style="width: 400px; height: 500px;"
    8.   canvas-id="secondCanvas"
    9.   binderror="canvasIdErrorCallback"
    10. ></canvas>
    1. // canvas.js
    2. Page({
    3.   canvasIdErrorCallback(e) {
    4.     console.error(e.detail.errMsg)
    5.   },
    6.   onReady(e) {
    7.     // 使用 qq.createContext 获取绘图上下文 context
    8.     const context = qq.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：qq.createCanvasContext

    Bug & Tip
    • 请注意原生组件使用限制。
    • bug: 避免设置过大的宽高，在安卓下会有crash的问题