文档

# Canvas 画布

所有在 <canvas> 中的画图必须用 JavaScript 完成：

QML：（我们在接下来的例子中如无特殊声明都会用这个 QML 为模板，不再重复）

<canvas canvas-id="myCanvas" style="border: 1px solid;" />
1

JS：（我们在接下来的例子中会将 JS 放在 onLoad 中）

const ctx = qq.createCanvasContext('myCanvas')
ctx.setFillStyle('red')
ctx.fillRect(10, 10, 150, 75)
ctx.draw()
1
2
3
4

第一步：创建一个 Canvas 绘图上下文

首先，我们需要创建一个 Canvas 绘图上下文 CanvasContext。

CanvasContext 是小程序内建的一个对象，有一些绘图的方法：

const ctx = qq.createCanvasContext('myCanvas')
1

第二步：使用 Canvas 绘图上下文进行绘图描述

接着，我们来描述要在 Canvas 中绘制什么内容。

设置绘图上下文的填充色为红色：

ctx.setFillStyle('red')
1

用 fillRect(x, y, width, height) 方法画一个矩形，填充为刚刚设置的红色：

ctx.fillRect(10, 10, 150, 75)
1

第三步：画图

告诉 <canvas> 组件你要将刚刚的描述绘制上去：

ctx.draw()
1

结果：

# 坐标系

canvas 是在一个二维的网格当中。左上角的坐标为(0, 0)。

在上一节，我们用了这个方法 fillRect(0, 0, 150, 75)。

它的含义为：从左上角(0, 0)开始，画一个150 x 75px 的矩形。

代码示例

我们可以在 <canvas> 中加上一些事件，来观测它的坐标系

<canvas
  canvas-id="myCanvas"
  style="margin: 5px; border:1px solid #d3d3d3;"
  bindtouchstart="start"
  bindtouchmove="move"
  bindtouchend="end"
/>

<view hidden="{{hidden}}">
  Coordinates: ({{x}}, {{y}})
</view>
1
2
3
4
5
6
7
8
9
10
11
Page({
  data: {
    x: 0,
    y: 0,
    hidden: true
  },
  start(e) {
    this.setData({
      hidden: false,
      x: e.touches[0].x,
      y: e.touches[0].y
    })
  },
  move(e) {
    this.setData({
      x: e.touches[0].x,
      y: e.touches[0].y
    })
  },
  end(e) {
    this.setData({
      hidden: true
    })
  }
})
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

当你把手指放到 canvas 中，就会在下边显示出触碰点的坐标：

# 渐变

渐变能用于填充一个矩形，圆，线，文字等。填充色可以不固定位固定的一种颜色。

我们提供了两种颜色渐变的方式：

一旦我们创建了一个渐变对象，我们必须添加两个颜色渐变点。

addColorStop(position, color) 方法用于指定颜色渐变点的位置和颜色，位置必须位于0到1之间。

可以用setFillStyle 和 setStrokeStyle 方法设置渐变，然后进行画图描述。

使用 createLinearGradient()

const ctx = qq.createCanvasContext('myCanvas')

// Create linear gradient
const grd = ctx.createLinearGradient(0, 0, 200, 0)
grd.addColorStop(0, 'red')
grd.addColorStop(1, 'white')

// Fill with gradient
ctx.setFillStyle(grd)
ctx.fillRect(10, 10, 150, 80)
ctx.draw()
1
2
3
4
5
6
7
8
9
10
11

使用 createCircularGradient()

const ctx = qq.createCanvasContext('myCanvas')

// Create circular gradient
const grd = ctx.createCircularGradient(75, 50, 50)
grd.addColorStop(0, 'red')
grd.addColorStop(1, 'white')

// Fill with gradient
ctx.setFillStyle(grd)
ctx.fillRect(10, 10, 150, 80)
ctx.draw()
1
2
3
4
5
6
7
8
9
10
11

← 分包加载 →