# CanvasGradient对象

> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：**
> 从API version 4开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

渐变对象。


## addColorStop

addColorStop(offset: number, color: string): void

设置渐变断点值，包括偏移和颜色。

- 参数
  | 参数 | 类型 | 描述 |
  | -------- | -------- | -------- |
  | offset | number | 设置渐变点距离起点的位置占总体长度的比例，范围为0到1。 |
  | color | string | 设置渐变的颜色。 |

- 示例
  ```
  <!-- xxx.hml -->
  <div>
    <canvas ref="canvas" style="width: 500px; height: 500px; background-color: #ffff00;"></canvas>
    <input type="button" style="width: 180px; height: 60px;" value="fillStyle" onclick="handleClick" />
  </div>
  ```

  ```
  // xxx.js
  export default {
    handleClick() {
      const el =this.$refs.canvas;
      const ctx =el.getContext('2d');
      const gradient = ctx.createLinearGradient(0,0,100,0);
      gradient.addColorStop(0,'#00ffff');
      gradient.addColorStop(1,'#ffff00');
    }
  }
  ```

  ![zh-cn_image_0000001152610806](figures/zh-cn_image_0000001152610806.png)