#### 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'} | **注：** 1. **canvas 標簽默認寬度300px、高度225px** 2. **同一頁面中的 canvas-id 不可重復，如果使用一個已經出現過的 canvas-id，該 canvas 標簽對應的畫布將被隱藏并不再正常工作** **示例代碼：下載** ``` <!-- 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 重復，該 canvas 不會顯示，并會發送一個錯誤事件到 AppService --> <canvas style="width: 400px; height: 500px;" canvas-id="secondCanvas" binderror="canvasIdErrorCallback"></canvas> ``` ``` // canvas.js 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() } }) ``` 相關api：[wx.createCanvasContext](https://mp.weixin.qq.com/debug/wxadoc/dev/api/canvas/create-canvas-context.html) ##### Bug & Tip 1. `tip`: `canvas` 組件是由客戶端創建的原生組件，它的層級是最高的，不能通過 z-index 控制層級。 2. `tip`: 請勿在 `scroll-view`、`swiper`、`picker-view`、`movable-view` 中使用 `canvas` 組件。 3. `tip`: `css` 動畫對 `canvas` 組件無效。 4. `bug`: 避免設置過大的寬高，在安卓下會有crash的問題