微信小程序畫布 canvas

基礎(chǔ)庫 1.0.0 開始支持，低版本需做兼容處理。

畫布。2.9.0 起支持一套新 Canvas 2D 接口（需指定 type 屬性），同時支持同層渲染，原有接口不再維護。相關(guān)api：獲取 canvas 實例。

Bug & Tip

1. tip：canvas 標簽?zāi)J寬度300px、高度150px
2. tip：同一頁面中的 canvas-id 不可重復(fù)，如果使用一個已經(jīng)出現(xiàn)過的 canvas-id，該 canvas 標簽對應(yīng)的畫布將被隱藏并不再正常工作
3. tip：請注意原生組件使用限制
4. tip：開發(fā)者工具中默認關(guān)閉了 GPU 硬件加速，可在開發(fā)者工具的設(shè)置中開啟“硬件加速”提高 WebGL 的渲染性能
5. tip: WebGL 支持通過 getContext('webgl', { alpha: true }) 獲取透明背景的畫布
6. tip: Canvas 2D（新接口）需要顯式設(shè)置畫布寬高 (默認為 300x150)
7. bug: 避免設(shè)置過大的寬高，在安卓下會有crash的問題

Canvas 2D 示例代碼

在開發(fā)者工具中預(yù)覽效果

  <!-- canvas.wxml -->
  <canvas type="2d" id="myCanvas"></canvas>

// canvas.js
Page({
  onReady() {
    const query = wx.createSelectorQuery()
    query.select('#myCanvas')
      .fields({ node: true, size: true })
      .exec((res) => {
        const canvas = res[0].node
        const ctx = canvas.getContext('2d')

        const dpr = wx.getSystemInfoSync().pixelRatio
        canvas.width = res[0].width * dpr
        canvas.height = res[0].height * dpr
        ctx.scale(dpr, dpr)

        ctx.fillRect(0, 0, 100, 100)
      })
  }
})

WebGL 示例代碼

在開發(fā)者工具中預(yù)覽效果

  <!-- canvas.wxml -->
  <canvas type="webgl" id="myCanvas"></canvas>

// canvas.js
Page({
  onReady() {
    const query = wx.createSelectorQuery()
    query.select('#myCanvas').node().exec((res) => {
      const canvas = res[0].node
      const gl = canvas.getContext('webgl')
      gl.clearColor(1, 0, 1, 1)
      gl.clear(gl.COLOR_BUFFER_BIT)
    })
  }
})

示例代碼（舊的接口）

在開發(fā)者工具中預(yù)覽效果 下載

<!-- 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 重復(fù)，該 canvas 不會顯示，并會發(fā)送一個錯誤事件到 AppService -->
<canvas style="width: 400px; height: 500px;" canvas-id="secondCanvas" binderror="canvasIdErrorCallback"></canvas>

Page({
  canvasIdErrorCallback: function (e) {
    console.error(e.detail.errMsg)
  },
  onReady: function (e) {
    // 使用 wx.createContext 獲取繪圖上下文 context
    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()
  }
})