CanvasRenderingContext2D .rect() method of the Canvas 2D API adds a rectangle to the current path.

Like other methods that modify the current path, this method does not directly render anything.  To draw the rectangle onto a canvas, you can use the fill() or stroke() 方法。

注意: To both create and render a rectangle in one step, use the fillRect() or strokeRect() 方法。

句法

void ctx.rect(x, y, width, height);
					

rect() method creates a rectangular path whose starting point is at (x, y) and whose size is specified by width and height .

参数

x

The x-axis coordinate of the rectangle's starting point.

y

The y-axis coordinate of the rectangle's starting point.

width

The rectangle's width. Positive values are to the right, and negative to the left.

height

The rectangle's height. Positive values are down, and negative are up.

范例

Drawing a rectangle

This example creates a rectangular path using the rect() method. The path is then rendered using the fill() 方法。

HTML

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

JavaScript

The rectangle's corner is located at (10, 20). It has a width of 150 and a height of 100.

const canvas = document.getElementById('canvas');
const ctx = canvas.getContext('2d');
ctx.rect(10, 20, 150, 100);
ctx.fill();
					

结果

规范

规范 状态 注释
HTML 实时标准
The definition of 'CanvasRenderingContext2D.rect' in that specification.
实时标准

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据
桌面 移动
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
rect Chrome 1 Edge 12 Firefox 1.5 IE 9 Opera 11.6 Safari 2 WebView Android 1 Chrome Android 18 Firefox Android 4 Opera Android 12 Safari iOS 1 Samsung Internet Android 1.0

图例

完整支持

完整支持

另请参阅

元数据

  • 最后修改: