xref: /docs/zh-cn/application-dev/reference/apis-arkui/arkui-js/js-components-canvas-canvasgradient.md

# CanvasGradient对象

>  **说明：**
>  从API version 4开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

渐变对象。


## addColorStop

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

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

**参数：** 

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

**示例：** 

  ```html
<!-- xxx.hml -->
<div>
  <canvas ref="canvas" style="width: 500px; height: 500px; background-color: #ffff00;"></canvas>
</div>
  ```

  ```js
// xxx.js
export default {
    onShow() {
        const el = this.$refs.canvas;
        const ctx = el.getContext('2d');
        const gradient = ctx.createLinearGradient(50, 0, 300, 100);
        gradient.addColorStop(0.0, '#ff0000')
        gradient.addColorStop(0.5, '#ffffff')
        gradient.addColorStop(1.0, '#00ff00')
        ctx.fillStyle = gradient
        ctx.fillRect(0, 0, 300, 300)
    }
}
  ```

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