CanvasGradient.addColorStop

收藏

我的收藏

注意：该接口已停止维护，建议使用 Canvas 组件 V2

基础库 1.0.0 开始支持本方法，这是一个同步方法。

添加颜色的渐变点。小于最小 stop 的部分会按最小 stop 的 color 来渲染，大于最大 stop 的部分会按最大 stop 的 color 来渲染。

语法

CanvasContext.addColorStop(stop, color)

参数说明

stop

类型	默认值	必填	说明	最低支持版本
number		是	表示渐变中开始与结束之间的位置，范围 0 ～ 1	1.0.0

color

类型	默认值	必填	说明	最低支持版本
string		是	渐变点的颜色	1.0.0

返回值

无

扫码体验

代码示例

开发者工具中预览

<!-- index.ttml -->
<canvas canvas-id="myCanvas"></canvas>

// index.js
Page({
  onLoad: function (options) {
    const canvasCtx = tt.createCanvasContext("myCanvas");

    // 创建线性渐变
    const grd = canvasCtx.createLinearGradient(30, 10, 120, 10);
    grd.addColorStop(0, "red");
    grd.addColorStop(0.16, "orange");
    grd.addColorStop(0.33, "yellow");
    grd.addColorStop(0.5, "green");
    grd.addColorStop(0.66, "cyan");
    grd.addColorStop(0.83, "blue");
    grd.addColorStop(1, "purple");

    // 填充
    canvasCtx.setFillStyle(grd);
    canvasCtx.fillRect(10, 10, 150, 80);
    canvasCtx.draw();
  },
});

Bug & Tip

• Tip：本 API 仅适用于<canvas> 组件 V1。