CanvasContext.createLinearGradient

收藏

我的收藏

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

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

创建一个线性的渐变颜色。返回的 CanvasGradient 对象需要使用 CanvasGradient.addColorStop 来指定渐变点，至少要两个。

语法

CanvasContext.createLinearGradient(sx, sy, dx, dy)

参数说明

sx

类型	默认值	必填	说明	最低支持版本
number		是	起点位置的 x 坐标	1.0.0

sy

类型	默认值	必填	说明	最低支持版本
number		是	起点位置的 y 坐标	1.0.0

dx

类型	默认值	必填	说明	最低支持版本
number		是	目标位置的 x 坐标	1.0.0

dy

类型	默认值	必填	说明	最低支持版本
number		是	目标位置的 y 坐标	1.0.0

返回值

无

扫码体验

代码示例

开发者工具中预览

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

// index.js
Page({
  onReady: function () {
    const ctx = tt.createCanvasContext("myCanvas");

    // 创建线性渐变色
    const grd = ctx.createLinearGradient(0, 0, 200, 0);
    // 指定渐变点
    grd.addColorStop(0, "blue");
    grd.addColorStop(1, "white");

    // 绘制
    ctx.setFillStyle(grd);
    ctx.fillRect(0, 0, 200, 120);
    ctx.draw();
  },
});

Bug & Tip

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