This page was translated from English by the community. Learn more and join the MDN Web Docs community.

CanvasRenderingContext2D.arc()

CanvasRenderingContext2D.arc() 是 Canvas 2D API 绘制圆弧路径的方法。 圆弧路径的圆心在 (x, y) 位置，半径为 r ，根据anticlockwise （默认为顺时针）指定的方向从 startAngle 开始绘制，到 endAngle 结束。

语法

void ctx.arc(x, y, radius, startAngle, endAngle, anticlockwise);

Parameters

x
圆弧中心（圆心）的 x 轴坐标。
y
圆弧中心（圆心）的 y 轴坐标。
radius
圆弧的半径。
startAngle
圆弧的起始点， x轴方向开始计算，单位以弧度表示。
endAngle
圆弧的终点， 单位以弧度表示。
anticlockwise 可选
可选的Boolean值 ，如果为 true，逆时针绘制圆弧，反之，顺时针绘制。 

示例

使用 arc 方法

这是一段绘制圆的简单的代码片段。

HTML

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

JavaScript

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

ctx.beginPath();
ctx.arc(75, 75, 50, 0, 2 * Math.PI);
ctx.stroke();

修改下面的代码并在线查看 canvas 的变化：

不同的形状演示

在此例中，使用 arc() 尽可能地绘制不同的形状。

var canvas = document.getElementById('canvas');
var ctx = canvas.getContext('2d');

// Draw shapes
for (i=0;i<4;i++){
  for(j=0;j<3;j++){
    ctx.beginPath();
    var x          = 25+j*50;               // x coordinate
    var y          = 25+i*50;               // y coordinate
    var radius     = 20;                    // Arc radius
    var startAngle = 0;                     // Starting point on circle
    var endAngle   = Math.PI+(Math.PI*j)/2; // End point on circle
    var clockwise  = i%2==0 ? false : true; // clockwise or anticlockwise

    ctx.arc(x,y,radius,startAngle,endAngle, clockwise);

    if (i>1){
      ctx.fill();
    } else {
      ctx.stroke();
    }
  }
}

ScreenshotLive sample

规范描述

Specification Status Comment
HTML Living Standard
CanvasRenderingContext2D.arc		 Living Standard  

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Gecko-specific 注解

从 Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)开始：

  • anticlockwise 参数是可选的，
  • 描述了 radius 为负数会抛出 IndexSizeError 错误（“索引或长度为负数，或者超过允许的数值”）。

参见