微信小程序---绘制指令

小程序文档：

https://developers.weixin.qq.com/miniprogram/dev/

创建小程序很简单，按文档走几步就行；生成的工程目录如下：

其中app.json和project.config.json是配置文件。

app.json

{

  "pages":[

    "pages/index/index"

  ],

  "window":{

    "backgroundTextStyle":"light",

    "navigationBarBackgroundColor": "#fff",

    "navigationBarTitleText": "",

    "navigationBarTextStyle":"black"

  }

}

pages字段 —— 用于描述当前小程序所有页面路径，这是为了让微信客户端知道当前你的小程序页面定义在哪个目录。

window字段 —— 小程序所有页面的顶部背景颜色，文字颜色定义在这里的。

看下本例子中的主页面: (page/index)

这是经典的 HTML + CSS + JS 样式，wxss相当于css样式，wxml相当于html，js就是js样式，json用于描述数据。

在wxml中定义一个Canvas组件:

在index.js中进行绘制：

Page({

  data: {

    winNum: 0

  },

  //生命周期，刚进来

  onLoad: function () {

  },

  canvasIdErrorCallback: function (e) {

    console.error(e.detail.errMsg)

  },

  onReady: function (e) {

    // 使用 wx.createContext 获取绘图上下文 context

    var ctx = wx.createCanvasContext('myCanvas')

    ctx.strokeRect(10, 10, 25, 15)

    ctx.setLineWidth(1)

    ctx.scale(2, 2)

    ctx.strokeRect(10, 10, 25, 15)

    ctx.scale(2, 2)

    ctx.strokeRect(10, 10, 25, 15)

    ctx.draw()

  }

})

绘制的方式如上，先从组件创建一个上下文，接着调用上下文的绘制api，最后draw出来。

看下绘制效果：

这段绘制程序，就是用不同比例进行矩形绘制，而且这个scale是可以叠加的。

更多绘制api的说明文档如下：

https://developers.weixin.qq.com/miniprogram/dev/api/canvas/reference.html

问题是，这里的js绘制指令，在android客户端上是怎么执行的？

先讲下过程：

1. 前端的调用绘制指令的js代码，其实是在一个js的对象上操作的，这些绘制指令会将信息汇聚到这个对象中。

2. 前端和客户端的交互，是通过webview的js bridge来进行的，客户端注册webview的js监听（addJavascriptInterface），收到相关数据（定义好的数据协议），然后再还原成像绘制指令一样的列表，再进行端上绘制。

补充：其中的数据格式，也是一个绘制列表，比如每个绘制指令是一个action结构的话，那么就是一个action列表的结构。

具体一点：

1. 前端写了js代码：

    ctx.strokeRect(10, 10, 25, 15)

    ctx.scale(2, 2)

    ctx.strokeRect(10, 10, 25, 15)

    ctx.draw()

2. 那么汇聚得到的传输数据大概是这样：

"canvasId":"myCanvas","actions":"[{\"method\":\"strokeRect\",\"data\":[10,10,25,15]},{\"method\":\"setLineWidth\",\"data\":[1]},{\"method\":\"scale\",\"data\":[2,2]},{\"method\":\"strokeRect\",\"data\":[10,10,25,15]},{\"method\":\"scale\",\"data\":[2,2]},{\"method\":\"strokeRect\",\"data\":[10,10,25,15]}]"

3. 在客户端上先解析这些数据，形成类似的Action列表数据，然后在View的onDraw中把这些指令绘制出来。

过程大体如此，那么绘制指令其实可以分为几批次，比如上下文相关的，形变类的，普通绘制（比如矩形，文本等）；在客户端的实现中，一定要注意执行的顺序（包括设定上下文的），不能在解析数据的时候就立即执行上下文设定否则会错乱。

另外微信绘制api基本是和android对齐的，因为大部分都有相同的绘制名称和参数对应上；ios的话就可能有点儿麻烦了。。。

先到这里。