1# Image对象
2
3>  **说明：**
4>  从API version 4开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
5
6图片对象。
7
8
9## 属性
10
11| 属性      | 类型             | 默认值  | 必填   | 描述                |
12| ------- | -------------- | ---- | ---- | ----------------- |
13| src     | string         | -    | 是    | 图片资源的路径。          |
14| width   | <length> | 0px  | 否    | 图片的宽度。            |
15| height  | <length> | 0px  | 否    | 图片的高度。            |
16| onload  | Function       | -    | 否    | 图片加载成功后触发该事件，无参数。 |
17| onerror | Function       | -    | 否    | 图片加载失败后触发该事件，无参数。 |
18
19
20## 示例
21
22```html
23<!-- xxx.hml -->
24<div>
25  <canvas ref="canvas" style="width: 500px; height: 500px; "></canvas>
26</div>
27```
28
29```js
30// xxx.js
31export default {
32    onShow() {
33        const el = this.$refs.canvas;
34        var ctx = el.getContext('2d');
35        var img = new Image();
36        // 图片路径建议放在common目录下
37        img.src = 'common/images/example.jpg';
38        img.onload = function () {
39            console.log('Image load success');
40            ctx.drawImage(img, 0, 0, 360, 250);
41        };
42        img.onerror = function () {
43            console.log('Image load fail');
44        };
45    }
46}
47```
48
49
50![zh-cn_image_0000001198530395](figures/zh-cn_image_0000001198530395.png)
51