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

CanvasRenderingContext2D:ellipse() 方法

· 52CE 我爱测

Canvas 2D API 的 **`CanvasRenderingContext2D.ellipse()`** 方法用于向当前子路径添加椭圆弧。

Canvas 2D API 的 CanvasRenderingContext2D.ellipse() 方法用于向当前子路径添加椭圆弧。

语法

ellipse(x, y, radiusX, radiusY, rotation, startAngle, endAngle)
ellipse(x, y, radiusX, radiusY, rotation, startAngle, endAngle, counterclockwise)

参数

  • x
    • : 椭圆圆心的 x 轴(水平)坐标。
  • y
    • : 椭圆圆心的 y 轴(垂直)坐标。
  • radiusX
    • : 椭圆长轴的半径。必须为非负数。
  • radiusY
    • : 椭圆短轴的半径。必须为非负数。
  • rotation
    • : 椭圆的旋转角度,以弧度表示。
  • startAngle
    • : 椭圆弧的起始偏心角,从正 x 轴沿顺时针测量,用弧度表示。
  • endAngle
    • : 椭圆弧的结束偏心角,从正 x 轴沿顺时针测量,用弧度表示。
  • counterclockwise
    • : 一个可选的布尔值,如果为 true,则逆时针绘制椭圆弧。默认值为 false(顺时针)。

返回值

无(undefined)。

示例

画完整的椭圆

此示例以 π/4 弧度(45**°)的角度绘制一个椭圆。为了绘制完整的椭圆,弧的起始角度为 0 弧度(0°),结束角度为 2π 弧度(360°**)。

HTML

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

JavaScript

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

// 绘制椭圆
ctx.beginPath();
ctx.ellipse(100, 100, 50, 75, Math.PI / 4, 0, 2 * Math.PI);
ctx.stroke();

// 绘制椭圆的对称轴
ctx.beginPath();
ctx.setLineDash([5, 5]);
ctx.moveTo(0, 200);
ctx.lineTo(200, 0);
ctx.stroke();

结果

画完整的椭圆

不同的椭圆弧

此示例创建了三条具有不同属性的椭圆路径。

HTML

<canvas id="canvas"></canvas>

JavaScript

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

ctx.fillStyle = "red";
ctx.beginPath();
ctx.ellipse(60, 75, 50, 30, Math.PI * 0.25, 0, Math.PI * 1.5);
ctx.fill();

ctx.fillStyle = "blue";
ctx.beginPath();
ctx.ellipse(150, 75, 50, 30, Math.PI * 0.25, 0, Math.PI);
ctx.fill();

ctx.fillStyle = "green";
ctx.beginPath();
ctx.ellipse(240, 75, 50, 30, Math.PI * 0.25, 0, Math.PI, true);
ctx.fill();

结果

不同的椭圆弧

规范

浏览器兼容性

参见

  • 定义该方法的接口:CanvasRenderingContext2D
  • 使用 CanvasRenderingContext2D.arc() 方法来绘制圆弧

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

资料来源与适用范围

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

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

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