大网数据广告活动
Web 标准与前端开发

CanvasRenderingContext2D:createRadialGradient() 方法

· 52CE 我爱测

Canvas 2D API 的 **`CanvasRenderingContext2D.createRadialGradient()`** 方法使用两个圆的坐标和大小绘制径向渐变。

Canvas 2D API 的 CanvasRenderingContext2D.createRadialGradient() 方法使用两个圆的坐标和大小绘制径向渐变。

这个方法返回 CanvasGradient。要将其应用于形状,必须首先将渐变赋值给 CanvasRenderingContext2D.fillStyle 或 CanvasRenderingContext2D.strokeStyle 属性。

[!NOTE] 渐变坐标是全局的,即相对于当前的坐标空间。当应用于形状时,这些坐标并不是相对于形状本身的坐标。

语法

createRadialGradient(x0, y0, r0, x1, y1, r1)

createRadialGradient() 方法由六个参数指定,三个参数定义渐变的起始圆,另外三个参数定义渐变的结束圆。

参数

  • x0
    • : 开始圆形的 x 轴坐标。
  • y0
    • : 开始圆形的 y 轴坐标。
  • r0
    • : 开始圆形的半径。必须为非负有限值。
  • x1
    • : 结束圆形的 x 轴坐标。
  • y1
    • : 结束圆形的 y 轴坐标。
  • r1
    • : 结束圆形的半径。必须为非负有限值。

返回值

  • CanvasGradient
    • : 一个使用指定的两个圆初始化的径向 CanvasGradient。

异常

  • NotSupportedError DOMException
    • : 当在参数中传递非有限值时抛出。
  • IndexSizeError DOMException
    • : 当在参数追踪传递负半径时抛出。

示例

用径向渐变填充矩形

此示例使用 createRadialGradient() 方法初始化一个径向渐变。然后在渐变的两个圆之间创建了三个色标。最后,将渐变赋值给画布上下文,并将其渲染到一个填充的矩形上。

HTML

<canvas id="canvas" width="200" height="200"></canvas>

JavaScript

const canvas = document.getElementById("canvas");
const ctx = canvas.getContext("2d");

// 创建一个径向渐变
// 内圆位于 x=110、y=90,半径为 30
// 外圆位于 x=100,、y=100,半径为 70
const gradient = ctx.createRadialGradient(110, 90, 30, 100, 100, 70);

// 添加三个色标
gradient.addColorStop(0, "pink");
gradient.addColorStop(0.9, "white");
gradient.addColorStop(1, "green");

// 设置填充样式并绘制矩形
ctx.fillStyle = gradient;
ctx.fillRect(20, 20, 160, 160);

结果

用径向渐变填充矩形

规范

浏览器兼容性

参见

  • 定义此方法的接口:CanvasRenderingContext2D
  • CanvasRenderingContext2D.createLinearGradient()
  • CanvasRenderingContext2D.createConicGradient()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。